Stefan Mogeritsch
84337697ce
Updated code block formatting in `Ping-Service_Impl_01-2026.md` for consistency by switching from `kotlin` to `text`. Refactored `README.md` to rename `02_Onboarding` to `02_Guides` for improved clarity. Adjusted UI code example in `UIUXDesigner.md` with added descriptive comments.
45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
# 📚 Projektdokumentation "Meldestelle"
|
|
|
|
Willkommen im "Gehirn" des Projekts. Dieses Verzeichnis ist die **Single Source of Truth**.
|
|
|
|
## 📂 Struktur
|
|
|
|
### 🏗️ Core
|
|
* **[`01_Architecture`](01_Architecture/)**: Der Masterplan. ADRs, Roadmaps und C4-Modelle.
|
|
* *Start hier:* `MASTER_ROADMAP_2026_Q1.md`
|
|
* **[`02_Guides`](02_Guides/)**: Guides für neue Entwickler (Setup, Guidelines).
|
|
* **[`03_Domain`](03_Domain/)**: Fachlichkeit (Turnierregeln, Entities).
|
|
|
|
### 🛠️ Tech Stack
|
|
* **[`05_Backend`](05_Backend/)**: Spring Boot Services, API-Specs, DB-Schema.
|
|
* *Referenz:* `Services/PingService_Reference.md`
|
|
* **[`06_Frontend`](06_Frontend/)**: Kotlin Multiplatform, Compose UI, State Management.
|
|
* **[`07_Infrastructure`](07_Infrastructure/)**: Docker, Keycloak, CI/CD.
|
|
|
|
### 🤖 Process
|
|
* **[`04_Agents`](04_Agents/)**: Playbooks für unsere KI-Mitarbeiter.
|
|
* **[`90_Reports`](90_Reports/)**: Statusberichte und Meilenstein-Analysen.
|
|
* **[`99_Journal`](99_Journal/)**: Tägliche Session-Logs.
|
|
|
|
---
|
|
|
|
## 📝 Regeln für die Dokumentation
|
|
|
|
1. **Docs-as-Code:** Doku liegt beim Code und wird im selben PR aktualisiert.
|
|
2. **Frontmatter:** Jede Markdown-Datei muss einen YAML-Header haben:
|
|
```yaml
|
|
---
|
|
type: [ADR, Guide, Reference, Report, Journal]
|
|
status: [DRAFT, ACTIVE, DEPRECATED, ARCHIVED]
|
|
owner: [Rolle]
|
|
---
|
|
```
|
|
3. **Archivierung:** Lösche nichts. Verschiebe veraltetes Wissen in `_archive` Ordner oder markiere es als `ARCHIVED`.
|
|
|
|
---
|
|
|
|
## 🚀 Quick Links
|
|
* [Master Roadmap](01_Architecture/MASTER_ROADMAP_2026_Q1.md)
|
|
* [Ping Service Reference](05_Backend/Services/PingService_Reference.md)
|
|
* [Agent Playbooks](04_Agents/)
|