21a844cb8a
A previous `git pull --rebase origin main` dropped 177 local commits,
losing 3400+ files across admin-v2, backend, studio-v2, website,
klausur-service, and many other services. The partial restore attempt
(660295e2) only recovered some files.
This commit restores all missing files from pre-rebase ref 98933f5e
while preserving post-rebase additions (night-scheduler, night-mode UI,
NightModeWidget dashboard integration).
Restored features include:
- AI Module Sidebar (FAB), OCR Labeling, OCR Compare
- GPU Dashboard, RAG Pipeline, Magic Help
- Klausur-Korrektur (8 files), Abitur-Archiv (5+ files)
- Companion, Zeugnisse-Crawler, Screen Flow
- Full backend, studio-v2, website, klausur-service
- All compliance SDKs, agent-core, voice-service
- CI/CD configs, documentation, scripts
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