# ASV-Format-Validator

Lokale CLI-Anwendung zur Validierung von ASV-Abrechnungsdateien (ambulante spezialfachärztliche Versorgung gemäß § 116b Abs. 6 Satz 12 SGB V) gegen die **Technische Anlage ASV 1.09** (Stand 09.10.2025, anzuwenden ab Leistungserbringungsquartal 2/2026).

## Status

🚧 **In Entwicklung — Version 1 (V1)**

Die Implementierung folgt einem Meilenstein-Modell (siehe [`docs/specs/meilensteine.md`](docs/specs/meilensteine.md)). Aktuell in Arbeit: **Meilenstein 1 — Projektfundament**.

## Was macht das Tool?

Der Validator prüft lokal vorliegende ASV-Artefakte gegen die Technische Anlage ASV 1.09. Unterstützte Artefakte in V1:

- ASV-Nutzdatendateien mit `ASVREC` (Abrechnung)
- ASV-Fehlernachrichten mit `ASVFEH`
- Storno-Nachrichten als Sonderausprägung von `ASVREC`
- Auftragsdateien (`.AUF`, KKS-Auftragssatz)
- verschlüsselte bzw. transportnahe PKCS#7-Artefakte

Pro Lauf wird **genau eine Datei** validiert. Ausgabe: ein deutscher Textbericht (Konsole + Berichtdatei) und eine technische Log-Datei.

## Nutzung (geplant, noch nicht vollständig implementiert)

```bash
java -jar asv-format-validator.jar <pfad-zur-datei>
```

Exit-Codes:

| Code | Bedeutung |
|---|---|
| `0` | gültig, keine Fehler-Befunde |
| `1` | ungültig, mindestens ein Spec-Fehler |
| `2` | Bedienfehler (z.B. Datei nicht lesbar, falsches Argument) |

## Technisches Zielbild

- **Java 21**, Maven
- **Hexagonale Architektur**, manuelle Constructor Injection, kein DI-Framework
- **SLF4J + Log4j2** für Logging
- **ISO 8859-15** als Eingabe-Encoding, UTF-8 für Ausgabeartefakte
- **Nicht** Server, nicht Container, nicht Batch — bewusst schlank

Details siehe [`docs/specs/technik-und-architektur.md`](docs/specs/technik-und-architektur.md).

## Dokumentation

Alle normativen Dokumente liegen unter `docs/specs/`:

- [`fachliche-anforderungen.md`](docs/specs/fachliche-anforderungen.md) — verbindlicher fachlicher Soll-Rahmen, feldgenauer Regelkatalog
- [`technik-und-architektur.md`](docs/specs/technik-und-architektur.md) — verbindlicher technischer Soll-Rahmen
- [`meilensteine.md`](docs/specs/meilensteine.md) — Umsetzungsplan in 9 Meilensteinen

Arbeitspakete und Berichte pro Meilenstein unter `docs/arbeitspakete/m<n>/`.

## Preview-Code

Das Repository enthält eine frühere, noch unvollständige Implementierung aus einer Sondierungsphase (u.a. Parser und Validator-Gerüst). Diese Teile werden in den Meilensteinen M1 bis M2 evolutionär in die neue hexagonale Struktur überführt bzw. als Vorbau für spätere Meilensteine eingefroren. Details dazu in [`docs/arbeitspakete/m1/AP09-altlogik-einfrieren.md`](docs/arbeitspakete/m1/AP09-altlogik-einfrieren.md).

## Build

```bash
mvn clean verify
```

## Nicht-Ziele von Version 1

Siehe `technik-und-architektur.md`, Abschnitt „Nicht-Ziele". Insbesondere: keine GUI, keine Batch-Verarbeitung, keine Referenzdatenbestände, keine Stufe-4-Prüfungen, kein Mehrversionssupport.