ad111d5e69
Docker Compose with 24+ services: - PostgreSQL (PostGIS), Valkey, MinIO, Qdrant - Vault (PKI/TLS), Nginx (Reverse Proxy) - Backend Core API, Consent Service, Billing Service - RAG Service, Embedding Service - Gitea, Woodpecker CI/CD - Night Scheduler, Health Aggregator - Jitsi (Web/XMPP/JVB/Jicofo), Mailpit Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
3.8 KiB
Breakpilot Dokumentation
Willkommen zur zentralen Dokumentation des Breakpilot-Projekts.
Was ist Breakpilot?
Breakpilot ist eine DSGVO-konforme Bildungsplattform fuer Lehrkraefte mit folgenden Kernfunktionen:
- Consent-Management - Datenschutzkonforme Einwilligungsverwaltung
- KI-gestuetzte Klausurkorrektur - Automatische Bewertungsvorschlaege fuer Abiturklausuren
- Zeugnisgenerierung - Workflow-basierte Zeugniserstellung mit Rollenkonzept
- Lernmaterial-Generator - MC-Tests, Lueckentexte, Mindmaps, Quiz
- Elternbriefe - GFK-basierte Kommunikation mit PDF-Export
Schnellstart
-
:material-rocket-launch:{ .lg .middle } Erste Schritte
Entwicklungsumgebung einrichten und das Projekt starten.
-
:material-server:{ .lg .middle } Mac Mini Setup
Headless Server-Konfiguration fuer den Entwicklungsserver.
Architektur
-
:material-sitemap:{ .lg .middle } System-Architektur
Ueberblick ueber alle Komponenten und deren Zusammenspiel.
-
:material-shield-lock:{ .lg .middle } Auth-System
Hybrid-Authentifizierung mit Keycloak und lokalem JWT.
-
:material-robot:{ .lg .middle } Multi-Agent System
Verteilte Agent-Architektur fuer KI-Funktionen.
-
:material-key-chain:{ .lg .middle } Secrets Management
HashiCorp Vault Integration fuer sichere Credentials.
Services
| Service | Port | Beschreibung |
|---|---|---|
| Backend (Python) | 8000 | FastAPI Backend mit Panel UI |
| Consent Service (Go) | 8081 | DSGVO-konforme Einwilligungsverwaltung |
| Klausur Service | 8086 | KI-gestuetzte Klausurkorrektur |
| Agent Core | - | Multi-Agent Infrastructure |
| PostgreSQL | 5432 | Relationale Datenbank |
| Qdrant | 6333 | Vektor-Datenbank fuer RAG |
| MinIO | 9000 | Object Storage |
| Vault | 8200 | Secrets Management |
Entwicklung
- Testing - Test-Standards und Ausfuehrung
- Dokumentation - Dokumentations-Richtlinien
- DevSecOps - Security Pipeline
- Umgebungen - Dev/Staging/Prod
Weitere Ressourcen
- GitHub Repository: Internes GitLab
- Issue Tracker: GitLab Issues
- API Playground: http://macmini:8000/docs
Projektstruktur
breakpilot-pwa/
├── backend/ # Python FastAPI Backend
├── consent-service/ # Go Consent Service
├── klausur-service/ # Klausur-Korrektur Service
├── agent-core/ # Multi-Agent Infrastructure
├── voice-service/ # Voice/Audio Processing
├── website/ # Next.js Frontend
├── studio-v2/ # Admin Dashboard (Next.js)
├── docs-src/ # Diese Dokumentation
└── docker-compose.yml # Container-Orchestrierung
Support
Bei Fragen oder Problemen:
- Pruefen Sie zuerst die relevante Dokumentation
- Suchen Sie im Issue Tracker nach aehnlichen Problemen
- Erstellen Sie ein neues Issue mit detaillierter Beschreibung