mocode-software/meldestelle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
7ff48ed3d7
meldestelle/docs/99_Journal/2026-03-30_Session_Log_ZNS_Documentation.md
Stefan Mogeritsch c576bbd6af feat(docs): add ZNS interface documentation and session log for OEPS compliance 
- Created detailed session log for ZNS interface documentation (`2026-03-30_Session_Log_ZNS_Documentation.md`), outlining analysis, technical specifications, and next steps.
- Added comprehensive ZNS Schnittstelle documentation (`ZNS_SCHNITTSTELLE.md`) to the `masterdata` service.
- Linked new documentation in `masterdata/README.md` to ensure alignment with ÖTO standards.

Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-03-30 12:13:28 +02:00

2.0 KiB
Raw Blame History

type status owner last_update
Journal COMPLETED Curator 2026-03-30

Session Log: Dokumentation der ZNS-Schnittstelle (OEPS)

📜 [ÖTO/FEI Rulebook Expert] | 30. März 2026

Kontext

Basierend auf dem OEPS-Pflichtenheft v2.4 und der bereitgestellten ZNS.zip wurden die technischen Spezifikationen für den Datenaustausch zwischen Verband und Meldestelle dokumentiert. Diese Daten bilden die Grundlage für den zns-import Service und die Validierung im masterdata Kontext.

Erledigte Aufgaben

1. ✅ Analyse der ZNS-Struktur

  • Auswertung der ZNS.zip Inhalte (LIZENZ01.dat, PFERDE01.dat, RICHT01.dat, VEREIN01.dat).
  • Abgleich mit dem Pflichtenheft 2021 V2.4 bezüglich Feldlängen, Positionen und Formaten (ASCII CP 850).

2. ✅ Technische Dokumentation

  • Erstellung der Datei backend/services/masterdata/docs/ZNS_SCHNITTSTELLE.md.
  • Detaillierte Auflistung der Datensätze für Richter, Lizenzen, Pferde und Vereine.
  • Dokumentation der Nennungs- (n2-*.dat) und Ergebnisformate (*.erg).
  • Definition kritischer Felder wie Satznummern, Bundesland-Codes und Ergebnis-Status (A, D, T).

3. ✅ Konsolidierung

  • Verknüpfung der neuen technischen Doku in der masterdata/README.md.
  • Sicherstellung der Konsistenz zwischen fachlichen ÖTO-Regeln und technischer ZNS-Umsetzung.

Technische Details

  • Formate: Fixe Satzlängen, ASCII Codepage 850.
  • Kritische Pfade: Die 10-stellige Satznummer für Pferde (Einführung v2.3) ist zwingend für die Ergebnisrückmeldung.
  • Validierung: Bundesland-Codes (01-09) und Altersklassen-Kürzel (JG, JR, 25) müssen im Frontend und Backend synchron sein.

Nächste Schritte

  • Anbindung des zns-import Services an die neu dokumentierten Strukturen.
  • Implementierung der Parser-Logik für die *.dat Dateien unter Berücksichtigung der fixen Feldpositionen.

Referenzen

  • backend/services/masterdata/docs/ZNS_SCHNITTSTELLE.md
  • docs/03_Domain/02_Reference/Legacy_Specs/OETO-2026_Meldestelle_Pflichtenheft_V2.4_2021-07-28.md