- Reorganized `auth-feature` into `core/auth` to improve architecture and modularity. - Removed unused PKCE and OAuth callback utilities (`AuthCallbackParams`, `OAuthPkceService`). - Updated imports and adjusted build scripts to reflect new module structure. - Refactored `LoginScreen` and `PingScreen` to include `onBack` functionality in top bars for improved navigation. - Corrected sync endpoint in `PingSyncService`. |
||
|---|---|---|
| .. | ||
| 01_Architecture | ||
| 02_Onboarding | ||
| 02_Reference/Tech_Stack | ||
| 03_Domain | ||
| 04_Agents | ||
| 05_Backend | ||
| 06_Frontend | ||
| 07_Infrastructure | ||
| 90_Reports | ||
| 99_Journal | ||
| .frontmatter.schema.json | ||
| README.md | ||
Projektdokumentation "Meldestelle"
Willkommen zur zentralen Projektdokumentation. Dieses Verzeichnis ist die "Single Source of Truth" für alle architektonischen Entscheidungen, Anleitungen und Implementierungsdetails.
Die Dokumentation wird nach dem "Docs-as-Code"-Prinzip gepflegt: Sie liegt neben dem Code, wird mit Git versioniert und von allen Teammitgliedern (Mensch und KI) aktuell gehalten.
Struktur der Dokumentation
- /01_Architecture: Architektur (ADRs, C4/Diagramme, Architektur-Referenzen).
- /02_Onboarding: Einstieg & Entwickler-Workflow (lokales Setup, PR-Workflow, Style-Guides).
- /03_Domain: Fachliche Domäne (Kern-Modell, Referenzen, Analyse).
- /04_Agents: Agent Operating Model (AOM) + Playbooks für KI-Unterstützung.
- /05_Backend: Backend-spezifische Dokumentation (Services, Datenmodelle, Integrationen).
- /06_Frontend: Frontend-spezifische Dokumentation (KMP/Compose, Offline/Synchronisierung).
- /07_Infrastructure: Betrieb & Infrastruktur (Docker, Keycloak, Observability, Runbooks).
- /90_Reports: Berichte/Analysen/Status-Reports (zeitlich geordnet, nicht zwingend „verbindliche Regeln“).
- /99_Journal: Kurzprotokolle pro Session (Anti-Wissensverlust, Nachvollziehbarkeit).
Wie man diese Dokumentation pflegt
Jeder Entwickler und jeder KI-Agent ist dafür verantwortlich, die Dokumentation, die seinen Arbeitsbereich betrifft, zu aktualisieren.
- Bei neuen Features: Erstelle oder aktualisiere die entsprechende Implementierungs-Doku.
- Bei Architektur-Änderungen: Erstelle ein neues ADR oder aktualisiere ein bestehendes.
- Bei Änderungen am Setup: Passe die Anleitungen im
Onboarding- oderInfrastructure-Verzeichnis an.
Änderungen an der Dokumentation sollten Teil derselben Pull Request/Commit sein wie die zugehörigen Code-Änderungen.
Wichtigste Einstiege
- Lokales Setup/Workflow:
docs/02_Onboarding/ - Fachliches Modell:
docs/03_Domain/ - Agenten/Arbeitsmodus:
docs/04_Agents/ - Architekturentscheidungen:
docs/01_Architecture/adr/ - Backend (pro Service):
docs/05_Backend/Services/ - Ping-Service (Startpunkt):
docs/05_Backend/Services/ping-service.md - Ping-Service Implementierungs-Report (Historie):
docs/90_Reports/Ping-Service_Impl_01-2026.md