docs: add session log for infrastructure planning and roadmap updates

Added a detailed session log covering infrastructure setup for the Home-Server (Minisforum MS-R1) and reporting requirements. Updated `MASTER_ROADMAP_2026_Q1.md` with next steps, including PDF generation architecture evaluation and ARM64 hardware setup details.
This commit is contained in:
2026-02-06 13:48:51 +01:00
parent 041c619f84
commit c8d19f7911
3 changed files with 54 additions and 2 deletions
+14 -2
View File
@@ -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).
@@ -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.