diff --git a/docs/01_Architecture/MASTER_ROADMAP_2026_Q1.md b/docs/01_Architecture/MASTER_ROADMAP_2026_Q1.md index ad779618..ce73fe56 100644 --- a/docs/01_Architecture/MASTER_ROADMAP_2026_Q1.md +++ b/docs/01_Architecture/MASTER_ROADMAP_2026_Q1.md @@ -2,7 +2,7 @@ type: Roadmap status: ACTIVE owner: Lead Architect -last_update: 2026-02-01 +last_update: 2026-02-06 --- # MASTER ROADMAP Q1 2026: "Operation Tracer Bullet" @@ -10,7 +10,7 @@ last_update: 2026-02-01 **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):** +**Aktueller technischer Stand (06.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). @@ -65,3 +65,15 @@ Wir validieren die gesamte Architektur-Kette (Frontend -> Gateway -> Service -> ## 4. Next Steps (Q1/2026) 1. **Entries Service:** Beginn der Implementierung des ersten echten Fach-Services ("Nennungen"). 2. **System Hardening:** Keycloak Production-Config (kein `start-dev`). +3. **Reporting / Printing:** (Vorgemerkt) + * Anforderung: PDF-Generierung für Startlisten, Ergebnislisten, Dressur-Protokolle (personalisiert). + * Architektur-Entscheidung ausstehend: Dezentral (pro Service) vs. Zentraler Reporting-Service. + * Technologie-Evaluierung: JasperReports, Thymeleaf + Flying Saucer, etc. +4. **Infrastructure Setup (Home-Server):** + * Hardware: Minisforum MS-R1 (ARM64). + * OS: Debian 12 (Bookworm). + * Hypervisor: **Incus** (LXC/LXD Fork) für Container & VMs. + * Services: + * `infra-gitea` (LXC): Gitea + Actions Runner (ARM64 Native Builds). + * `docker-host-prod` (LXC, nesting=true): Docker Host für Meldestelle-Stack. + * Networking: Cloudflare Tunnel (kein Port-Forwarding). diff --git a/docs/99_Journal/2026-02-06_Infrastructure_Planning.md b/docs/99_Journal/2026-02-06_Infrastructure_Planning.md new file mode 100644 index 00000000..280482f0 --- /dev/null +++ b/docs/99_Journal/2026-02-06_Infrastructure_Planning.md @@ -0,0 +1,40 @@ +# Session Log: Infrastructure Planning & Reporting Requirements + +**Datum:** 06.02.2026 +**Teilnehmer:** User (Owner), Lead Architect, DevOps Engineer + +## 1. Zusammenfassung +In dieser Session wurde die zukünftige Infrastruktur für den Home-Server (Minisforum MS-R1) geplant und eine Anforderung für das Reporting-System (PDF-Generierung) aufgenommen. + +## 2. Reporting / Printing (Vorgemerkt) +Der User benötigt eine Lösung zum Generieren von personalisierten PDFs (Startlisten, Ergebnislisten, Protokolle). +* **Status:** Als "Next Step" in die Roadmap aufgenommen. +* **Offene Fragen:** Architektur (Zentral vs. Dezentral), Technologie-Stack. +* **Aktion:** Wurde in `MASTER_ROADMAP_2026_Q1.md` dokumentiert. + +## 3. Infrastructure Setup (Minisforum MS-R1) +Der User hat neue Hardware bestellt (ARM64 Architektur). + +**Hardware Specs:** +* CPU: 12 Kerne ARM (CP8180) +* RAM: bis 64GB LPDDR5 +* Network: 2x 10G LAN + +**Entscheidung: "The Incus Way"** +Da Proxmox auf ARM experimentell ist, wurde folgender Stack beschlossen: +1. **Base OS:** Debian 12 (Bookworm). +2. **Hypervisor:** **Incus** (Community Fork von LXD). +3. **Container-Strategie:** + * `infra-gitea` (LXC): Gitea + Actions Runner (Native ARM Builds). + * `docker-host-prod` (LXC mit nesting): Docker Host für den Meldestelle-Stack. +4. **Networking:** Cloudflare Tunnel. + +**Vorteile:** +* Native Performance auf ARM. +* Snapshots & Backups (via ZFS/Btrfs). +* Saubere Trennung von Infrastruktur (Gitea) und Applikation (Docker). + +## 4. Nächste Schritte +* Warten auf Hardware-Lieferung. +* Installation & Setup gemäß Plan. +* Einrichtung der CI/CD Pipeline (Gitea Actions) für ARM-Builds. diff --git a/docs/Release-Proxmox-Virtual-Environment-9-1-20251119-de.pdf b/docs/Release-Proxmox-Virtual-Environment-9-1-20251119-de.pdf new file mode 100644 index 00000000..aa43a2a2 Binary files /dev/null and b/docs/Release-Proxmox-Virtual-Environment-9-1-20251119-de.pdf differ