Nutzung
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ios/nutzung.md
Nutzung
Code: Views/RootTabView.swift
Aufbau der Bedienung
Oben sitzt der Schalter PKR-Lab / Alltag. Er wählt die Tab-Leiste und bleibt über App-Neustarts gespeichert.
| Modus | Tab | Zweck | 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 | Übersicht und Alerts |
| Alltag | Dashboard | Wetter, Rhein-Pegel, Dienste-Links | Alltag-Modus |
| Alltag | Tankstellen | Preise, nächste Station | Alltag-Modus |
| Alltag | News | Top-Meldungen | Alltag-Modus |
Gesten und Bedienelemente:
- Ziehen nach unten auf jedem Tab lädt die Daten neu. Im Modus PKR-Lab lädt die Übersicht zusätzlich alle 30 Sekunden automatisch.
- Tippen auf einen Monitor oder Alarm öffnet ein Detail-Sheet, Fertig schließt es.
- Zahnrad oben rechts (nur Tabs Steuerung und Tankstellen) öffnet die Einstellungen für Tokens und API-Key, siehe Konfiguration.
- Gelber Hinweis auf der Übersicht: Homeserver nicht erreichbar, es gilt der letzte bekannte Stand.
- Die App läuft nur im dunklen Farbschema. Auf dem iPhone nur im Hochformat, auf dem iPad in allen Ausrichtungen, ohne Split View.
Typische Abläufe
Zustand prüfen
Modus PKR-Lab → Übersicht. Grüne Prozentwerte und UP heißen unauffällig. Rote Karten oder DOWN verweisen auf ein Problem: Tippen auf den Monitor öffnet das Detail (Ping, Uptime, letzter Check). Die Ursachensuche steht in Debugging.
Alarme ansehen
Tab Alerts. Rote Alarme sind critical, orange warning. Alarme der letzten Stunden (Standard 12 h) bleiben sichtbar, danach verschwinden sie.
Worker aufwecken oder ausschalten
Tab Steuerung → Karte des Workers. Aufwecken gilt für offline, Ausschalten für online. Der Status zieht nach, sobald der Host Metriken liefert. Details: Steuerung.
Homeserver herunterfahren
Nur in Ausnahmefällen: Das nimmt Kubernetes, ArgoCD und alle Dienste mit, und das Wiedereinschalten geht nur vor Ort. Der Bestätigungscode ist derselbe wie für ArgoCD.
Tankstellen im Alltag
Modus Alltag → Tankstellen. Beim ersten Mal fragt iOS nach der Standortfreigabe. Ohne API-Key bleibt die Seite leer, siehe Alltag-Modus.
Bekannte Lücken
- Keine Tests: Das Schema
HomeserverDashboardhat keine Test-Targets (testTargets: []inproject.yml). Am meisten würden Codable-Tests der Modelle gegen echtecarplay-api-Antworten bringen. - Keine Push-Benachrichtigungen: Die App ruft nur ab. Alarme kommen per ntfy aufs Telefon (Telefon-Alarm).
- Feste Standorte und Stationen: Wetter, Pegel und drei Tankstellen sind im Code festgelegt.
- Platzhalter-Bundle-ID:
com.yourname.homeserver-dashboardinproject.yml. Bleibt bewusst: Ein Wechsel ändert die Keychain-Zugriffsgruppe, gespeicherte Tokens wären danach nicht mehr lesbar und müssten neu eingegeben werden. - Swift-Concurrency: gebaut mit Swift-Sprachmodus 5 (
SWIFT_VERSION: "5.0"), nicht im Strict-Modus von Swift 6. - App Store: Datenschutzerklärung und Screenshots für TestFlight-Extern oder App Store sind nicht Teil des Repos. TODO: prüfen, ob die App über TestFlight verteilt wird.
Debugging und Fehlersuche
Kurzdiagnose, wenn „nichts geht“:
- Gelber Hinweis auf der Übersicht? Dann zuerst Netzwerk, Tailscale und Token prüfen.
- Zeigt der Alltag-Modus Daten? Dann ist die App in Ordnung, und das Problem liegt bei
carplay-apioder dem Zugang dorthin. - Details und Fehlertabellen: Debugging und Fehlersuche.