Files
breakpilot-core/docs-src/index.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.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

Architektur

Entwicklung