feat(gtm): improve phase 5 report rendering & update documentation to v2.3

gtm_architect_documentation.md

@@ -1,4 +1,4 @@
-# Dokumentation: GTM Architect Engine (v2.2)
+# Dokumentation: GTM Architect Engine (v2.3)
 
 ## 1. Projektübersicht
 
@@ -25,8 +25,9 @@ graph LR
 
 1.  **Frontend (`/gtm-architect`):**
     *   Framework: **React** (Vite + TypeScript).
-    *   **Feature:** Upload von Referenzbildern ("Image-to-Image").
-    *   **Fix:** Robuste Darstellung von Listen-Objekten (Rollen).
+    *   **Feature (NEU):** **Session History** (Sitzungsverlauf). Ermöglicht das Laden alter Projekte direkt aus der Datenbank.
+    *   **Feature (NEU):** **Markdown Upload**. Ermöglicht das Importieren externer Report-Dateien (`.md`).
+    *   **UI:** Verbesserte Tabelle für Strategie-Matrix.
 
 2.  **Backend Bridge (`server.cjs`):**
     *   Runtime: **Node.js** (Express).
@@ -34,52 +35,43 @@ graph LR
 
 3.  **Logic Core (`gtm_architect_orchestrator.py`):**
     *   Runtime: **Python 3.11+**.
-    *   **Bibliothek:** Upgrade auf **`google-genai`** (v1.x SDK). Legacy-Support entfernt.
-    *   **Modelle (Automatische Wahl):**
-        *   **Text:** `gemini-2.0-flash` (High Performance, ersetzt 1.5).
-        *   **Bild (Hybrid):**
-            *   *Mit Referenzbild:* **`gemini-2.5-flash-image`**. Nutzt das Produktfoto als strikte Vorlage ("Image-to-Image").
-            *   *Ohne Referenzbild:* **`imagen-4.0-generate-001`**. Generiert generische Szenen ("Text-to-Image").
+    *   **Datenbank-Integration:** Vollständiger Support für CRUD-Operationen via `gtm_db_manager.py`.
+    *   **Automatisierung:** Automatische Projekterstellung beim ersten Start (Phase 1) basierend auf dem Produktnamen.
+    *   **Output-Sanitization:** Automatisches Entfernen von Markdown-Codefences (` ```markdown `), um korrektes Rendering im Frontend sicherzustellen.
 
 4.  **Persistenz (`gtm_projects.db`):**
-    *   Typ: **SQLite**.
+    *   Typ: **SQLite**. Speichert alle Phasen-Ergebnisse als JSON-Blobs.
 
 ## 3. Der 9-Phasen Prozess
 
 | Phase | Modus | Input | Output | Beschreibung |
 | :--- | :--- | :--- | :--- | :--- |
-| **1** | `phase1` | Rohtext / URL | Features, Constraints | Extrahiert technische Daten. |
+| **1** | `phase1` | Rohtext / URL | Features, Constraints | Extrahiert technische Daten & **erstellt DB-Projekt**. |
 | **2** | `phase2` | Phase 1 Result | ICPs, Data Proxies | Identifiziert ideale Kundenprofile. |
 | **3** | `phase3` | Phase 2 Result | Whales, Rollen | Identifiziert Zielkunden & Buying Center. |
 | **4** | `phase4` | Phase 1 & 3 | Strategy Matrix | Entwickelt "Angles" und Pain-Points. |
-| **5** | `phase5` | Alle Daten | Markdown Report | Erstellt den finalen Strategie-Report. |
+| **5** | `phase5` | Alle Daten | Markdown Report | **Strategie-Fixierung**. Konsolidierter Report. |
 | **6** | `phase6` | Phase 1, 3, 4 | Battlecards, Prompts | Generiert Einwandbehandlung & Bild-Prompts. |
 | **7** | `phase7` | Phase 2, 4 | Landing Page Copy | Erstellt Landingpage-Texte. |
 | **8** | `phase8` | Phase 1, 2 | Business Case | CFO-Argumentation, ROI-Logik. |
 | **9** | `phase9` | Phase 1, 4 | Feature-to-Value | Übersetzung technischer Features in Nutzen. |
-| **Extra** | `image` | Prompt (+Ref) | Base64 PNG | Generiert Konzeptbilder (Produkt-treu). |
 
-## 4. Deployment & Betrieb
+## 4. Sitzungs-Management (NEU)
 
-### Docker Integration
-Der Service läuft im Container `gtm-app`.
-*   **Build:** Frontend-Änderungen erfordern `docker-compose up -d --build gtm-app`.
-*   **Dependencies:** `Pillow` und `google-genai` sind installiert.
+Das System verwaltet nun persistente Sitzungen:
+*   **List:** Abruf aller gespeicherten Projekte mit Zeitstempel.
+*   **Load:** Vollständige Wiederherstellung des App-States (alle Phasen).
+*   **Delete:** Permanentes Entfernen aus der Datenbank.
 
-## 5. Logging & Debugging
+## 5. Deployment & Betrieb
 
-*   **Logs:** Werden in `/app/Log_from_docker/` geschrieben.
-*   **Diagnose:** `helpers.py` enthält eine Diagnose-Funktion, die bei Fehlern verfügbare Modelle loggt.
+*   **Wichtig:** Das Frontend wird im Build-Stage gebaut. Bei Änderungen an `App.tsx` muss der Container mit `docker-compose up -d --build gtm-app` neu gebaut werden.
+*   **Backend:** Änderungen an `gtm_architect_orchestrator.py` erfordern keinen Build, nur einen Restart (`docker restart gtm-app`).
 
 ## 6. Historie & Fixes (Jan 2026)
 
-*   **[FEATURE] Produkt-Identität:**
-    *   Prompt-Engineering in `helpers.py` wurde verschärft ("Place EXACTLY this product...").
-    *   Backend erkennt `referenceImagesBase64` vom Frontend.
-*   **[FIX] API-Kompatibilität:**
-    *   Migration auf `google-genai` SDK.
-    *   Fallback-Mechanismus für Imagen 4.0 vs. Imagen 3.0.
-    *   Workaround für `gemini-2.5` (kein JSON-Mode bei Bildern).
-*   **[FIX] Stabilität:**
-    *   Typ-Sicherheit im Frontend (Phase 3 Crash behoben).
-    *   Einrückungsfehler in `helpers.py` korrigiert.
+*   **[UPGRADE] v2.3:**
+    *   Einführung der Session History (Datenbank-basiert).
+    *   Implementierung von Markdown-Cleaning (Stripping von Code-Blocks).
+    *   Prompt-Optimierung für tabellarische Markdown-Ausgaben in Phase 5.
+    *   Markdown-File Import Feature.