PKR-Lab

Alltag-Modus

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ios/alltag-modus.md

Alltag-Modus

Der zweite Modus der App („Alltag“ im Segmentschalter oben): Wetter, Rhein-Pegel, Links zu den selbst gehosteten Diensten, Tankstellenpreise und Nachrichten. Der Modus braucht weder carplay-api noch den Homeserver. Er nutzt öffentliche APIs direkt vom Gerät.

Code: AlltagDashboardView.swift, TankstellenView.swift, NewsView.swift, Services/WeatherAPIClient.swift, PegelAPIClient.swift, TankerkoenigAPIClient.swift, NewsAPIClient.swift, LocationManager.swift, Utilities/Constants.swift

Alle Werte (Standort, Stationen, Quellen) sind in Constants.swift fest eingetragen, siehe Konfiguration. Alle Aufrufe laufen ohne Authentifizierung, außer Tankerkönig (API-Key aus dem Keychain). Keine der Anfragen nutzt das Root-CA-Pinning und keine beeinflusst die Erreichbarkeitsanzeige des PKR-Lab-Modus.


Dashboard (Wetter, Pegel, Dienste)

Beim Öffnen und beim Ziehen (Pull-to-Refresh) lädt die Ansicht Wetter und Pegel gleichzeitig.

Wetter

Rhein-Pegel

Pegelonline (/stations/<UUID>/W/currentmeasurement.json): aktueller Wasserstand in cm und die Einstufung (low Niedrig, normal Normal, high Hoch, sonst der Rohwert oder „—“). Der Wasserstand ist fest an die Station „Rhein-Pegel Andernach“ gebunden.

Dienste

Eine Kachel je selbst gehostetem Dienst (Nextcloud, Immich, Vaultwarden, Paperless-ngx, n8n, Wiki.js, Zammad). Tippen öffnet https://<host> im System-Browser. Die Hosts liegen in *.prod.homeserver und *.tech.homeserver, siehe Domain-Tiers. Der Browser des Geräts braucht die Root-CA im Trust Store und Zugang zum Heimnetz oder Tailnet (Internes TLS). Die Kacheln prüfen die Erreichbarkeit nicht.


Tankstellen

Der Tab zeigt zwei Karten.

Tankstellen (fest): Preise für drei Stationen mit fester Tankerkönig-ID (Andernach, Plaidt, Mülheim-Kärlich) über prices.php. Pro Station Super (E5) und Super E10 mit drei Nachkommastellen in €. Hat die Station nicht den Status open, steht „Geschlossen“. Fehlt ein Preis, steht „—“.

Nächste (ohne Shell/Aral): list.php mit dem Standort des Geräts, Umkreis 10 km, nach Entfernung sortiert. Die erste Station, deren Marke nicht in der Ausschlussliste (Shell, Aral, Esso, Agip, Eni) steht, wird angezeigt, mit Adresse, Entfernung in km und Preisen. Findet sich keine: „Keine passende Station im Umkreis von 10 km gefunden.“

Ablauf Standort

flowchart TD
    A[Tab öffnet] --> B{Standortfreigabe?}
    B -->|nicht entschieden| C[iOS-Abfrage: Beim Verwenden]
    B -->|abgelehnt| X[Fehler: Standortzugriff wurde nicht erlaubt]
    B -->|erteilt, ungefähr| D[Temporär genaue Freigabe Schlüssel TankstellenSuche anfragen]
    B -->|erteilt, genau| E[requestLocation]
    C --> E
    D --> E
    E --> F[list.php mit lat, lng, rad=10]
    F --> G[erste Station ohne ausgeschlossene Marke]

Der Standort wird mit 100 m Genauigkeit angefragt. Bei nur ungefährer Freigabe fragt die App temporär die genaue Position an (Text aus NSLocationTemporaryUsageDescriptionDictionary), weil eine nahe Station sonst knapp außerhalb des Radius liegen könnte.

