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>
2.5 KiB
2.5 KiB
BreakPilot Core - Dokumentation
Zentrale Infrastruktur-Dokumentation fuer das BreakPilot-Oekosystem.
Drei-Projekt-Architektur
BreakPilot besteht aus drei unabhaengigen Projekten:
| Projekt | Beschreibung | Container-Prefix | Farbe |
|---|---|---|---|
| breakpilot-core (dieses Projekt) | Shared Infrastructure | bp-core-* |
Teal |
| breakpilot-lehrer | Bildungs-Stack (Team A) | bp-lehrer-* |
Blau |
| breakpilot-compliance | DSGVO/Compliance-Stack (Team B) | bp-compliance-* |
Lila |
Deployment-Modell
| Repo | Deployment | Trigger |
|---|---|---|
| breakpilot-core | Coolify (automatisch) | Push auf gitea main |
| breakpilot-compliance | Coolify (automatisch) | Push auf gitea main |
| breakpilot-lehrer | Mac Mini (lokal) | Manuell docker compose |
Core Services
| Service | Container | Port | Beschreibung |
|---|---|---|---|
| Nginx | bp-core-nginx | 80/443 | Reverse Proxy + TLS fuer alle drei Projekte |
| PostgreSQL | bp-core-postgres | 5432 | Zentrale Datenbank (PostGIS 16) |
| Valkey | bp-core-valkey | 6379 | Session Cache (Redis-Fork) |
| Vault | bp-core-vault | 8200 | Secrets Management |
| Qdrant | bp-core-qdrant | 6333 | Vector DB fuer RAG |
| MinIO | bp-core-minio | 9000 | S3-kompatibler Object Storage |
| Embedding Service | bp-core-embedding-service | 8087 | Text-Embeddings |
| RAG Service | bp-core-rag-service | 8097 | Retrieval Augmented Generation |
| Consent Service | bp-core-consent-service | 8081 | DSGVO Consent (Go) |
| Billing Service | bp-core-billing-service | 8083 | Abrechnung (Go) |
| Backend Core | bp-core-backend | 8000 | Shared API (Python) |
| Admin Core | bp-core-admin | 3008 | Admin-Dashboard (Next.js) |
| Health Aggregator | bp-core-health | 8099 | Service-Health Monitoring |
| Night Scheduler | bp-core-night-scheduler | 8096 | Nachtabschaltung |
| Mailpit | bp-core-mailpit | 8025 | E-Mail (Entwicklung) |
| Gitea | bp-core-gitea | 3003 | Git-Server |
| Gitea Runner | bp-core-gitea-runner | - | CI/CD (Gitea Actions) |
| Jitsi (5 Container) | bp-core-jitsi-* | 8443 | Videokonferenzen |