[30388f42] docs: Final restructuring - Separate active knowledge from legacy archive
This commit is contained in:
36
docs/INFRASTRUCTURE.md
Normal file
36
docs/INFRASTRUCTURE.md
Normal 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).
|
||||
Reference in New Issue
Block a user