[2ff88f42] Full End-to-End integration: Webhooks, Auto-Enrichment, Notion-Sync, UI updates and new Connector Architecture

company-explorer/MIGRATION_PLAN.md

@@ -49,6 +49,14 @@ Um externen Diensten (wie der `lead-engine`) eine einfache und robuste Anbindung
 | **`company_explorer_connector.py`** | **NEU:** Ein zentrales Python-Skript, das als "offizieller" Client-Wrapper für die API des Company Explorers dient. Es kapselt die Komplexität der asynchronen Enrichment-Prozesse. |
 | **`handle_company_workflow()`** | Die Kernfunktion des Connectors. Sie implementiert den vollständigen "Find-or-Create-and-Enrich"-Workflow: <br> 1. **Prüfen:** Stellt fest, ob ein Unternehmen bereits existiert. <br> 2. **Erstellen:** Legt das Unternehmen an, falls es neu ist. <br> 3. **Anstoßen:** Startet den asynchronen `discover`-Prozess. <br> 4. **Warten (Polling):** Überwacht den Status des Unternehmens, bis eine Website gefunden wurde. <br> 5. **Analysieren:** Startet den asynchronen `analyze`-Prozess. <br> **Vorteil:** Bietet dem aufrufenden Dienst eine einfache, quasi-synchrone Schnittstelle und stellt sicher, dass die Prozessschritte in der korrekten Reihenfolge ausgeführt werden. |
 
+### D. Provisioning API (Internal)
+
+Für die nahtlose Integration mit dem SuperOffice Connector wurde ein dedizierter Endpunkt geschaffen:
+
+| Endpunkt | Methode | Zweck |
+| :--- | :--- | :--- |
+| `/api/provision/superoffice-contact` | POST | Liefert "Enrichment-Pakete" (Texte, Status) für einen gegebenen CRM-Kontakt. Greift auf `MarketingMatrix` zu. |
+
 ## 3. Umgang mit Shared Code (`helpers.py` & Co.)
 
 Wir kapseln das neue Projekt vollständig ab ("Fork & Clean").
@@ -105,6 +113,15 @@ Wir kapseln das neue Projekt vollständig ab ("Fork & Clean").
 *   `pattern` (String - Regex für Jobtitles)
 *   `role` (String - Zielrolle)
 
+### Tabelle `marketing_matrix` (NEU v2.1)
+*   **Zweck:** Speichert statische, genehmigte Marketing-Texte (Notion Sync).
+*   `id` (PK)
+*   `industry_id` (FK -> industries.id)
+*   `role_id` (FK -> job_role_mappings.id)
+*   `subject` (Text)
+*   `intro` (Text)
+*   `social_proof` (Text)
+
 ## 7. Historie & Fixes (Jan 2026)
 
     *   **[CRITICAL] v0.7.4: Service Restoration & Logic Fix (Jan 24, 2026)**