stefan
ec616a7956
- Integrated detailed reports on compatibility and strategic architecture for the 2026 technology stack. - Documents analyze JVM/Multiplatform components including Kotlin 2.3.0, Java 25, Spring Boot 3.5.9, and Compose Multiplatform. - Provides guidance on resolving dependency conflicts, best practices, and version alignment for production readiness.
Meldestelle - Dokumentation
📚 Single Source of Truth: YouTrack
Die Hauptdokumentation befindet sich in der YouTrack Wissensdatenbank:
Was du in YouTrack findest
- 🏗️ Bounded Context Dokumentation (Members, Horses, Events, Masterdata)
- 📡 API-Referenz (automatisch aus KDoc generiert)
- 🚀 Deployment-Guides (Proxmox, Cloudflare, Nginx)
- 🔐 Sicherheit-Konfigurationen (Keycloak, GitHub Secrets)
- 💡 Roadmap & Visionen
- 📊 Architektur-Diagramme (interaktiv)
📂 Was im Repository bleibt
1. Architecture Decision Records (ADRs)
Architekturentscheidungen sind Teil der Code-Historie und werden im Repository versioniert:
- ADR Übersicht
- ADR-0001: Modulare Architektur
- ADR-0002: Domain-Driven Design
- ADR-0003: Microservices
- ADR-0004: Event-Driven Communication
- ADR-0005: Polyglot Persistence
- ADR-0006: Authentication & Authorization (Keycloak)
- ADR-0007: API Gateway Pattern
- ADR-0008: Multiplatform Client Applications
- ADR-0009: Final KMP Architecture
2. C4-Diagramme (PlantUML-Quellen)
Versionierte Diagramm-Quellen für Architekturdokumentation:
3. Developer Guides
Minimale Anleitungen für lokale Entwicklung:
- Lokales Setup – Projekt in 5 Minuten starten
- KDoc Style Guide – Documentations-Konventionen im Code
- Branch-Schutz & PR-Workflow – Git-Workflow
🔄 Automatische Synchronisation
Das Projekt nutzt automatisierte Workflows für Konsistenz:
- KDoc → YouTrack: docs-kdoc-sync.yml – Synchronisiert API-Dokumentation aus Code-Kommentaren nach YouTrack
- Docker SSoT: ssot-guard.yml – Validiert Docker-Versionskonsistenz
- CI Pipeline: ci-main.yml – Hauptpipeline für Build, Tests, Validierung
📋 Documentations-Workflow
Für Code-Änderungen
- KDoc im Code schreiben
- PR erstellen → CI validiert
- Nach Merge → KDoc-Sync pusht automatisch nach YouTrack
Für Architektur-Entscheidungen
- ADR in
docs/adr/erstellen - PR mit ADR-Review
- Nach Merge → Zusammenfassung in YouTrack verlinken
Für Infrastruktur/Konfiguration
- Dokumentation direkt in YouTrack erstellen
- Bei Code-relevanten Änderungen → im Commit-Message auf YouTrack-Artikel verweisen
❓ Fragen & Support
- Technische Fragen: GitHub Discussions
- Bugs: GitHub Issues
- Architektur-Diskussionen: YouTrack
- Projekt-Dokumentation: YouTrack Wissensdatenbank
Hinweis: Diese README wurde am 8. Dezember 2025 aktualisiert im Rahmen der Dokumentations-Migration nach YouTrack (siehe ADR-0009).