Brancheneinstufung2/n8n_migration_plan.md

Plan zur Migration des "General Market Intelligence" Skripts nach n8n (Hybrid-Ansatz)

Dieses Dokument beschreibt den Plan zur Nachbildung der Funktionalität der React-Anwendung unter /general-market-intelligence als Backend-Logik in der Automatisierungsplattform n8n.

1. Zielsetzung (Hybrid-Ansatz)

Das Ziel ist die Auslagerung der Kernlogik (insbesondere der Gemini API-Aufrufe) aus der React-Anwendung in n8n-Workflows. Dies erhöht die Transparenz, Kontrolle und Stabilität der Ergebnisse.

• Die bestehende React-Anwendung bleibt als interaktives Frontend für die Benutzerführung und Datenvisualisierung erhalten.
• n8n fungiert als reines Backend-API, das von der React-Anwendung aufgerufen wird, um die rechenintensiven Aufgaben auszuführen.

Dieser Ansatz kombiniert das Beste aus beiden Welten: eine reaktionsschnelle, benutzerfreundliche Oberfläche und ein robustes, leicht anpassbares Backend.

2. Analyse der Kernfunktionalität

Die bestehende Anwendung führt fünf Hauptschritte aus, die nun als separate, aufrufbare n8n-Workflows modelliert werden:

1. Strategie-Erstellung: Generiert eine Suchstrategie aus einem Strategie-Dokument und einer Referenz-URL.
2. Lead-Identifizierung: Findet ähnliche Unternehmen basierend auf der Referenz-URL.
3. Manuelle Überprüfung: Dieser Schritt verbleibt vollständig im React-Frontend. Die App zeigt die Liste an und ermöglicht die Kuratierung.
4. Tiefenanalyse: Analysiert die vom Nutzer kuratierte Liste von Unternehmen.
5. Kampagnen-Erstellung: Generiert personalisierte E-Mail-Entwürfe.

3. Hybrid-Architektur: Zusammenspiel von React & n8n

Die Kommunikation zwischen Frontend und Backend erfolgt über Webhooks:

1. n8n-Workflows als API-Endpunkte: Jeder Kernprozess wird als eigener n8n-Workflow mit einem Webhook-Trigger erstellt. Dieser Trigger stellt eine einzigartige URL bereit, die auf Anfragen wartet.
2. React-App als Client: Die Funktionen in der geminiService.ts-Datei der React-App werden so angepasst, dass sie nicht mehr direkt die Gemini-API, sondern die entsprechenden n8n-Webhook-URLs aufrufen (mittels fetch oder axios).
3. Datenfluss (Beispiel):
   • Der Nutzer lädt in der React-App eine Strategie-Datei hoch und klickt auf "Strategie erstellen".
   • Die React-App sendet den Dateiinhalt und die Referenz-URL per POST-Request an den n8n-Webhook für die Strategie-Erstellung.
   • Der n8n-Workflow wird ausgelöst, führt den Gemini-Call aus und sendet das Ergebnis (das SearchStrategy-JSON) als Antwort auf den Webhook-Request zurück.
   • Die React-App empfängt die JSON-Antwort und zeigt dem Nutzer den nächsten Schritt an.

4. Benötigte n8n-Workflows (API-Endpunkte)

Die folgenden Workflows müssen in n8n erstellt werden, um die Logik aus geminiService.ts abzubilden.

---

Workflow 1: generateSearchStrategy

• Trigger: Webhook (erwartet POST-Request)
• Input (JSON Body): { "referenceUrl": "...", "contextContent": "..." }
• Aktion:
  1. Nimmt die Eingabedaten entgegen.
  2. Baut den Prompt für die Strategie-Generierung.
  3. Ruft den Gemini-Knoten auf.
• Output: Respond to Webhook-Knoten, der das SearchStrategy JSON-Objekt zurückgibt.

---

Workflow 2: identifyCompetitors

• Trigger: Webhook (erwartet POST-Request)
• Input (JSON Body): { "referenceUrl": "...", "targetMarket": "..." }
• Aktion:
  1. Baut den Prompt zur Identifizierung von Wettbewerbern.
  2. Ruft den Gemini-Knoten auf.
• Output: Respond to Webhook-Knoten, der die Liste der gefundenen Unternehmen als JSON-Array zurückgibt.

---

Workflow 3: runFullAnalysis

Dieser Workflow führt die Tiefenanalyse für eine ganze Liste von Unternehmen durch.

• Trigger: Webhook (erwartet POST-Request)
• Input (JSON Body): { "strategy": { ... }, "companies": [ { "name": "..." }, ... ] }
• Aktion:
  1. Nutzt den Loop Over Items-Knoten, um über die companies-Liste zu iterieren.
  2. Innerhalb des Loops: Ruft für jedes Unternehmen den Gemini-Knoten mit dem Prompt für die Tiefenanalyse (analyzeCompanyWithStrategy) auf.
  3. Sammelt die Ergebnisse aller Iterationen.
• Output: Respond to Webhook-Knoten, der eine vollständige Liste von AnalysisResult-Objekten als JSON zurückgibt.

---

Workflow 4: generateOutreachCampaign

• Trigger: Webhook (erwartet POST-Request)
• Input (JSON Body): { "companyData": { ... }, "knowledgeBase": "...", "referenceUrl": "..." }
• Aktion:
  1. Baut den Prompt für die Erstellung der E-Mail-Kampagne.
  2. Ruft den Gemini-Knoten auf.
• Output: Respond to Webhook-Knoten, der die EmailDraft-Objekte als JSON-Array zurückgibt.

5. Nächste Schritte

1. Umsetzung in n8n: Erstellen der vier beschriebenen Workflows, beginnend mit generateSearchStrategy.
2. Anpassung der React-App: Modifizieren der geminiService.ts, um die fetch-Aufrufe auf die neuen n8n-Webhook-URLs umzuleiten.
3. Konfiguration: Die URLs der n8n-Webhooks müssen in der React-Anwendung als Umgebungsvariablen (.env.local) konfiguriert werden, um Flexibilität zwischen Entwicklungs- und Produktionsumgebungen zu gewährleisten.
4. Sicherheit: Absicherung der n8n-Webhooks, z.B. durch einen geheimen Header-Parameter, um unbefugte Aufrufe zu verhindern.