docs: KI-Kommentare für deploy.py und docker-compose.yaml — 100% zukunftssicher

docker-compose.yaml

@@ -1,3 +1,32 @@
+# =============================================================================
+# docker-compose.yaml — LeoCRM Multi-Container Setup
+#
+# ⚠️ KI / AGENT HINWEISE — BITTE VOR ÄNDERUNGEN LESEN ⚠️
+#
+# ARCHITEKTUR: Einzelner docker-compose Stack für Coolify (build_pack=dockercompose)
+# Coolify liest diese Datei aus dem Git-Repo und baut alle 4 Container in einem
+# gemeinsamen Stack. Alle Container teilen sich ein Docker-Netzwerk.
+#
+# ❌ NICHT tun:
+# - Service-Namen mit Bindestrich (crm-app, crm-worker). Coolify konvertiert
+#   Bindestriche zu Unterstrichen in docker_compose_domains → kein Match →
+#   keine Traefik-Labels → 503 Fehler. Verwende Unterstriche: crm_app, crm_worker.
+# - Datei als docker-compose.yml (mit .yml) speichern. Coolify sucht .yaml.
+# - :443 an Domain anhängen. Das führt zu leeren Host() Traefik-Labels.
+# - Eigene networks definieren. Coolify verwaltet das Netzwerk automatisch.
+# - container_name setzen. Coolify generiert Container-Namen automatisch.
+#
+# ✅ RICHTIG:
+# - Service-Namen mit Unterstrichen: postgres, redis, crm_app, crm_worker
+# - SERVICE_FQDN_CRM_APP_8000 in environment für automatische Domain-Konfiguration
+# - depends_on mit condition: service_healthy für korrekte Start-Reihenfolge
+# - crm_worker depends_on crm_app (service_healthy) damit prestart.sh zuerst läuft
+#   und DB-Passwörter setzt bevor der Worker startet
+#
+# MEHRERE INSTANZEN:
+# - APP_NAME und APP_DOMAIN als ENV-Variablen im deploy.py Aufruf setzen
+# - Alle anderen Werte werden aus ENV-Variablen gelesen
+# =============================================================================
 services:
   postgres:
     image: pgvector/pgvector:pg16