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:
@@ -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.
|
||||
Binary file not shown.
Reference in New Issue
Block a user