PKR-Lab

Homeserver Dashboard (iOS)

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ios/index.md

Homeserver Dashboard (iOS)

SwiftUI-App für iPhone und iPad. Sie zeigt Alarme, Host-Metriken und Dienststatus des Capulus-Homelabs, steuert Helligkeit und Wake/Shutdown der Server und bietet einen zweiten Modus „Alltag“ mit Wetter, Rhein-Pegel, Tankstellenpreisen und Nachrichten.

Repository: pkr-lab/capulus-ios. Das Backend ist carplay-api im TECH-Cluster von capulus-core (Dienst, Hintergründe). Trotz des Namens der API enthält die App kein CarPlay: Szene, Entitlement und CarPlay.framework sind entfernt.


Einordnung

flowchart LR
    app["Homeserver Dashboard (iOS)"] -->|"HTTPS + Bearer-Token, Root-CA gepinnt"| api["carplay-api (TECH-Cluster)"]
    app -->|"HTTPS über Tailscale, Root-CA gepinnt"| wol["WoL-Agent auf dem Banana Pi (Vereinsheim)"]
    app -->|"HTTPS, System-Trust"| ext["Open-Meteo, Pegelonline, Tankerkönig, Tagesschau, Heise, WELT"]
    api --> ntfy["ntfy (Alarme)"]
    api --> vm["VictoriaMetrics (Host-Metriken, Traefik-Rate)"]
    api --> kuma["Uptime-Kuma (Dienststatus)"]
    api --> power["power-agent (Homeserver: Helligkeit, Shutdown, WoL)"]
    api --> gh["ConfigMap updates.json (befüllt vom github-release-watcher)"]
Teil Wo Doku
App dieses Repo diese Seiten
Backend carplay-api capulus-core carplay-api
power-agent (Host-Dienst) capulus-ansible Rolle power_agent
WoL-Agent auf dem Banana Pi capulus-ansible Vereinsheim-Alarmmonitor, Rolle banana_pi_kiosk
Root-CA Resources/homeserver-root-ca.pem (Kopie von pki/homeserver-root-ca.pem in capulus-core) Internes TLS
Design Farben und Glas-Karten aus der Website EDV-Kretzer

Funktionen

Zwei Modi, umschaltbar mit dem Segmentschalter „PKR-Lab / Alltag“ oben. Die Wahl bleibt gespeichert (@AppStorage("dashboardMode"), Standard PKR-Lab).

Modus Tab Inhalt Seite
PKR-Lab Übersicht Hosts, Dienststatus, Dienst-Aktivität, Updates Übersicht und Alerts
PKR-Lab Steuerung Helligkeit, Wake/Shutdown, Vereinsheim-PC Steuerung
PKR-Lab Alerts aktive Alarme aus ntfy Übersicht und Alerts
Alltag Dashboard Wetter heute und morgen, Rhein-Pegel Andernach, Links zu den selbst gehosteten Diensten Alltag-Modus
Alltag Tankstellen drei feste Stationen plus nächste Station ohne Konzernmarke Alltag-Modus
Alltag News je eine Top-Meldung von Tagesschau, Heise und WELT Alltag-Modus
beide Einstellungen (Zahnrad auf Steuerung und Tankstellen) Tokens und API-Key im Keychain Konfiguration

Die Verbindung zum Homeserver (TLS-Pinning, Bearer-Token, Erreichbarkeitsanzeige) beschreibt Verbindung und Sicherheit.


Aufbau des Codes

capulus-ios/
├── project.yml                      XcodeGen-Spezifikation (Quelle der Wahrheit)
├── Resources/homeserver-root-ca.pem Root-CA, wird als Bundle-Ressource eingebunden
├── .github/workflows/               ci, codeql, commitlint, release
└── HomeserverDashboard/
    ├── HomeserverDashboardApp.swift @main, öffnet RootTabView
    ├── Views/                       SwiftUI-Ansichten (13 Dateien)
    ├── ViewModels/                  DashboardViewModel, PowerViewModel
    ├── Models/                      Codable-Modelle
    ├── Services/                    API-Clients, Keychain, Standort, Erreichbarkeit
    ├── Utilities/                   Constants, Theme, Formatter, MTLSDelegate
    └── Assets.xcassets/             App-Icon, Akzentfarbe

.xcodeproj und Info.plist werden nicht eingecheckt: xcodegen generate erzeugt beide aus project.yml und überschreibt Handänderungen.

Datei Aufgabe
Views/RootTabView.swift Modus-Schalter und Tab-Leiste, dunkles Farbschema erzwungen
Views/HomeView.swift Übersicht inklusive ServiceActivityCard, UpdatesCard, OfflineBanner
Views/HostCardsView.swift, StatusGridView.swift, AlertsGridView.swift, AlertsView.swift, DetailView.swift Karten und Detail-Sheet
Views/PowerView.swift Helligkeit, Wake/Shutdown, Homeserver-Bestätigungs-Sheet, Vereinsheim-WoL
Views/AlltagDashboardView.swift, TankstellenView.swift, NewsView.swift Alltag-Modus
Views/SettingsView.swift drei Keychain-Einträge
ViewModels/DashboardViewModel.swift 30-Sekunden-Schleife für GET /api/dashboard, Updates
ViewModels/PowerViewModel.swift Aktionen für Helligkeit, Wake, Shutdown, Vereinsheim-WoL
Services/HomeserverAPIClient.swift Zugriffe auf carplay-api
Services/RemoteWolAgentClient.swift Zugriff auf den WoL-Agent
Services/KeychainService.swift Keychain-Zugriff
Services/TailscaleConnectivity.swift Erreichbarkeitsanzeige
Services/LocationManager.swift Standort für die Tankstellen-Suche
Services/WeatherAPIClient.swift, PegelAPIClient.swift, TankerkoenigAPIClient.swift, NewsAPIClient.swift externe Datenquellen
Utilities/MTLSDelegate.swift Root-CA-Pinning
Utilities/Constants.swift alle Adressen und festen Werte
Utilities/Theme.swift, ColorHelper.swift, FormatterHelper.swift Design-Token, Statusfarben, Formatierung

Alle Dateipfade beziehen sich auf pkr-lab/capulus-ios.

Design

Farben, Typografie und Glas-Karten stammen aus EDV-Kretzer (css/style.css): Marineblau #0f3a5d und Rot #d32f2f auf einem fast schwarzen Verlauf #0a0e27 → #0d1230. Die Werte stehen in Utilities/Theme.swift. Die App erzwingt den Dark Mode, weil die Marke keine helle Variante hat.


Seiten

Seite Inhalt
Installation Voraussetzungen, Projekt erzeugen, Token einrichten, auf Gerät starten
Konfiguration Adressen, Keychain-Einträge, Projekteinstellungen
Nutzung Bedienung in Kurzform
Übersicht und Alerts Hosts, Dienste, Aktivität, Updates, Alarme
Steuerung Helligkeit, Wake, Shutdown, Vereinsheim-PC
Alltag-Modus Wetter, Pegel, Dienste-Links, Tankstellen, News
Verbindung und Sicherheit TLS-Pinning, Token, Keychain, Erreichbarkeit
Debugging und Fehlersuche Fehlermeldungen, Checkliste, Debugging in Xcode
Entwicklung Build, CI, Tests, Erweiterung
Releases Release-Prozess

Fehlersuche

Fehlermeldungen, Checkliste und Debugging in Xcode: Debugging und Fehlersuche. Funktionsbezogen: Übersicht und Alerts, Steuerung, Alltag-Modus, Verbindung und Sicherheit.