meldestelle/docs/01_Architecture/MASTER_ROADMAP_2026_Q1.md

type, status, owner, last_update

type	status	owner	last_update
Roadmap	ACTIVE	Lead Architect	2026-02-01

MASTER ROADMAP Q1 2026: "Operation Tracer Bullet"

Strategisches Ziel: Wir validieren die gesamte Architektur-Kette (Frontend -> Gateway -> Service -> DB) anhand des Ping-Service. Dieser Service dient als technischer Blueprint (Vorlage) für alle kommenden Fach-Services. Er muss "Production Ready" gehärtet sein, bevor wir Fachlichkeit implementieren.

Aktueller technischer Stand (01.02.2026):

• Build System: ✅ Grün (Gradle, Kotlin 2.3, Spring Boot 3.5.9, Spring Cloud 2025.0.1).
• Code-Basis: ✅ ping-service existiert, Delta-Sync implementiert.
• Infrastruktur: ✅ Docker Environment stabil (Valkey, Keycloak, Consul, Zipkin).
• Frontend: ✅ Web-App & Desktop-App (KMP), Login funktioniert, Sync-Logik vorhanden.

---

2. Arbeitsaufträge an die AGENTS (Phasenplan)

PHASE 1: Backend Hardening & Infrastructure (ABGESCHLOSSEN)

Ziel: Der Ping-Service läuft sicher, stabil und beobachtbar in der Docker-Umgebung.

👷 Agent: Senior Backend Developer

• Security Implementation: OAuth2 Resource Server & RBAC implementiert.
• Resilience: CircuitBreaker für /ping/enhanced aktiv.
• Observability: Actuator, Micrometer & Zipkin Tracing aktiv.
• Persistence: Flyway & Postgres Integration stabil.

🏗️ Agent: Infrastructure & DevOps

• Docker Environment: dc-infra, dc-backend, dc-gui stabil. Valkey als Redis-Ersatz integriert.
• Gateway Config: Routing /api/ping/** -> ping-service mit CircuitBreaker Fallback konfiguriert.

---

PHASE 2: Frontend Integration (ABGESCHLOSSEN)

Ziel: Das Frontend kann authentifiziert mit dem Backend sprechen.

🎨 Agent: KMP Frontend Expert

• HTTP Client Core: Ktor Client mit Auth & Error Handling.
• Authentication Flow: OIDC Login Flow (Keycloak) implementiert.
• UI Implementation: Debug-Screen für Pings vorhanden.

---

PHASE 3: Offline & Sync (IN PROGRESS)

Ziel: Datenkonsistenz auch bei Netzwerk-Verlust.

🤝 Joint Task Force (Backend & Frontend)

• Sync-Protokoll: PingEvent Contract definiert.
• Sync-Fix (CRITICAL): Typ-Mismatch beheben! Backend erwartet Long Timestamp, Frontend muss sicherstellen, dass kein String-Cursor gesendet wird.
• Web-App Sync: SQLDelight Integration vorbereitet.

---

3. Definition of Done (für Phase 1 & 2)

1. docker compose up startet den kompletten Stack fehlerfrei.
2. Frontend-User kann sich einloggen (Keycloak).
3. Frontend zeigt Daten vom ping-service an.
4. Beim Abschalten der DB zeigt der Service einen sauberen Fallback (CircuitBreaker offen).
5. In Zipkin ist der komplette Request-Trace (Frontend -> Gateway -> Service -> DB) sichtbar.

4. Next Steps (Q1/2026)

1. Sync-Fix: Typ-Sicherheit zwischen Frontend und Backend herstellen.
2. Entries Service: Beginn der Implementierung des ersten echten Fach-Services ("Nennungen").
3. System Hardening: Keycloak Production-Config (kein start-dev).