meldestelle/docs/99_Journal/2026-02-06_Infrastructure_Planning.md

57 lines
2.5 KiB
Markdown

---
type: Journal
status: ACTIVE
owner: Curator
last_update: 2026-02-06
---
# 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) detailliert geplant und korrigiert. Zudem wurden Anforderungen für Reporting und Offline-Fähigkeit präzisiert.
## 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.
* **Architektur:** Dezentraler Microservice (um Resource-Bursts vom Core-System fernzuhalten).
* **Aktion:** Wurde in `MASTER_ROADMAP_2026_Q1.md` dokumentiert.
## 3. Infrastructure Setup (Minisforum MS-R1)
**Hardware Specs:**
* Model: Minisforum MS-R1
* CPU: 12 Kerne ARM (CP8180)
* RAM: bis 64GB LPDDR5
* Network: 2x 10G LAN
* Storage: NVMe + USB-SSD (Backup)
**Software Stack (Final Decision):**
1. **Base OS:** Debian 12 (Vendor Variant, vorinstalliert/angepasst für Treiber).
2. **Hypervisor:** **Incus** (Community Fork von LXD).
3. **Virtualization Strategy:**
* `infra-gitea` (LXC Container): Gitea + Actions Runner.
* *Vorteil:* Leichtgewichtig, Native ARM Builds via Runner.
* `docker-host-prod` (**VM**): Debian VM als Docker Host.
* *Grund:* Bessere Isolation, Kernel-Unabhängigkeit vom Host, keine "Nesting"-Probleme (OverlayFS/ZFS).
4. **CI/CD & Build Strategy:**
* **Tool:** `docker buildx` auf dem Gitea Runner.
* **ARM64 Images:** Werden **nativ** gebaut (rasend schnell, da Host = ARM).
* **x86_64 Images:** Werden via **QEMU-Emulation** gebaut (langsamer, aber funktional).
## 4. Networking & Offline-First
* **Remote Access:** Cloudflare Tunnel.
* **Local LAN (Offline):**
* Die "Main-Native-Desktop-App" (Meldestelle) fungiert als lokaler Anchor/Server im LAN.
* Clients (Zeitnehmer) verbinden sich via LAN.
* **Discovery:** Lokale DNS-Strategie oder Service Discovery (mDNS) notwendig, damit Clients den Server auch ohne Internet finden.
## 5. Backup
* **Strategie:** Automatisierte Snapshots/Backups auf externe **USB-SSD**.
* **Motto:** "Kein Backup, kein Mitleid."
## 6. Nächste Schritte
* Warten auf Hardware-Lieferung.
* Installation & Setup gemäß korrigiertem Plan (VM statt LXC für Docker).
* Vorbereitung der CI/CD Pipelines auf Multi-Architektur (Buildx/QEMU).