Rückmeldung, Reporting, Export

Rückmeldung an die Schulverwaltung

Wird ein Zeugnis freigegeben, das die Schulverwaltung kennen muss – ein Jahreszeugnis mit Versetzungsbeschluss, ein Abschlusszeugnis der Berufsschule oder ein Abiturzeugnis –, schreibt die Datenbank in derselben Transaktion eine Nachricht in eine Outbox. Es geht also keine Freigabe ohne Rückmeldung verloren und keine Rückmeldung ohne Freigabe hinaus.

• Format score-rueckmeldung Version 1: Einrichtung, Person mit ihren externen Kennungen aus dem Import, Klasse, Zeitraum, Zeugnis mit Fassung und gegebenenfalls ersetzter Fassung, Inhalt.
• Zustellung per HTTP POST an eine konfigurierte Adresse, durch den Worker. Bei Fehlern folgt der nächste Versuch nach wachsendem Abstand (höchstens eine Stunde), nach acht Versuchen gilt die Nachricht als aufgegeben und lässt sich von Hand erneut senden.
• Mindestens einmal: Die Gegenstelle erkennt Doppel an Zeugnis und Fassung.
• Jeder Ausgang einer Zustellung ist ein Audit-Ereignis.

Für die Entwicklung gibt es eine Attrappe der Gegenstelle (score-api mock-omnis), die quittiert, Doppel erkennt und auf Wunsch einen Teil der Zustellungen scheitern lässt.

Notenaustausch zwischen Installationen

Lernt ein Schüler an einer Schule, deren Stammschule auf einer anderen score-Installation liegt (z. B. Privatschule mit eigenem Server, Partnerschule im Landesbetrieb), gibt die unterrichtende Schule die festgesetzten Halbjahresnoten zum Notenschluss als Datei heraus.

• Format score-notenaustausch Version 1: inhalt mit Quelle (Kennung, Name, Ort), Ziel (Kennung der Stammschule), Zeitraum, Erstellungszeit und je Note der Person (Name, Geburtsdatum, Kennungen aus dem Quellsystem), Fach, Kurs, Note und Wortlaut; dazu pruefsumme, der SHA-256 der kompakten JSON-Form von inhalt.
• Übernahme an der Stammschule durch die Schulleitung: Prüfsumme und Ziel werden geprüft, Personen nur über ihre Kennungen zugeordnet. Übernommene Noten sind schreibgeschützt; eine abweichende Note für dasselbe Fach und denselben Zeitraum wird nicht überschrieben, sondern gemeldet.
• Die Prüfsumme erkennt Veränderung und Beschädigung auf dem Weg; sie ist keine Signatur.

Reporting

Schulleitung und Schuladmin laden eine Auswertung ihrer Einrichtung im Format score-reporting Version 1: Halbjahresnoten je Jahrgang und Fach (Anzahl, Mittelwert, Verteilung) und Zeugnisse je Jahrgang, Art und Status mit Versetzungsbeschlüssen.

Die Auswertung enthält keinen Personenbezug. Gruppen unter einer Mindestgröße (Standard 5) werden ganz unterdrückt, kleinere Zellen einzeln. Jeder Abruf steht im Audit-Log.

Exit-Export

Für einen Wechsel des Systems oder die Abgabe an ein Archiv exportiert score den vollständigen Stand einer Einrichtung als ZIP-Datei:

Inhalt	Format
daten/<tabelle>.json	alle Daten der Einrichtung
schema/<tabelle>.schema.json	JSON-Schema je Tabelle, aus dem Datenbankkatalog
zeugnisse/<id>.pdf	die Zeugnis-PDFs
protokoll.jsonl	das Audit-Log
manifest.json	SHA-256 je Datei und eine Gesamtsumme

score-api exit export -einrichtung K -o datei.zip
score-api exit pruefen datei.zip

Die Prüfung meldet geänderte, fehlende und zusätzliche Dateien. Der Export selbst ist ein Audit-Ereignis.

Archivangebot

Bevor score Daten nach Ablauf der Aufbewahrungsfrist löscht, bietet es sie dem Archiv an – im selben Format wie der Exit-Export, nur mit den fälligen Datensätzen und prüfbar mit demselben Befehl.

score-api aufbewahrung pruefen -einrichtung K [-stichtag D]
score-api aufbewahrung anbieten -einrichtung K [-stichtag D] -o angebot.zip
score-api aufbewahrung loeschen -aussonderung ID -archiv uebernommen|abgelehnt