Files
Brancheneinstufung2/lead-engine/TRADING_TWINS_SETUP.md

77 lines
2.5 KiB
Markdown

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