meldestelle/docs
StefanMoCoAt d7cf8200e1 refactor(auth): migrate Auth module from feature to core package
- 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`.
2026-01-23 01:16:40 +01:00
..
01_Architecture docs: enhance local dev docs, update Docker Compose, and archive old journals 2026-01-20 14:00:09 +01:00
02_Onboarding docs: restructure domain documentation and update references 2026-01-15 13:44:49 +01:00
02_Reference/Tech_Stack docs: add new documentation for API Gateway, core model, and backend structure 2026-01-15 13:53:56 +01:00
03_Domain docs: add core domain SQL schema draft and enhance domain glossary 2026-01-16 11:32:53 +01:00
04_Agents docs: enhance local dev docs, update Docker Compose, and archive old journals 2026-01-20 14:00:09 +01:00
05_Backend docs: add infrastructure guide for JWT in Docker and refactor Keycloak config 2026-01-22 17:23:24 +01:00
06_Frontend refactor(ping-feature): integrate DI refactor, enhance web build, and update feature workflow 2026-01-17 12:05:34 +01:00
07_Infrastructure docs: add infrastructure guide for JWT in Docker and refactor Keycloak config 2026-01-22 17:23:24 +01:00
90_Reports refactor(auth): migrate Auth module from feature to core package 2026-01-23 01:16:40 +01:00
99_Journal refactor(auth): migrate Auth module from feature to core package 2026-01-23 01:16:40 +01:00
.frontmatter.schema.json Fix: Test-Commit für VCS-Integration (MP-8) (#15) 2025-11-07 12:26:33 +01:00
README.md docs: restructure domain documentation and update references 2026-01-15 13:44:49 +01:00

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- oder Infrastructure-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