3.5 KiB
3.5 KiB
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-domainpdf-umbenenner-applicationpdf-umbenenner-adapter-in-clipdf-umbenenner-adapter-in-gui← NEUpdf-umbenenner-adapter-outpdf-umbenenner-bootstrap
M9-Zielumfang
- Neues Modul
pdf-umbenenner-adapter-in-guials Inbound-Adapter - GUI als neuer Standardstart
--headlessals 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
- Ist die hexagonale Architektur in allen Modulen konsequent eingehalten?
- Sind Domain und Application nachweislich frei von JavaFX-Typen?
- Ist die GUI sauber als Inbound-Adapter umgesetzt und nicht in Bootstrap vermischt?
- Sind die Abhängigkeitsrichtungen korrekt (Adapter → Application → Domain)?
Betriebsmodell
- Ist GUI als Standardstart korrekt umgesetzt?
- Bleibt
--headlessvollständig abwärtskompatibel? - Funktioniert
--config <pfad>in beiden Startarten korrekt? - Ist die unterschiedliche Fehlersemantik für GUI und headless bei nicht existenter Konfigurationsdatei korrekt umgesetzt?
Packaging
- Entsteht genau ein gemeinsames ausführbares JAR?
- Ist JavaFX im JAR integriert?
- Kann der headless Pfad das JAR ohne JavaFX-Application-Initialisierung durchlaufen?
Qualität
- Ist der JavaDoc-Standard für neue/geänderte Klassen und Methoden eingehalten?
- Sind die Tests vollständig und sinnvoll (GUI-Smoke unter Monocle, Negativtests, Regressionstests)?
- Wurde kein Vorgriff auf M10+ gemacht?
Gesamtbewertung
- Ist M9 als vollständiger, übergabefähiger Meilensteinstand freigabefähig?
Falls NICHT BESTANDEN oder UNKLAR: Bitte konkrete Nachbesserungspunkte benennen.