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.