[30388f42] Recovery & Stabilization: Restored productive core stack, implemented Docker Volumes for DB persistence, and fixed frontend build issues.
This commit is contained in:
100
readme.md
100
readme.md
@@ -21,6 +21,63 @@ gitea: none
|
||||
---
|
||||
# Projekt: Automatisierte Unternehmensbewertung & Lead-Generierung v2.2.1
|
||||
|
||||
## ‼️ Aktueller Projekt-Fokus (März 2026): Migration der Docker-Infrastruktur
|
||||
|
||||
**Das gesamte Projekt befindet sich in der Vorbereitung für einen vollständigen Umzug von der Synology-Entwicklungsumgebung auf eine neue, produktive Ubuntu VM (`docker1`).**
|
||||
|
||||
Alle aktuellen Aufgaben, Analysen und Todos für dieses Vorhaben sind in der folgenden Datei zentralisiert:
|
||||
|
||||
➡️ **[`RELOCATION.md`](./RELOCATION.md)**
|
||||
|
||||
Diese Datei ist die primäre "Source of Truth" für den Migrationsprozess und enthält:
|
||||
- Die Anforderungsliste für die IT (Ports, Firewall-Regeln).
|
||||
- Den verbindlichen, sicheren Migrationsplan (Clean Slate).
|
||||
- Den aktuellen Status und eine Post-Mortem-Analyse der Stabilisierungsmaßnahmen.
|
||||
|
||||
---
|
||||
|
||||
## 📑 Projekt-Übersicht (Readmes)
|
||||
|
||||
Für eine umfassende Übersicht über allgemeine Projektdokumente, Architektur und Entwicklungsrichtlinien, konsultieren Sie bitte den `docs/`-Ordner.
|
||||
|
||||
| Modul / Projekt | Verzeichnis | Beschreibung |
|
||||
| :--- | :--- | :--- |
|
||||
| **SuperOffice Connector** | [📂 `./connector-superoffice`](./connector-superoffice/README.md) | GTM Engine & SuperOffice CRM Integration ("The Muscle"). |
|
||||
| **B2B Marketing Assistant** | [📂 `./b2b-marketing-assistant`](./b2b-marketing-assistant/README.md) | KI-gestützter Assistent für B2B-Marketing-Strategien. |
|
||||
| **Content Engine** | [📂 `./content-engine`](./content-engine/README.md) | Dashboard zur Generierung von SEO- & Sales-Content ("The Mouth"). |
|
||||
| **GTM Architect** | [📂 `./gtm-architect`](./gtm-architect/README.md) | Strategie-Entwicklung und Architektur für Go-to-Market ("The Brain"). |
|
||||
| **Market Intelligence** | [📂 `./general-market-intelligence`](./general-market-intelligence/README.md) | Analyse von Markt- und Unternehmensdaten. |
|
||||
| **Competitor Analysis** | [📂 `./competitor-analysis-app`](./competitor-analysis-app/README.md) | Agent zur detaillierten Wettbewerbsanalyse. |
|
||||
| **Heatmap Tool** | [📂 `./heatmap-tool`](./heatmap-tool/README.md) | Visualisierung von Excel-Daten auf einer PLZ-Karte. |
|
||||
| **K-Pop Thumbnail Genie** | [📂 `./k-pop-thumbnail-genie`](./k-pop-thumbnail-genie/README.md) | Spezialisierter Generator für K-Pop Thumbnails. |
|
||||
|
||||
---
|
||||
|
||||
## Current Status (March 7, 2026) - Infrastructure Stabilization
|
||||
|
||||
### 1. Docker Architecture Update
|
||||
* **Docker Volumes:** Databases are now stored in named Docker volumes (`connector_db_data`, `explorer_db_data`) instead of bind mounts to resolve permission issues on Synology.
|
||||
* **Secure Configuration:** All API keys and secrets are now strictly loaded from `.env` via `docker-compose.yml` environment mapping. File-based secrets (`*.txt`) are deprecated.
|
||||
* **Healthchecks:** Added robust healthchecks for `company-explorer` and `connector-superoffice` to prevent Nginx startup race conditions.
|
||||
|
||||
### 2. SuperOffice Connector (v2.1)
|
||||
* **Status:** Healthy and authenticated.
|
||||
* **Database:** Uses internal volume `/app/data/connector_queue.db`.
|
||||
|
||||
### 3. Company Explorer (v0.7.3)
|
||||
* **Status:** Healthy.
|
||||
* **Styling:** Frontend styling is currently disabled (PostCSS removed) to allow stable builds. Needs to be re-enabled post-migration.
|
||||
* **Data:** Recovered via Synology Drive and injected into Docker volume.
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Next Steps for User (Immediate Actions)
|
||||
|
||||
1. **Migration:** Follow the plan in `RELOCATION.md` to deploy on the new Ubuntu VM.
|
||||
2. **Backup:** Ensure regular backups of the new Docker volumes.
|
||||
|
||||
---
|
||||
|
||||
## 1. Projektübersicht & Architektur
|
||||
|
||||
Dieses Projekt ist eine modulare "Lead Enrichment Factory", die darauf ausgelegt ist, Unternehmensdaten aus einem D365-CRM-System automatisiert anzureichern, zu analysieren und für Marketing- & Vertriebszwecke aufzubereiten.
|
||||
@@ -63,7 +120,14 @@ VII. DIE STRATEGIE-SCHMIEDE (GTM Architect)
|
||||
├── gtm-architect/ (React Frontend)
|
||||
└── server.cjs (Node.js API-Bridge)
|
||||
|
||||
VIII. DAS FUNDAMENT
|
||||
VIII. MARKETING AUTOMATION CORE (Company Explorer)
|
||||
└── Backend-Logik für hyper-personalisierte E-Mail-Texte (vertical x persona)
|
||||
├── database.py (Neue 'Persona' Tabelle, angepasste 'MarketingMatrix')
|
||||
├── scripts/seed_marketing_data.py (Befüllt 'Persona' mit Pains/Gains)
|
||||
├── scripts/sync_notion_personas.py (Synchronisiert Personas aus Notion)
|
||||
└── scripts/generate_matrix.py (Generiert Texte für alle Vertical x Persona Kombinationen)
|
||||
|
||||
IX. DAS FUNDAMENT
|
||||
└── config.py (Einstellungen & Konstanten für ALLE)
|
||||
```
|
||||
|
||||
@@ -940,3 +1004,37 @@ Als eine zukünftige, sehr wertvolle Erweiterung ist die detaillierte, automatis
|
||||
* Der technische Aufwand für ein robustes System, das Karriereseiten findet, die verschiedenen Job-Portale parst und die relevanten Informationen extrahiert, ist immens.
|
||||
* **Status:**
|
||||
* Diese Erweiterung wird für eine spätere Entwicklungsphase vorgemerkt und sollte aufgrund der Komplexität in einem klar abgegrenzten, überschaubaren Rahmen umgesetzt werden.
|
||||
|
||||
|
||||
----
|
||||
|
||||
## 14. Test-Übersicht & Qualitätssicherung
|
||||
|
||||
Um die Stabilität und Korrektheit der automatisierten Prozesse zu gewährleisten, verfügt das Projekt über eine Reihe von automatisierten Tests, die in verschiedene Kategorien unterteilt sind.
|
||||
|
||||
### A. SuperOffice Connector Tests
|
||||
Diese Tests befinden sich im Ordner `connector-superoffice/tests/` und validieren die Kommunikation zwischen SuperOffice und dem Company Explorer.
|
||||
|
||||
* **`test_e2e_flow.py`**: Der umfassendste Integrationstest. Er simuliert den gesamten Datenzyklus:
|
||||
1. Anlage eines Accounts in SuperOffice (Webhook-Simulation).
|
||||
2. Provisionierung im Company Explorer (CE).
|
||||
3. Automatisches Zurückschreiben der Branche (Vertical) nach SuperOffice.
|
||||
4. Anlage einer Person & Generierung personalisierter Marketing-Texte basierend auf Rolle und Branche.
|
||||
5. Simulation einer manuellen Branchenänderung im CRM inkl. Kaskaden-Update für alle zugehörigen Personen.
|
||||
* **`test_client.py`**: Verifiziert die grundlegende Funktionalität des SuperOffice API-Clients (Authentifizierung, Token-Refresh, einfache GET/POST/PUT Operationen).
|
||||
|
||||
### B. Company Explorer Backend Tests
|
||||
Diese Tests befinden sich in `company-explorer/backend/tests/` und prüfen die internen Logik-Komponenten.
|
||||
|
||||
* **`test_metric_parser.py`**: **Kritische Regressions-Tests** für die numerische Extraktion (deutsche Lokalisierung). Prüft komplexe Fälle wie:
|
||||
* Tausender-Trennzeichen vs. Dezimalpunkte.
|
||||
* Verkettete Zahlen und Jahre (z.B. "802020").
|
||||
* Ignorieren von Jahreszahlen als Kennzahlen.
|
||||
* **`test_classification_service.py`**: Validiert die KI-basierte Einstufung von Unternehmen in Branchen-Verticals und die Bewertung des Automatisierungspotenzials.
|
||||
* **`test_opener_logic.py`**: Prüft die Generierung der personalisierten Einleitungssätze (Openers) basierend auf Website-Scrapes und Branchen-Pains.
|
||||
|
||||
### C. Infrastruktur & API Tests
|
||||
Allgemeine Tests im Hauptverzeichnis zur Absicherung der Schnittstellen.
|
||||
|
||||
* **`test_opener_api.py`**: Testet spezifisch den `/api/provision/superoffice-contact` Endpunkt des Company Explorers.
|
||||
* **`test_core_functionality.py`**: Basis-Checks für die System-Integrität (Datenbank-Verbindung, API-Health).
|
||||
Reference in New Issue
Block a user