- Documented a hybrid "Event-Sourcing Light with Lamport Clocks" approach for offline-first LAN synchronization between Meldestelle and Richter-Turm. - Included detailed options analysis (Event-Sourcing, CRDT, Timestamp-Sync) and rationale for the selected solution. - Added specifications: SyncEvent model, Lamport clock rules, WebSocket protocol (handshake, sync, recovery), and domain mastership rules. - Defined snapshot strategy to ensure scalable logs and efficient replay. - Outlined implementation plan in four phases, highlighting task breakdown for backend and frontend teams. - Updated architect, backend, and frontend roadmaps to reflect ADR-0022 integration steps. Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com> |
||
|---|---|---|
| .. | ||
| _archive | ||
| 01_Architecture | ||
| 02_Guides | ||
| 03_Domain | ||
| 04_Agents | ||
| 05_Backend | ||
| 06_Frontend | ||
| 07_Infrastructure | ||
| 90_Reports | ||
| 99_Journal | ||
| BilderSuDo | ||
| Bin | ||
| Neumarkt2026 | ||
| OePS | ||
| ScreenShots | ||
| temp | ||
| README.md | ||
📚 Projektdokumentation "Meldestelle"
Willkommen im "Gehirn" des Projekts. Dieses Verzeichnis ist die Single Source of Truth.
📂 Struktur
🏗️ Core
01_Architecture: Der Masterplan. ADRs, Roadmaps und C4-Modelle.- Start hier:
MASTER_ROADMAP.md
- Start hier:
02_Guides: Guides für neue Entwickler (Setup, Guidelines).03_Domain: Fachlichkeit (Turnierregeln, Entities).
🛠️ Tech Stack
05_Backend: Spring Boot Services, API-Specs, DB-Schema.06_Frontend: Kotlin Multiplatform, Compose UI, State Management.07_Infrastructure: Docker, Keycloak, CI/CD, Zora-Architektur.- Referenz:
Zora_System_Architektur.md
- Referenz:
🤖 Process
04_Agents: Playbooks für unsere KI-Mitarbeiter.90_Reports: Statusberichte und Meilenstein-Analysen.99_Journal: Tägliche Session-Logs.
📝 Regeln für die Dokumentation
- Docs-as-Code: Doku liegt beim Code und wird im selben PR aktualisiert.
- Frontmatter: Jede Markdown-Datei muss einen YAML-Header haben:
--- type: [ADR, Guide, Reference, Report, Journal] status: [DRAFT, ACTIVE, DEPRECATED, ARCHIVED] owner: [Rolle] --- - Archivierung: Lösche nichts. Verschiebe veraltetes Wissen in
_archiveOrdner oder markiere es alsARCHIVED.