API-Key

Beide Karten brauchen den Tankerkönig-API-Key aus dem Keychain. Eingabe über das Zahnrad auf dem Tab (Tankerkönig API-Key), kostenlos registrierbar auf creativecommons.tankerkoenig.de. Ohne Key zeigt jede Karte „Kein Tankerkönig-API-Key hinterlegt — in den Einstellungen ergänzen.“


News

Je eine Karte pro Quelle mit der obersten Meldung: Tagesschau (JSON-API api2u/homepage, erste Meldung mit erstem Satz und Link), Heise (Atom-Feed) und WELT (RSS-Feed). Bei den Feeds liest ein XMLParser den ersten item bzw. entry (Titel, Link, Beschreibung). Die Zusammenfassung wird von HTML-Tags und Entities (&amp;, &quot;, …) bereinigt und auf 160 Zeichen gekürzt. Tippen öffnet den Link im Browser. Jede Quelle lädt unabhängig, ein Ausfall betrifft nur die eigene Karte.


Randfälle


Debugging und Fehlersuche

Meldung (in der Karte) Ursache Lösung
Wetter konnte nicht geladen werden. Open-Meteo antwortete nicht mit HTTP 200 Netzwerk prüfen, curl "https://api.open-meteo.com/v1/forecast?latitude=50.4205&longitude=7.4061&daily=temperature_2m_max&forecast_days=2"
Systemtext (zum Beispiel „The data couldn’t be read because it is missing.“) im Wetterbereich Antwort ließ sich nicht decodieren (Feldänderung bei Open-Meteo) Antwort mit curl prüfen, WeatherForecast.swift anpassen
Pegelstand konnte nicht geladen werden. Pegelonline nicht erreichbar oder HTTP ≠ 200 curl https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/<UUID>/W/currentmeasurement.json; Station evtl. außer Betrieb
Pegel zeigt „—“ als Einstufung stateMnwMhw fehlt in der Antwort normal bei einigen Stationen
Kein Tankerkönig-API-Key hinterlegt — in den Einstellungen ergänzen. Key fehlt im Keychain Zahnrad → Key speichern
Tankerkönig antwortete mit HTTP <n>. API-Fehler oder Rate-Limit curl mit eigenem Key, Nutzungsbedingungen beachten
Antwort von Tankerkönig konnte nicht gelesen werden. JSON-Format weicht ab Antwort prüfen, FuelModels.swift
Meldung der API (message), „Tankpreise konnten nicht geladen werden.“ oder „Tankstellen in der Nähe konnten nicht geladen werden.“ ok: false in der Antwort, meist ungültiger Key Key prüfen oder neu registrieren
Standortzugriff wurde nicht erlaubt — in den iOS-Einstellungen für diese App aktivieren. Standortfreigabe abgelehnt iOS-Einstellungen → Datenschutz → Ortungsdienste → Homeserver Dashboard
Keine Station in der Nähe gefunden. noch nicht geladen oder keine Treffer Ziehen zum Aktualisieren
Keine passende Station im Umkreis von 10 km gefunden. alle Treffer sind ausgeschlossene Marken excludedBrands oder Radius in Constants.swift anpassen
Nicht verfügbar (News) Quelle nicht erreichbar oder Format geändert curl auf die URL aus Constants.News; leerer Feed erzeugt dieselbe Meldung
Keine Meldung verfügbar (News) Laden beendet, aber keine Meldung und kein Fehler Ziehen zum Aktualisieren
Dienst-Kachel öffnet Seite nicht Gerät kann *.homeserver nicht auflösen oder Root-CA nicht vertraut Tailscale und DNS prüfen, Root-CA im System installieren

Alle Fehler sind im Alltag-Modus sichtbar (rote Zeilen), weil die Ansichten die Fehler der Services anzeigen. Zur Diagnose im Debugger siehe Debugging.

Allgemeines: Debugging und Fehlersuche.