Brancheneinstufung2/lead-engine/TRADING_TWINS_SETUP.md

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:

# 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:

docker logs -f lead-engine | grep "TradingTwins"

• Erwarteter Output:
  • [ACTION] Triggering Trading Twins Orchestrator...
  • Job erstellt: ...
  • Timer abgelaufen...
  • 🚀 E-MAIL WURDE VERSENDET...