FAQ / Fehlersuche

23.1 „Die App startet nicht beim Doppelklick"

Nur beim ersten Start auf einem macOS-Rechner: Rechtsklick → Öffnen → Dialog bestätigen. Ursache ist der macOS-Gatekeeper, da die App noch nicht bei Apple notariell registriert ist (siehe § 20).

23.2 „Karte lädt keine Kacheln"

• Kein Internet + kein Offline-Cache → leer. Lösung: Online starten und Offline-Karte-Download für das Einsatzgebiet anstoßen.
• Offline-Modus versehentlich aktiv? In der Topbar das 🌐/💻-Symbol prüfen — sollte auf 💻 Desktop stehen (nicht auf Offline).

23.3 „Ich sehe meinen Sync-Peer nicht"

• Beide im gleichen Signaling-Modus? Öffentlich ↔ LAN vermischen sich nicht.
• Beide im gleichen WLAN (LAN-Modus)?
• Exakt gleiche Raum-ID (Groß-/Kleinschreibung zählt)?
• Firewall blockiert Port 47833 (LAN) oder WebRTC-UDP (öffentlich)?

23.4 „Update-Badge erscheint nicht"

• Nur in der ausgelieferten App aktiv, nicht in npm start.
• Repo-Einstellung in package.json ist rhs-mosbach/sarmission — muss ein echtes, aktives GitHub-Release sein.

23.5 „Einsatz-Uhr zählt zu viel"

• Nach App-Schließen/Öffnen darf keine Zeit zwischen den Sessions hinzukommen. Falls doch, liegt ein Bug vor → die App schreibt den „eingefrorenen" Elapsed-Stand beim Auto-Save. Check: userData/einsatz_state.json → Feld units[].einsatzElapsedSec.

23.6 „POA-Ranking erscheint mir falsch"

• POA wird gleichverteilt beim Anlegen berechnet (keine IPP-Gewichtung in v1).
• Manuelles Überschreiben der POA pro Gebiet ist derzeit nicht über UI möglich — Abschluss mit passendem POD ist der reguläre Update-Weg.

23.7 „Bluetooth-/Seriell-GPS findet nichts"

• macOS-Berechtigung: Systemeinstellungen → Datenschutz → Bluetooth bzw. USB-Geräte → SARmission zulassen.
• Bei Seriell: Baudrate im Gerät-Handbuch prüfen. Standard ist 4800, manche moderne Empfänger nutzen 9600 oder 38400.

23.8 „Snapshot-Restore-Dialog ist leer"

• Tritt auf wenn noch kein 5-Minuten-Intervall vergangen ist oder die Einsatz-Daten seit dem ersten Start nicht verändert wurden.
• Alternativ den snapshots-Ordner manuell öffnen: Menü → Einsatz → Snapshot-Ordner öffnen ….

23.9 „Welche Kartenlayer gibt es?"

• Topo (OpenTopoMap, Default)
• BKG Behörden-Topo (TopPlusOpen, ab v2.2.0) — amtliche Topographie-Karte mit Detail-Stand der deutschen Landesvermessungen, Optik 1:25 000. Datenquelle: Bundesamt für Kartographie und Geodäsie.
• BKG DOP / Orthofoto (basemap.de, ab v2.11.0) — amtliches Luftbild Deutschland, frei zugänglich. Nutze diese Variante für Vegetationsbewertung und Detailaufklärung.
• OSM (OpenStreetMap Standard)
• Satellit (Esri World Imagery)
• Hybrid (Satellit + OSM-Beschriftung 55 % Opazität)
• OSM-DE (deutsche OSM-Stilvariante)

Topbar-Topo-Button zyklusiert durch alle sieben Basis-Layer.

Zusätzlich (ab v2.11.0) Overlays: ALKIS Baden-Württemberg, VG250-Verwaltungsgrenzen, BfN-Naturschutzgebiete — siehe Kapitel 28.

23.10 „Ich habe versehentlich gelöscht"

1. Cmd + Z — stellt den letzten Zustand wieder her.
2. Falls der Undo-Puffer bereits leer: Menü → Einsatz → Snapshot wiederherstellen … wählt einen Sicherungspunkt bis zu 2,5 Stunden in die Vergangenheit.
3. Letzte Rettung: eine per Hand gespeicherte .rhs-Datei laden.

---