[30388f42] Infrastructure Hardening: Repaired CE/Connector DB schema, fixed frontend styling build, implemented robust echo shield in worker v2.1.1, and integrated Lead Engine into gateway.

lead-engine/TRADING_TWINS_SETUP.md

@@ -0,0 +1,76 @@
+# Trading Twins Autopilot - Setup & Go-Live Checkliste
+
+Dieses Dokument beschreibt die Schritte zur finalen Inbetriebnahme des vollautomatischen Trading Twins E-Mail-Versands.
+
+---
+
+## 1. IT-Voraussetzungen (Warten auf IT)
+
+Sobald die IT die Anfrage bearbeitet hat, benötigen wir folgende Informationen:
+
+*   **Teams Webhook URL:**
+    *   *Beispiel:* `https://outlook.office.com/webhook/xxxxx@yyyyy/IncomingWebhook/zzzzz`
+    *   *Verwendung:* Zum Senden der "Approve/Deny"-Karte an Elizabeta.
+
+*   **Azure App Registration (Graph API):**
+    *   **Application (Client) ID:** (GUID)
+    *   **Directory (Tenant) ID:** (GUID)
+    *   **Client Secret:** (Geheimer String)
+    *   **Berechtigungen:** `Mail.Send` (App) und `Calendars.Read` (Delegated/App) für `e.melcer@robo-planet.de`.
+
+---
+
+## 2. Konfiguration (.env)
+
+Füge diese Werte in die zentrale `.env`-Datei des Projekts ein:
+
+```env
+# Trading Twins Autopilot
+TEAMS_WEBHOOK_URL="<HIER_URL_EINFÜGEN>"
+AZURE_CLIENT_ID="<HIER_CLIENT_ID>"
+AZURE_CLIENT_SECRET="<HIER_SECRET>"
+AZURE_TENANT_ID="<HIER_TENANT_ID>"
+
+# API Erreichbarkeit (Damit die Buttons in Teams funktionieren)
+API_BASE_URL="https://floke-ai.duckdns.org/api/tt" 
+# (Hinweis: Nginx-Proxy muss Port 8004 nach außen leiten oder intern erreichbar sein)
+```
+
+---
+
+## 3. Assets prüfen
+
+Stelle sicher, dass diese Dateien im Ordner `/app/lead-engine/trading_twins/` vorhanden sind:
+
+1.  **Banner-Bild:** `RoboPlanetBannerWebinarEinladung.png`
+    *   *Check:* `ls -l /app/lead-engine/trading_twins/RoboPlanetBannerWebinarEinladung.png`
+    
+2.  **HTML-Signatur:** `signature.html`
+    *   *Inhalt:* Prüfe, ob die Links und Telefonnummern korrekt sind.
+    *   *Platzhalter:* Achte darauf, dass `cid:banner_image` im `<img>`-Tag steht, damit das Bild inline angezeigt wird.
+
+---
+
+## 4. Test-Modus deaktivieren
+
+Aktuell läuft das System im "Mock-Modus" für den Kalender (simuliert freie Termine).
+Sobald der echte Zugriff besteht:
+
+1.  Öffne `/app/lead-engine/trading_twins/manager.py`.
+2.  Ersetze `self._mock_calendar_availability()` durch den echten Graph-API-Aufruf (Code muss noch finalisiert werden, sobald `Calendars.Read` aktiv ist).
+
+---
+
+## 5. Logs überwachen
+
+Nach dem Start (`docker-compose restart lead-engine`) kannst du den Prozess live verfolgen:
+
+```bash
+docker logs -f lead-engine | grep "TradingTwins"
+```
+
+*   **Erwarteter Output:**
+    *   `[ACTION] Triggering Trading Twins Orchestrator...`
+    *   `Job erstellt: ...`
+    *   `Timer abgelaufen...`
+    *   `🚀 E-MAIL WURDE VERSENDET...`