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>
This commit is contained in:
@@ -0,0 +1,54 @@
|
||||
---
|
||||
type: Journal
|
||||
status: COMPLETED
|
||||
owner: Curator
|
||||
last_update: 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`
|
||||
Reference in New Issue
Block a user