Files
breakpilot-core/docs-src/index.md
Benjamin Boenisch fdfe38b61a docs: update MkDocs for 3-project architecture (core/lehrer/compliance)
- Rewrite system-architecture.md with new 3-project diagram
- Update index.md with Core services table and nginx routing
- Replace service docs that moved to lehrer/compliance with redirects
  (klausur-service, voice-service, agent-core, ki-daten-pipeline -> lehrer)
  (ai-compliance-sdk -> compliance)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-14 19:51:09 +01:00

3.1 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

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
Pitch Deck bp-core-pitch-deck 3012 Investor-Praesentation
Mailpit bp-core-mailpit 8025 E-Mail (Entwicklung)
Gitea bp-core-gitea 3003 Git-Server
Woodpecker bp-core-woodpecker-server 8090 CI/CD
Jitsi (5 Container) bp-core-jitsi-* 8443 Videokonferenzen

Nginx Routing-Tabelle

Port Upstream Projekt
443 bp-lehrer-studio-v2:3001 Lehrer
3000 bp-lehrer-website:3000 Lehrer
3002 bp-lehrer-admin:3000 Lehrer
3006 bp-compliance-developer-portal:3000 Compliance
3007 bp-compliance-admin:3000 Compliance
3008 bp-core-admin:3000 Core
8000 bp-core-backend:8000 Core
8001 bp-lehrer-backend:8001 Lehrer
8002 bp-compliance-backend:8002 Compliance
8086 bp-lehrer-klausur-service:8086 Lehrer
8087 bp-core-embedding-service:8087 Core
8091 bp-lehrer-voice-service:8091 Lehrer
8093 bp-compliance-ai-sdk:8090 Compliance
8097 bp-core-rag-service:8097 Core
8443 bp-core-jitsi-web:80 Core

Architektur

Entwicklung