docs: Update documentation for consolidated Docker architecture
- Consolidated architecture overview in readme.md\n- Updated deployment and development sections in b2b_marketing_assistant_plan.md and market_intel_backend_plan.md
This commit is contained in:
@@ -82,30 +82,35 @@ Die Logik aus `geminiService.ts` wird in Python-Funktionen innerhalb von `market
|
||||
2. Ruft die Gemini-API auf.
|
||||
- **Output:** Gibt die `EmailDraft`-Objekte als JSON-Array aus.
|
||||
|
||||
## 4. Nächste Schritte (für die nächste Sitzung)
|
||||
## 4. Deployment & Betrieb in der Konsolidierten Architektur
|
||||
|
||||
1. Die neuesten Code-Änderungen pullen (`git pull`).
|
||||
2. Das Docker-Image neu bauen, um die Korrektur zu übernehmen: `docker build -t market-intel-backend .`
|
||||
3. Den alten Container stoppen/entfernen und den neuen starten: `docker run -p 3001:3001 --name market-intel-backend-instance market-intel-backend`
|
||||
4. Den React-Dev-Server starten und den End-to-End-Test erneut durchführen.
|
||||
Das Market Intelligence Tool ist nun vollständig in die zentrale Docker-Compose-Architektur des Projekts integriert. Das separate Bauen und Starten einzelner Container, wie in den alten Abschnitten beschrieben, ist nicht mehr der richtige Weg.
|
||||
|
||||
## 5. Aktueller Status und Debugging-Protokoll (Stand: 2025-12-21 - Abschluss der Sitzung)
|
||||
### Zentraler Start via Docker Compose
|
||||
|
||||
### Status: End-to-End System voll funktionsfähig, Grounded & UX-optimiert!
|
||||
Der gesamte Anwendungs-Stack (Proxy, Dashboard, B2B Assistant, Market Intelligence) wird über die `docker-compose.yml`-Datei im Hauptverzeichnis des Projekts verwaltet und gestartet.
|
||||
|
||||
Wir haben heute das gesamte System von einer instabilen n8n-Abhängigkeit zu einem robusten, autarken Python-Service transformiert.
|
||||
1. **Navigieren Sie in das Projekt-Hauptverzeichnis.**
|
||||
2. **Starten Sie alle Dienste:**
|
||||
```bash
|
||||
docker-compose up -d --build
|
||||
```
|
||||
Der `--build`-Parameter sorgt dafür, dass alle Docker-Images neu erstellt werden. Dies ist bei Änderungen am Frontend (`App.tsx`), an den `Dockerfile`n oder den `requirements.txt`/`package.json` notwendig.
|
||||
|
||||
**Wichtigste Errungenschaften:**
|
||||
- **Präzises Lookalike-Sourcing:** Die Konkurrenten-Identifikation wurde von einer reinen Branchensuche auf eine **ICP-basierte Lookalike-Suche** umgestellt. Die Ergebnisse sind nun hochrelevant und thematisch am Referenzkunden ausgerichtet.
|
||||
- **Deep Tech Audit mit Beweisführung:** Der Audit-Prozess (Schritt 3) nutzt nun eine kaskadierende Suchstrategie (Homepage-Scrape + gezielte SerpAPI-Suchen). Die KI zitiert konkrete Beweise (z.B. aus Stellenanzeigen) und liefert verifizierbare Links ("Proof").
|
||||
- **Echtes Terminal-Feedback:** Die UI zeigt nun während des Audits einen **echten Live-Log** des Agenten an (Searching, Scraping, Analyzing), was die Wartezeit transparent macht.
|
||||
- **Robustes Logging:** Umstellung auf **Tages-Logdateien** (z.B. `2025-12-21_market_intel.log`), die im `/app/Log` Verzeichnis (via Docker Volume) gespeichert werden und den vollständigen Verlauf inkl. Prompts enthalten.
|
||||
- **Optimierte Infrastruktur:** Schlankes Docker-Image mit Bind Mounts ermöglicht **Hot-Reloading** des Python-Codes und direkten Zugriff auf Logs und Keys (`serpapikey.txt`, `gemini_api_key.txt`).
|
||||
### Zugriff
|
||||
|
||||
**Gelöste Probleme heute:**
|
||||
- **Abhängigkeits-Chaos:** Vollständige Entkopplung von `helpers.py` und `config.py` im Backend-Orchestrator.
|
||||
- **API-Endpunkt Fehler:** Behebung aller `v1beta` 404 Fehler durch Umstieg auf direkte REST-Calls (Gemini v1).
|
||||
- **Frontend-Abstürze:** Absicherung des Reports gegen fehlende Datenpunkte.
|
||||
- Das zentrale Dashboard ist unter `http://<Server-IP>:8090` erreichbar.
|
||||
- Das **Market Intelligence Tool** ist direkt über das Unterverzeichnis `http://<Server-IP>:8090/market/` zugänglich.
|
||||
- Der Zugang ist durch Basic Authentication geschützt (Benutzer: `admin`, Passwort: `gemini`).
|
||||
|
||||
### Entwicklung (Sideloading)
|
||||
|
||||
Für eine schnelle Entwicklung ist "Sideloading" für die Python-Logik aktiviert. Das bedeutet, die `market_intel_orchestrator.py` wird als Volume in den Container gemountet.
|
||||
|
||||
- **Nach Änderungen am Python-Skript:** Ein einfacher Neustart des Containers genügt, um die Änderungen zu übernehmen. Ein kompletter Rebuild ist nicht erforderlich.
|
||||
```bash
|
||||
docker-compose restart market-backend
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user