Mobile App (Android & iOS)

Die Florian-App ist der native Begleiter für Android und iOS. Sie verbindet sich mit Ihrer eigenen Florian-Instanz (selbst gehostet, wie gewohnt — es gibt keine Cloud dazwischen) und bringt die Arbeitsabläufe aufs Handy, die unterwegs wirklich zählen: Inventur mit dem eingebauten Barcode-Scanner, Geräteverwaltung, Dienstplan, Mitgliederliste, Jugendfeuerwehr und die eigene Datenpflege inklusive Profilbild.

Rechte bleiben Rechte: Die App nutzt dasselbe Rollen- und Rechtesystem wie die Web-Oberfläche. Der Server prüft jede Aktion serverseitig; die App blendet zusätzlich alles aus, wofür das angemeldete Konto keine Berechtigung hat. Ein Jugendfeuerwehrmitglied sieht also z. B. nur die eigenen Daten und die freigegebenen Bereiche — exakt wie im Browser.

Verbindung einrichten

1. Server-Adresse eingeben: Beim ersten Start fragt die App nach der Adresse Ihrer Florian-Instanz (z. B. http://feuerwehr-server:8080 im Gerätehaus-Netz oder Ihre HTTPS-Adresse, falls die Instanz von außen erreichbar ist).
2. Anmelden: Mit dem gewohnten Florian-Benutzerkonto (Benutzername + Passwort). Die Sitzung wird sicher als Cookie gespeichert — wie im Browser, inklusive Sitzungs-Ablauf nach der in den Einstellungen konfigurierten Zeit.

Inventur mit dem Scanner — der Kern der App

Der eingebaute Scanner liest Barcodes und QR-Codes direkt mit der Kamera — die Erkennung läuft vollständig auf dem Gerät (Google ML Kit bzw. Apple Vision), es werden keine Bilder oder Codes an Dritte übertragen.

Ablauf einer Inventur:

1. Inventur öffnen oder anlegen (Bereich „Inventur", Recht Inventur: Erstellen für neue).
2. „Scannen" antippen — die Kamera öffnet sich.
3. Gerät scannen: Die App erkennt den Code, sucht das Gerät und markiert es als vorhanden. Der Fortschritt („x von y erfasst") aktualisiert sich sofort, danach geht es direkt mit dem nächsten Scan weiter — Scannen im Sekundentakt.
4. Unbekannter Code? Die App meldet es und bietet die manuelle Suche an.
5. Abweichungen erfassen: Jedes Gerät lässt sich manuell auf defekt oder fehlt setzen.
6. Abschließen (Recht Inventur: Verwalten) — die Inventur wird festgeschrieben.

Erkannt werden alle Kennungen eines Geräts: Inventarnummer, Seriennummer, Inventarcode und die in Florian gedruckten QR-Etiketten (auch deren Fallback-Kennung).

Geräteverwaltung

Die Geräteliste ist durchsuchbar; jedes Gerät zeigt seine Details, kann (mit entsprechendem Recht) bearbeitet, neu angelegt oder gelöscht werden. Der Schnellzugriff „Scannen" öffnet ein gescanntes Gerät direkt.

Zum schnellen Anlegen benötigen Sie Geräte: Ansehen und Geräte: Anlegen. Nur dann erscheint die Plus-Taste in der nativen Geräteliste. Fehlt eines dieser Rechte, zeigt auch ein direkt geöffnetes Anlegeformular einen Berechtigungshinweis statt bearbeitbarer Felder. Die Rechte zum Bearbeiten und Löschen bestehender Geräte bleiben davon getrennt; der Server prüft jede Schreibanfrage zusätzlich.

Eigene Daten & Profilbild (Selbstverwaltung)

Unter „Mein Profil" pflegt jedes angemeldete Mitglied die eigenen Daten — mit denselben Regeln wie in der Web-Selbstverwaltung (siehe Selbstverwaltung): Kontakt- und Adressdaten wirken sofort, Bankdaten durchlaufen die Freigabe, Stammdaten bleiben der Verwaltung vorbehalten.

Profilbild: Foto direkt mit der Kamera aufnehmen oder aus der Galerie wählen. Das Bild wird serverseitig auf 512 px verkleinert und neu kodiert — dabei werden sämtliche Metadaten entfernt (auch GPS-Positionen, relevant besonders bei Jugendlichen). Das Profilbild erscheint anschließend überall in Florian, z. B. in der Mitgliederliste der Web-Oberfläche. Entfernen ist jederzeit möglich.

Weitere Module über das Webportal

Über „Webportal“ öffnet die App die Florian-Web-Oberfläche Ihrer Instanz in einer eingebetteten Ansicht und versucht, Ihre bestehende Anmeldung zu übernehmen. Dort erreichen Sie weitere für Ihr Konto freigegebene Module, etwa Einsatzberichte, Atemschutz, Lehrgänge, Prüffristen, Beitragswesen, Statistik und Verwaltung.

Dieser Webzugang benötigt eine Verbindung zum Server. Die offline unterstützten Abläufe und ihre Warteschlange sind unten beschrieben. Scheitert die Übergabe der Anmeldung oder das Laden der Seite, zeigt die App einen Hinweis mit „Erneut versuchen“.

Offline-Verhalten

• Netzstatus: Im Entwicklungsstand vom 24. Oktober 2026 beobachtet die App die Geräteverbindung ohne zusätzliche HTTP-Testabfragen an Google oder andere Internetdienste. Unter Android wird eine vom Betriebssystem ausdrücklich gemeldete fehlende Internet-Erreichbarkeit weiterhin berücksichtigt. Eine Geräteverbindung bestätigt noch keine erfolgreiche Verbindung zum Florian-Server. Diese Änderung ist noch nicht als native App veröffentlicht.

• Lesen: Geräte-, Inventur-, Mitglieder- und Dienstplandaten werden lokal zwischengespeichert und bleiben ohne Verbindung einsehbar.

• Abgewiesener Zugriff: Im Entwicklungsstand vom 24. Oktober 2026 sperrt eine abgewiesene Anmeldung oder Berechtigung (HTTP 401/403) die betroffene zwischengespeicherte Abfrage sofort. Die Sperre wird zusätzlich getrennt gespeichert. Nach erfolgreichem Speichern bleibt sie auch nach einem App-Neustart bestehen, selbst wenn das lokale Löschen fehlschlägt. Andere Abfragen und ausstehende Vorgänge bleiben davon getrennt.

  Erst eine danach gestartete erfolgreiche Serverabfrage mit erfolgreich erneuertem Cache und erfolgreich aufgehobener gespeicherter Sperre gibt diese Daten wieder für den lokalen Rückgriff frei. Frische Serverdaten können trotz eines Speicherfehlers angezeigt werden.

  Reicht der begrenzte Sperrspeicher nicht aus oder ist er nicht zuverlässig lesbar, bleiben alle lokalen Lesedaten bis zur erfolgreichen Sitzungsbereinigung gesperrt. Das löscht für sich keine ausstehenden Vorgänge; die bestehende Bereinigung beim Abmelden oder Serverwechsel entfernt weiterhin Lesecache und Warteschlange.

  Scheitern sowohl das Speichern der Sperre als auch das Löschen der Daten, gilt der zusätzliche Schutz nur bis zum App-Neustart. Auch ein Abbruch vor dem ersten erfolgreichen Speichern sichert keinen Neustart ab. Die Änderung ist im Quellcode geprüft, aber noch nicht als native App veröffentlicht.

• Ausstehende Vorgänge: Inventur-Statusänderungen, Jugend-Zu-/Absagen und klassische Dienst-Check-ins können offline in der Warteschlange gespeichert werden. Die separate Tagesanwesenheit per Tagescode benötigt eine Online-Verbindung. Bei verfügbarem Netz versucht die App das Nachsenden nach bestätigter Anmeldung und geladenen Berechtigungen, auch nach einem App-Neustart mit gespeicherter Sitzung. Netzverfügbarkeit allein bestätigt keine Serververbindung oder erfolgreiche Übertragung. Unter „Synchronisation“ sehen Sie den Zustand und können erneut versuchen; ein abgewiesener Vorgang bleibt gespeichert und hält die folgenden Vorgänge zurück.

• Sitzung nach Offline-Start: Im Entwicklungsstand vom 24. Oktober 2026 prüft die App eine wegen vorübergehender Nichterreichbarkeit nicht wiederhergestellte Sitzung beim Wiederverbinden erneut. Erst nach bestätigter Anmeldung und geladenen Berechtigungen beginnt das Nachsenden; Einträge werden erst nach bestätigter Übertragung entfernt. Eine ausdrücklich abgelaufene oder abgewiesene Anmeldung erfordert erneutes Anmelden. Wiederholte Online-Meldungen lösen keine fortlaufenden Anmeldeversuche aus. Diese Änderung ist noch nicht als native App veröffentlicht; die Prüfung mit echtem Netzverlust und Offline-Neustart im Simulator steht noch aus.

• Seltene Verwaltungsaktionen (Gerät anlegen/löschen, Inventur abschließen) benötigen eine aktive Verbindung und sagen das klar an.

Android-Widget und Kontowechsel

Im Entwicklungsstand vom 24. Oktober 2026 ordnet die App gespeicherte Android-Widget-Termine zusätzlich dem Benutzerkonto und der Server-Adresse zu. Die Hintergrundaktualisierung darf solche Termine bei einem vorübergehenden Ladefehler nur wiederverwenden, nachdem sie dasselbe Konto am selben Server bestätigt hat. Kann sie das Konto nicht bestätigen, zeigt sie keine gespeicherten persönlichen Termine an.

Ältere Widget-Daten ohne Kontozuordnung werden dabei nicht übernommen. Nach einer erfolgreichen Aktualisierung stehen wieder zugeordnete Daten zur Verfügung. Abmelden und Zurücksetzen der Server-Verbindung leeren das Widget weiterhin. Diese Änderung ist noch nicht als native App veröffentlicht; die Prüfung auf einem echten Android-Widget steht noch aus.

Installation

Plattform	Weg
Android	Installation der APK-Datei aus dem Kunden-Download (Sideload: „Installation aus unbekannten Quellen" einmalig erlauben).
iOS / iPad	Installation über die Apple-Verteilwege (z. B. TestFlight bzw. Ad-hoc-Profil); dafür ist eine Apple-Developer-Signatur nötig. Sprechen Sie uns an — der Weg hängt von Ihrer Umgebung ab.
macOS	Die App läuft zusätzlich nativ auf Apple-Silicon-Macs (Mac-Catalyst-Build).

Datenschutz

Verwaltungsdaten werden mit Ihrem Florian-Server ausgetauscht. Barcode-Erkennung läuft auf dem Gerät; Profilbilder werden serverseitig von Metadaten befreit. Die oben beschriebene Netzstatus-Änderung unterbindet die zusätzlichen HTTP-Erreichbarkeitsprüfungen der App; Netzprüfungen des Betriebssystems werden dadurch nicht gesteuert.