[30388f42] docs: Final restructuring - Separate active knowledge from legacy archive

This commit is contained in:
2026-03-08 12:34:08 +00:00
parent ff3932b3e1
commit bd1657e7f4
5 changed files with 199 additions and 262 deletions

36
docs/INFRASTRUCTURE.md Normal file
View File

@@ -0,0 +1,36 @@
# Infrastructure & Operations
## 🏗️ Konsolidierte Architektur & Web-Anwendungen
Um die Wartbarkeit zu erhöhen, wurden diverse Einzeltools (B2B Marketing Assistant, Market Intelligence, GTM Architect) in eine konsolidierte Docker-Architektur überführt.
### Architektur im Überblick
Die Lösung basiert auf einem zentralen **Nginx-Gateway** (`gateway_proxy`), das alle Anfragen auf Port **8090** entgegennimmt und an die entsprechenden Container weiterleitet.
* **Zentraler & Sicherer Zugriff:** Nur ein Port muss extern freigegeben werden.
* **Einheitliche Auth:** Basic Auth schützt alle internen Tools.
* **Routing-Tabelle:**
* `/` -> Dashboard
* `/ce/` -> Company Explorer
* `/lead/` -> Lead Engine
* `/market/` -> Market Intelligence
* ... (siehe `readme.md` für vollständige Liste)
### Microservice-Pattern
Viele der neuen Apps (GTM Architect, Market Intel) nutzen ein "Self-Contained" Pattern:
* **Frontend:** Vite/React (gebaut im Dockerfile).
* **Backend:** Node.js Bridge (`server.cjs`), die Python-Skripte orchestriert.
* **Vorteil:** Ein einziger Container pro Tool, der sowohl UI als auch Logik bereitstellt.
---
## 🌐 DNS & Connectivity (DuckDNS)
Um eine stabile Erreichbarkeit der Dienste auch bei wechselnden IPs (DynDNS) zu gewährleisten, wurde eine Docker-basierte Lösung implementiert.
* **Service:** `duckdns` (LinuxServer.io Container).
* **Funktion:** Aktualisiert die Domain `floke-ai.duckdns.org` alle 5 Minuten mit der aktuellen öffentlichen IP.
* **Monitoring:** Ein Sidecar-Container `dns-monitor` prüft die Auflösung und warnt bei Fehlern.
Siehe auch: [DuckDNS Setup](./duckdns_setup.md) (falls vorhanden).