1
0

Arbeitspakete + Review für M9 angelegt

This commit is contained in:
2026-04-13 09:05:56 +02:00
parent be6e3d1971
commit f74e3d6d73
15 changed files with 435 additions and 0 deletions

View File

@@ -0,0 +1,87 @@
# Meilenstein-Review M9 GUI-Grundgerüst, neues Betriebsmodell und Packaging-Basis
## Kontext
Dieses Dokument enthält den vollständigen Umsetzungsstand von Meilenstein M9 des Projekts **PDF-Umbenenner V2.0** zur unabhängigen Bewertung.
Das Projekt ist ein lokal gestarteter PDF-Umbenenner mit KI-Unterstützung. M9 erweitert die bisher reine Batch-Anwendung um das technische Grundgerüst einer JavaFX-Desktop-GUI, ohne den bestehenden headless Batch-Betrieb zu verlieren.
---
## Architekturprinzipien (verbindlich)
- Strikte hexagonale Architektur / Ports and Adapters
- Abhängigkeiten zeigen immer nach innen
- Domain und Application sind frei von JavaFX-Typen
- GUI ist ein eigenständiger Inbound-Adapter (`pdf-umbenenner-adapter-in-gui`)
- Bootstrap ist verantwortlich für Startmoduswahl, Konfigurationsauflösung und Objektgraph
- GUI-Code darf den headless Pfad nicht unnötig früh initialisieren
- Jede potenziell blockierende GUI-Operation läuft auf einem Hintergrund-Worker-Thread; UI-Updates ausschließlich via Platform.runLater
## Modulstruktur (ab M9)
- `pdf-umbenenner-domain`
- `pdf-umbenenner-application`
- `pdf-umbenenner-adapter-in-cli`
- `pdf-umbenenner-adapter-in-gui` ← NEU
- `pdf-umbenenner-adapter-out`
- `pdf-umbenenner-bootstrap`
## M9-Zielumfang
- Neues Modul `pdf-umbenenner-adapter-in-gui` als Inbound-Adapter
- GUI als neuer Standardstart
- `--headless` als erhaltener Batch-/Scheduler-Pfad
- Neue CLI-Option `--config <pfad>` für beide Startarten
- Kontrollierte, unterschiedliche Fehlersemantik für GUI und headless bei nicht existenter Konfigurationsdatei
- Minimale JavaFX-GUI-Shell als technischer Nachweis des GUI-Starts
- Ein gemeinsames ausführbares JAR mit integrierter JavaFX-Basis
- Headless ohne unnötige GUI-Initialisierung
- Tests für Startverhalten, Fehlerpfade und Packaging
## Explizit NICHT Teil von M9
- GUI-Konfigurationseditor (M10)
- Provider-ComboBox, Modellabruf (M11)
- Technische Tests und Korrekturhilfen (M12)
- EXE, Installer
- Änderungen an der fachlichen Kernverarbeitung
---
## Reports der Arbeitspakete AP-001 bis AP-007
[HIER DIE REPORTS AUS DER M9-FORTSCHRITT.LOG EINFÜGEN]
---
## Bitte bewerte folgende Punkte
Bewerte jeden Punkt mit: **BESTANDEN** / **NICHT BESTANDEN** / **UNKLAR** + Begründung
### Architektur
1. Ist die hexagonale Architektur in allen Modulen konsequent eingehalten?
2. Sind Domain und Application nachweislich frei von JavaFX-Typen?
3. Ist die GUI sauber als Inbound-Adapter umgesetzt und nicht in Bootstrap vermischt?
4. Sind die Abhängigkeitsrichtungen korrekt (Adapter → Application → Domain)?
### Betriebsmodell
5. Ist GUI als Standardstart korrekt umgesetzt?
6. Bleibt `--headless` vollständig abwärtskompatibel?
7. Funktioniert `--config <pfad>` in beiden Startarten korrekt?
8. Ist die unterschiedliche Fehlersemantik für GUI und headless bei nicht existenter Konfigurationsdatei korrekt umgesetzt?
### Packaging
9. Entsteht genau ein gemeinsames ausführbares JAR?
10. Ist JavaFX im JAR integriert?
11. Kann der headless Pfad das JAR ohne JavaFX-Application-Initialisierung durchlaufen?
### Qualität
12. Ist der JavaDoc-Standard für neue/geänderte Klassen und Methoden eingehalten?
13. Sind die Tests vollständig und sinnvoll (GUI-Smoke unter Monocle, Negativtests, Regressionstests)?
14. Wurde kein Vorgriff auf M10+ gemacht?
### Gesamtbewertung
15. Ist M9 als vollständiger, übergabefähiger Meilensteinstand freigabefähig?
Falls NICHT BESTANDEN oder UNKLAR: Bitte konkrete Nachbesserungspunkte benennen.