# 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...`