meldestelle/docs/90_Reports/2026-04-09_Todos-ZNS-Importer.md

type	status	owner	created	source
Report	DRAFT	Backend Developer	2026-04-09	../temp/ToDos und Folgearbeiten.md

ZNS-Importer — ToDos & Folgearbeiten

Ziel des ZNS-Importers

• OEPS/ZNS-Daten entgegennehmen
• Validiert und idempotent in unsere Datenbank übernehmen
• Daten systemweit bereitstellen

Offene Punkte (bereinigt)

1. Datenbank-Initialisierung (Prio 1)
   • MasterdataDatabaseConfiguration.kt und ZnsImportDatabaseConfiguration.kt um FunktionaerQualifikationTable ergänzen.
2. Parser-Validierung (Prio 2)
   • Sicherstellen, dass FunktionaerExposedRepository Qualifikationen in funktionaer_qualifikation synchron hält (Delete+Insert pro Save ist OK, langfristig Abgleich gegen Masterdaten).
3. Qualifikations-Masterdaten (Prio 2)
   • Gemeinsam mit 📜 Rulebook Expert: Richter-/Parcoursbauer-Qualifikationen ÖTO-konform als Stammdaten definieren.
   • Ziel: keine Voll-Löschung bei jedem Import; Matching gegen Stammdatensätze (1:n Verknüpfung pro Funktionär).
4. Import-Strategie (Prio 2)
   • RICHT01.dat zunächst priorisieren (Funktionäre). Vorgehen und Edge-Cases dokumentieren.
5. Dokumentation & Abschluss (Prio 3)
   • Import-Endpunkte und Status-Abfragen dokumentieren.

Beispiel-Endpunkte (Status-Abfrage)

curl http://localhost:8081/api/v1/import/zns/{jobId}/status

Beispiel jobId aus Logs:

f028e1bb-fdaa-46c7-bbef-36bcdc4bb354
b589e1ed-7ed5-4b6a-b884-d1a5d8d6e6e9
03ad288b-ef2c-4510-ad04-9e8154a62ed1

Nächste Schritte

• DB-Konfig fixen (Prio 1)
• RICHT01.dat End-to-End-Import testen
• Doku aktualisieren (Admin/Maintenance Bereich im Frontend vorbereitet)