[31388f42] Update documentation: Append external lead ingestion to MIGRATION_PLAN and create Lead Engine README

MIGRATION_PLAN.md

@@ -410,19 +410,29 @@ Der Company Explorer unterstützt nun den Parameter `campaign_tag`. Der Connecto
 
 ---
 
+## 19. External Lead Ingestion & Contact API (v3.5 - March 2, 2026)
+
+**Kontext:** Automatisierte Verarbeitung von externen Lead-Quellen (Tradingtwins) direkt in den Company Explorer.
+
+### 19.1 API-Erweiterung: Externer Kontakt-Sync
+Um Kontakte von externen Tools (wie der Lead-Engine) ohne SuperOffice-Kontext zu übernehmen, wurde die API erweitert.
+
+*   **Neuer Endpunkt:** `POST /api/contacts`
+*   **Funktionalität:** 
+    *   Anlage von Personen-Stammdaten (Vorname, Nachname, E-Mail).
+    *   **Automatisches Role-Mapping:** Der Endpunkt integriert den `RoleMappingService`. Eingehende Job-Titel (z.B. "CFO") werden automatisch gegen die interne Muster-Datenbank geprüft und der passenden Persona (z.B. "Wirtschaftlicher Entscheider") zugeordnet.
+    *   **De-Duplizierung:** Existiert eine E-Mail bereits für ein Unternehmen, wird der Datensatz aktualisiert statt neu angelegt.
+
+### 19.2 Standardisierung der Datenfelder
+Zur Verbesserung der asynchronen Zusammenarbeit zwischen Lead-Engine und CE wurden die Feldnamen in der API-Antwort vereinheitlicht:
+*   **Branche:** `industry_ai` (Primärfeld für die KI-Klassifizierung).
+*   **Analyse:** `research_dossier` (Das vollständige KI-generierte Firmendossier).
+
+### 19.3 Synchronisations-Workflow (Connector)
+Der `company_explorer_connector.py` unterstützt nun den erweiterten Workflow:
+1. `check_company_existence` (Suche via Name)
+2. `create_company` (Anlage falls neu)
+3. `create_contact` (Integration der Person inkl. Role-Mapping)
+4. `trigger_discovery` / `trigger_analysis` (Asynchroner Start der Intelligence-Phase)
+
 ---
-
-## 18. Offene Arbeitspakete (Stand: 27.02.2026)
-
-### Prio A: Operative Automatisierung
-*   **Webhook-Aktivierung:** Registrierung des Live-Webhooks für `online3`, sobald Admin-Rechte für den API-User vorliegen (`register_webhook.py`).
-*   **Full Matrix Generation:** Ausführung der KI-Generierung für alle 25 Verticals (englische IDs), sobald die "Pains" in Notion finalisiert wurden.
-*   **Campaign-Validation:** Erstellung von Test-Szenarien für mindestens 3 verschiedene Kampagnen-Tags zur Verifizierung der Weichenstellung.
-
-### Prio B: Marketing-Execution
-*   **Sending Logic:** Implementierung der Logik für den tatsächlichen E-Mail-Versand (oder Export zu einem E-Mail-Provider) basierend auf den befüllten UDFs.
-*   **Unsubscribe-Frontend:** Visuelle Gestaltung der HTML-Bestätigungsseite für den Unsubscribe-Link.
-
-### Prio C: Daten-Optimierung
-*   **Google Maps API:** Einbindung zur Validierung von Firmenadressen bei Diskrepanzen zwischen CRM und Scraper.
-*   **Deduplication 2.0:** Verfeinerung des Matchings bei Firmen mit mehreren Standorten (Filial-Logik).