Files
breakpilot-core/docs-src/architecture/environments.md
Benjamin Admin d1632fca17 docs: update all docs to reflect Coolify deployment model
Replace Hetzner references with Coolify. Deployment is now:
- Core + Compliance: Push gitea → Coolify auto-deploys
- Lehrer: stays local on Mac Mini

Updated: CLAUDE.md, MkDocs CI/CD pipeline, MkDocs index, environments.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-13 12:18:25 +01:00

2.1 KiB

Umgebungs-Architektur

Uebersicht

BreakPilot verwendet zwei Umgebungen:

┌─────────────────┐                    ┌─────────────────┐
│   Development   │───── git push ────▶│   Production    │
│   (Mac Mini)    │                    │   (Coolify)     │
└─────────────────┘                    └─────────────────┘
     Lokale                             Automatisch
     Entwicklung                        via Coolify

Umgebungen

Development (Lokal — Mac Mini)

Zweck: Lokale Entwicklung und Tests

Eigenschaft Wert
Git Branch main
Compose File docker-compose.yml
Database Lokale PostgreSQL
Debug Aktiviert
Hot-Reload Aktiviert

Start:

ssh macmini "cd ~/Projekte/breakpilot-core && /usr/local/bin/docker compose up -d"

Production (Coolify)

Zweck: Live-System

Eigenschaft Wert
Git Branch main
Deployment Coolify (automatisch bei Push auf gitea)
Database Externe PostgreSQL (TLS)
Debug Deaktiviert

Deploy:

git push origin main && git push gitea main
# Coolify baut und deployt automatisch

Docker Compose Architektur

docker-compose.yml              ← Basis-Konfiguration (lokal, arm64)
        │
        └── docker-compose.coolify.yml   ← Production Override (amd64)

Coolify verwendet automatisch beide Compose-Files fuer den Production-Build.

Secrets Management

Development

  • .env enthält Entwicklungs-Credentials
  • Vault optional (Dev-Token)
  • Mailpit für E-Mail-Tests

Production

  • .env auf dem Server (nicht im Repository)
  • Vault PFLICHT
  • Echte SMTP-Konfiguration

Siehe auch: Secrets Management

Verwandte Dokumentation