Überarbeitung und Freigabe aller V2.0 Planungsdokumente

docs/workpackages/M9 - Arbeitspakete.md

@@ -110,7 +110,32 @@ Daraus folgt:
 - Diese Shell dient nur dem Nachweis des GUI-Startpfads.
 - Ein echter Konfigurationseditor ist ausdrücklich erst Gegenstand von **M10**.
 
-### 9. GUI-Teststrategie
+### 7. GUI-Threadingmodell
+
+Ab M9 gilt verbindlich für alle V2.0-Meilensteine:
+
+- Jede potenziell blockierende Operation der GUI – insbesondere providerseitiger Modellabruf, providerseitige technische Tests, Pfad- und Dateisystemprüfungen, SQLite-Prüfungen sowie das Lesen und Schreiben der `.properties`-Datei – läuft auf einem **Hintergrund-Worker-Thread**.
+- **UI-Updates erfolgen ausschließlich über den JavaFX Application Thread** (`Platform.runLater`).
+- Die GUI darf während laufender Hintergrund-Operationen **nicht einfrieren**.
+- Diese Regel ist Referenz für alle threadingbezogenen Formulierungen in M9–M13; Wiederholungen sind in einzelnen Meilensteinen nicht erforderlich.
+
+### 8. Exit-Codes
+
+Ab M9 gilt verbindlich für alle V2.0-Meilensteine:
+
+- **Exit-Code `0`**: normale erfolgreiche Beendigung eines headless Laufs sowie für das reguläre Beenden der GUI.
+- **Exit-Code `1`**: harte Start-, Bootstrap-, Verdrahtungs-, Konfigurations- oder Initialisierungsfehler, einschließlich ungültiger CLI-Verwendung, nicht existenter `--config`-Datei im headless Start und GUI-Startfehlern vor erfolgreicher Anzeige der Oberfläche.
+- Dokumentbezogene Verarbeitungsfehler im headless Lauf ändern dieses Exit-Code-Modell nicht; sie bleiben Teil des fachlichen Laufresultats wie bereits in V1.1.
+
+### 9. GUI-Logging
+
+Ab M9 gilt verbindlich:
+
+- Der GUI-Adapter nutzt denselben Log4j2-Stack wie der headless Pfad.
+- Logformat und Log-Verzeichnis bleiben gegenüber dem headless Betrieb unverändert.
+- Mindesteintrag für GUI-nahe Ereignisse sind: Start- und Beendigungsereignisse der GUI, Modellabruf-Versuche (Provider, Erfolg/Misserfolg, **ohne API-Key**), Dateischreibvorgänge inkl. Zielpfad, Ergebnisse der Aktionen `Validieren` und `Technische Tests ausführen`, sowie alle schreibenden Korrekturen.
+
+### 10. GUI-Teststrategie
 
 Ab M9 gilt verbindlich für alle V2.0-Meilensteine:
 
@@ -119,7 +144,7 @@ Ab M9 gilt verbindlich für alle V2.0-Meilensteine:
 - Es wird **kein TestFX** und **kein weiteres GUI-Testframework** über Monocle hinaus eingeführt.
 - Diese Teststrategie gilt als Referenz für alle testbezogenen Formulierungen in den Arbeitspaketen von M9 bis M13.
 
-### 10. JavaDoc-Standard für V2.0
+### 11. JavaDoc-Standard für V2.0
 
 Ab M9 gilt verbindlich für alle V2.0-Meilensteine: