[2ff88f42] Add End-to-End Workflow Diagram to Readme

readme.md

@@ -73,6 +73,59 @@ Dieses Projekt ist eine modulare "Lead Enrichment Factory", die darauf ausgelegt
 
 Die Architektur ist in mehrere, klar voneinander getrennte Funktionseinheiten gegliedert, die im Folgenden detailliert beschrieben werden.
 
+### 1.1 Der End-to-End Datenfluss (Lead-Fabrik)
+
+Diese Grafik visualisiert den gesamten Prozess von der Anlage eines Kontakts im CRM über die KI-Analyse bis zur fertigen Marketing-Automation.
+
+```mermaid
+graph TD
+    %% Nodes
+    User((Vertriebs-User))
+    SO_CRM[SuperOffice CRM]
+    Connector[Connector Service]
+    CE_Core[Company Explorer Core]
+    CE_AI[AI Analysis Engine]
+    CE_DB[(SQLite DB)]
+    MA_System[Marketing Automation]
+
+    %% Flow
+    User -- Erstellt Kontakt --> SO_CRM
+    SO_CRM -- Webhook (New Contact) --> Connector
+    Connector -- POST /provision --> CE_Core
+    
+    subgraph "Intelligence Phase (Asynchron)"
+        CE_Core -- 1. Scrape & Research --> CE_AI
+        CE_AI -- 2. Vertical & Metriken (Potential) --> CE_Core
+        CE_AI -- 3. Generiere Atomic Opener --> CE_Core
+    end
+    
+    subgraph "Matrix Logic (Matching)"
+        CE_Core -- 4. Rolle & Branche Identifizieren --> CE_DB
+        CE_DB -- 5. Hole Matrix-Texte (Subject/Intro) --> CE_Core
+        Note[Logik: Primary vs Secondary Product<br>z.B. Healthcare: Pflege -> Transport]
+    end
+    
+    CE_Core -- Angereichertes Profil + Texte --> Connector
+    Connector -- UPDATE Person (UDFs) --> SO_CRM
+    
+    SO_CRM -- Daten verfügbar --> MA_System
+    MA_System -- Ersetze Variablen im Template --> Email(Finale E-Mail)
+```
+
+**Prozess-Schritte:**
+1.  **Trigger:** Ein Vertriebsmitarbeiter legt eine Person oder Firma in SuperOffice an.
+2.  **Transport:** Der Connector empfängt den Webhook und beauftragt den Company Explorer (`/provision`).
+3.  **Intelligence:**
+    *   Die Website wird gescraped und analysiert.
+    *   Die KI bestimmt das **Vertical** (z.B. "Healthcare - Hospital") und berechnet das **Potenzial** (z.B. Bettenanzahl).
+    *   Ein individueller **Atomic Opener** wird generiert, der auf die spezifische Situation des Unternehmens eingeht.
+4.  **Matrix Match:**
+    *   Basierend auf der Job-Rolle (z.B. "Pflegedienstleitung") wird die **Persona** ("Operativer Entscheider") bestimmt.
+    *   Die Engine prüft das `Ops Focus: Secondary` Flag (z.B. bei Krankenhäusern).
+    *   Die passenden Textbausteine (Betreff, Intro, Social Proof) werden aus der vor-generierten Matrix geladen.
+5.  **Sync Back:** Alle Texte (Opener + Matrix-Bausteine) werden in die benutzerdefinierten Felder (UDFs) der Person in SuperOffice zurückgeschrieben.
+6.  **Execution:** Die Marketing-Automation nutzt diese Felder (`{udf_opener}`, `{udf_intro}`), um hoch-personalisierte E-Mails zu versenden.
+
 ## Architektur im Überblick
 
 ```text