meldestelle/docs/01_Architecture/MASTER_ROADMAP.md
Stefan Mogeritsch 78cda88ae6
All checks were successful
Build and Publish Docker Images / build-and-push (., backend/infrastructure/gateway/Dockerfile, api-gateway, api-gateway) (push) Successful in 9m22s
Build and Publish Docker Images / build-and-push (., backend/services/ping/Dockerfile, ping-service, ping-service) (push) Successful in 8m53s
Build and Publish Docker Images / build-and-push (., config/docker/caddy/web-app/Dockerfile, web-app, web-app) (push) Successful in 2m34s
Build and Publish Docker Images / build-and-push (., config/docker/keycloak/Dockerfile, keycloak, keycloak) (push) Successful in 2m10s
infra: integrate Keycloak monitoring, update alertmanager config, and finalize docs cleanup
Added a Prometheus scrape job for Keycloak metrics. Updated Alertmanager to use Mailpit for local testing. Completed documentation consolidation and marked cleanup-related tasks as done in the master roadmap.
2026-03-05 13:16:43 +01:00

3.2 KiB

type status owner last_update
Roadmap ACTIVE Lead Architect 2026-03-05

MASTER ROADMAP: "Operation Self-Sovereignty"

Strategisches Ziel: Vollständige Migration auf Self-Hosted Infrastruktur (Gitea, Pangolin, Zora) und Konsolidierung der Dokumentation. Der Fokus liegt auf Datensouveränität, Offline-Fähigkeit und einer sauberen, aktuellen Wissensbasis.

Aktueller technischer Stand (05.03.2026):

  • Infrastruktur: "Zora" (MS-R1, ARM64) ist live. Gitea & Registry laufen.
  • Networking: Pangolin Tunnel ersetzt Cloudflare.
  • CI/CD: Gitea Actions mit ARM64-Runner (VM 102) aktiv. Docker-Publish Pipeline grün.
  • Code-Basis: Backend (Java 25), Frontend (Kotlin/JS) bauen sauber auf ARM64.
  • Dokumentation: Konsolidiert und aufgeräumt.

1. Arbeitsaufträge an die AGENTS (Phasenplan)

PHASE 1: Documentation Cleanup (ABGESCHLOSSEN)

Ziel: Eine einzige, vertrauenswürdige Quelle der Wahrheit (SSOT) schaffen.

🧹 Agent: Curator

  • Archivierung: Veraltete Docs (Cloudflare, GitHub-Workflows, alte Roadmaps) nach docs/_archive/ verschoben.
  • Konsolidierung: Zora_System_Architektur.md als zentrale Infrastruktur-Doku etablieren.
  • Struktur: docs/ Ordner aufräumen (unnötige Root-Files in Unterordner).
  • Index: README.md im Root als Einstiegspunkt aktualisieren.

PHASE 2: Infrastructure Hardening (ABGESCHLOSSEN)

Ziel: Stabilisierung der neuen Self-Hosted Umgebung.

🐧 Agent: DevOps Engineer

  • Keycloak Fix: Verbindungsprobleme innerhalb des Docker-Netzwerks (meldestelle-host) behoben (Alias auth.mo-code.at).
  • Backup Strategy: Automatisierte Backups für Gitea & Datenbanken auf Zora eingerichtet (config/scripts/backup.sh).
  • Monitoring: Prometheus/Grafana Dashboard für Zora (System Stats, Docker Container) finalisiert (dc-ops.yaml).
  • Deployment: Git-basiertes Deployment-Skript (config/scripts/deploy.sh) erstellt.

PHASE 3: Feature Development (ON HOLD)

Ziel: Neuausrichtung der Fachlichkeit.

🏗️ Agent: Lead Architect & Domain Expert

  • Domain Analysis: Workshop mit dem Fachexperten zur Neudefinition der Anforderungen.
  • Feature Roadmap: Erstellung eines neuen Plans basierend auf den Ergebnissen.
  • Entries Service: Pausiert bis zur Klärung der Anforderungen.

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

  1. docs/ Root enthält nur noch essentielle Einstiegspunkte (README.md, MASTER_ROADMAP.md).
  2. Alle veralteten Dokumente sind im _archive oder gelöscht.
  3. Die Zora_System_Architektur.md ist korrekt in docs/07_Infrastructure/ eingeordnet.
  4. Ein neuer Entwickler findet sich sofort zurecht.
  5. Keycloak ist intern erreichbar.
  6. Backups laufen automatisch.

3. Wichtige Referenzen

  • Infrastruktur: docs/07_Infrastructure/Zora_System_Architektur.md
  • Deployment Guide: docs/07_Infrastructure/Guides/Setup_Git_Deployment_Zora.md
  • Backup Guide: docs/07_Infrastructure/Guides/Setup_Backup_Zora.md
  • CI/CD: .gitea/workflows/docker-publish.yaml
  • Projekt-Protokoll: docs/04_Agents/Playbooks/