FWportal APP Handbuch Version 2025.12

Teil 1: Anwenderhandbuch Zielgruppe: Einsatzkräfte

1. Willkommen in der FWPortal App
Die FWPortal App ist dein mobiler Begleiter für den Dienstalltag. Sie ermöglicht dir den schnellen Zugriff auf deine persönlichen Daten, deinen Ausbildungsstand und alarmiert dich zuverlässig bei Einsätzen.

Wichtiger Hinweis: Die App dient aktuell der Information und Alarmierung. Deine Daten (z. B. Adresse oder Lehrgänge) kannst du hier einsehen, aber nicht bearbeiten. Änderungen werden zentral über das FWPortal im Webbrowser vorgenommen.

2. Installation & Anmeldung
2.1 App installieren Lade die App aus dem Apple App Store oder Google Play Store herunter.

• iOS: Benötigt ein iPhone mit aktueller iOS-Version.
• Android: Benötigt ein Smartphone mit Google-Diensten. 

Sicherheitshinweis: Bitte aktiviere in deinem Smartphone die „Automatische App-Updates“. Da die FWPortal App für die Alarmierung sicherheitskritisch ist, solltest du immer die neueste Version installiert haben, um eine zuverlässige Funktion zu gewährleisten.

2.2 Anmelden (Schritt für Schritt)
Starten: Öffne die App. Du wirst auf dem Startbildschirm mit dem Logo und einem freundlichen „Moin!“ begrüßt.

1. 
2. Aktion: Tippe auf den Button „Anmelden“.
3. Nur für iPhone-Nutzer: Es erscheint ein Hinweis: „FWportal.Mobile möchte zum Anmelden fwportal.com verwenden“. Bestätige dies unbedingt mit „Fortfahren“, um zur sicheren Anmeldeseite zu gelangen:
   
4. Eingabe: Jetzt erscheint die Anmeldemaske. Gib deine E-Mail-Adresse und dein Passwort ein:
   
5. Tipp: Setze den Haken bei „Angemeldet bleiben“, um dich nicht jedes Mal neu einloggen zu müssen.
6. Klicke abschließend auf den roten Button „Anmelden“.

2.3 Berechtigungen (Wichtig für Alarm!)
Nach der Anmeldung fragt dich die App nach Berechtigungen. Dies ist der wichtigste Schritt, damit dein Handy bei Alarm klingelt!

Für Android Nutzer: Bestätige die Frage „FWportal“ möchte dir Mitteilungen senden“ mit „Erlauben“.

     

Für iPhone (iOS) Nutzer: Du erhältst nacheinander zwei Abfragen, die du beide bestätigen musst:

1. Mitteilungen senden: Tippe auf „Erlauben“. Dies sorgt dafür, dass normale Hinweise und Infos auf dem Sperrbildschirm erscheinen.
   
2. Kritische Hinweise senden: Tippe unbedingt auf „Erlauben“!
   
   • Warum? Nur so kann die App einen Alarmton abspielen, auch wenn dein iPhone stummgeschaltet ist oder ein Fokus (z. B. „Schlafen“) aktiv ist.

3. Dein Dashboard (Startseite)
Nach dem Login landest du auf deiner persönlichen Startseite:

Hinweis zum Offline-Modus:
Hast du mal keinen Empfang (z. B. im Keller), zeigt dir die App die Daten an, die sie zuletzt geladen hat (Cache). Du kannst in diesem Moment keine neuen Rückmeldungen geben oder Alarme empfangen. Sobald du wieder Netz hast, aktualisiert sich die App automatisch.

3.1 Deine Visitenkarte
Ganz oben begrüßt dich die App mit deinem Namen und deinen Initialen (z. B. „SF“).

• Aktion: Tippe auf die Kachel, um direkt zur Ansicht „Meine Mitgliedsdaten“ (5.1) zu springen.

3.2 Kachel: Letzter Einsatz
Links siehst du den letzten Alarm deiner Einheit mit Stichwort (z. B. „F2“) und Zeit Stempel.

• Aktion: Tippe auf die Kachel, um direkt zu den „Einsatzdetails“ (4.2) zu springen.

3.3 Kachel: AGT-Status (Atemschutz)
Rechts siehst du auf einen Blick, ob du atemschutztauglich bist.

✅ Grünes Häkchen: Alles okay, Datum der nächsten Fälligkeit wird angezeigt (z. B. „Apr 2026“).

❌ Rotes Kreuz: Deine Tauglichkeit ist abgelaufen oder Daten fehlen.

• Aktion: Tippe auf die Kachel, um direkt zur Ansicht „Meine Atemschutzdaten“ (5.2) zu springen. Hier kannst du prüfen, welcher Termin (G26.3, Unterweisung etc.) fehlt.

3.4 Das Hauptmenü öffnen
Um zu weiteren Funktionen (wie Einstellungen oder Abmelden) zu gelangen, öffnest du das Seitenmenü. Dafür hast du zwei Möglichkeiten:

1. Tippen: Drücke auf das Hamburger-Symbol (drei waagerechte Striche) oben links in der Ecke vom Dashboard.
2. Wischen (Geste): Wische mit dem Finger vom linken Bildschirmrand nach rechts zur Mitte.

4. Alarmierung & Einsätze

4.1 Der Alarm (Push-Benachrichtigung)

Im Einsatzfall erhältst du sofort eine Benachrichtigung auf dein Smartphone. Beispiel Ansicht Bild 1 iOS und Bild 2 Android: 

• Erkennungsmerkmal: Bei korrekt eingestellten Berechtigungen (siehe 2.3) siehst du ein rotes Warndreieck und den Text „KRITISCH“ oben in der Meldung (nur IOS).
• Auf einen Blick: Du siehst Alarmstufe (z. B. „VOLL“), Alarmzeit, Stichwort und die grobe Lage. Dies funktioniert sowohl auf dem Sperrbildschirm als auch als Banner, wenn du das Handy gerade benutzt.
• Schnell-Antwort (Quick Actions): Ziehst du die Meldung nach unten (oder drückst darauf), erscheinen die Buttons „Komme“ und „Komme nicht“ direkt unter dem Text.

4.2 Der Alarm (in der App) / Einsatzdetails.
Öffnest du den Alarm (über die Push-Nachricht oder die Alarmübersicht), siehst du alle Details (Beispiel Ansicht iOS und Android).
 

• Karte: Ganz oben zeigt dir ein Pin den Einsatzort auf der Karte (Apple Maps bei iOS, Google Maps bei Android).
• Lage: Darunter findest du Adresse, Objektbezeichnung (z. B. Firmenname) und das Stichwort.
• Details und Einsatzmittel: Tippe auf diesen Menüpunkt, um die Liste der alarmierten Fahrzeuge (z. B. FWportal 01-46-01) auszuklappen.
• Rückmeldungen: Ein Tipp hierauf öffnet eine Liste aller Kameraden, die zugesagt oder abgesagt haben. Du kannst die Liste durch Ziehen nach unten aktualisieren.

4.3 Navigation starten
Im unteren Bereich der Einsatzansicht findest du den Punkt „Navigation starten“.

• Ein Tipp hierauf öffnet automatisch deine installierte Karten-App und startet die Routenführung zum Einsatzort.

4.4 Rückmeldung geben
Am unteren Bildschirmrand der App findest du permanent zwei große Buttons:

• Grün (Komme): Du bestätigst deine Teilnahme.
• Rot (Komme nicht): Du meldest dich ab.

5. Deine Daten (Ansicht)

5.1 Meine Mitgliedsdaten
Hier findest du deine mID (Mitglieds-ID), Name und Geburtsdatum.

• Mitgliedschaften: Tippe auf den Pfeil unten, um deine Dienststellen (z. B. „FF Musterhausen“) und deinen Status („Aktiv“) sowie Ein- und Austrittsdaten aufzuklappen.

5. 2 Meine Atemschutzdaten
Hier siehst du im Detail, warum deine Ampel auf Grün oder Rot steht. Die App unterscheidet:

• Basis: Wann läuft deine allgemeine AGT- oder CSA-Tauglichkeit ab?
• Detail: Die einzelnen Bausteine (G26.3, Unterweisung, Übungsanlage, Einsatzpraxis).

Symbolik: Ein grüner Haken bedeutet „Gültig“, ein rotes Kreuz bedeutet „Abgelaufen“ oder „Unbekannt“ (kein Datum im System).

6. Einstellungen (Alarmtöne konfigurieren)
Hier kannst du die App auf deine Bedürfnisse anpassen. Wähle dazu im Hauptmenü den Punkt „Einstellungen“.

6.1 Allgemeine Einstellungen
Im Einstellungen Menü siehst du auf einen Blick:

• Schleifen einstellen: Tippe hierauf, um Töne und Einstellungen für einzelne Schleifen anzupassen.
• Benachrichtigungen: Prüfe, ob Benachrichtigungen grundsätzlich auf „Ja“ stehen.
• Lautlos übersteuern: Hier siehst du, ob die kritischen Alarme (iOS) oder die Modus Übersteuerung (Android) aktiv sind (Status „Ja“).
• Erscheinungsbild: Hier kannst du das Erscheinungsbild der APP anpassen. Hell, Dunkel oder Automatisch nach deinen Geräteeinstellungen oder Modis.

6.2 Schleifen Einstellungen Android
Bei Android-Geräten tippst du auf eine Schleife (z. B. „FF Musterhausen – VOLL“), um Details zu ändern:

• Lautlos übersteuern (Schalter): Aktiviere diesen Schalter, damit Alarme auch im „Nicht stören“-Modus klingeln.
• Schleifeneinstellungen öffnen: Tippe auf diesen Menüpunkt um die Details der Schleife einzustellen.

6.3 Einstellungen iOS
Unter iOS werden die kritischen Töne zentral im System verwaltet. Tippe auf „Benachrichtigungen“ oder „Lautlos übersteuern“ um in die iOS-Einstellungen zu gelangen:

1. Die App öffnet nun direkt in die iPhone-Einstellungen (siehe Bild). 
2. Tippe auf „Mitteilungen“.
3. Stelle sicher, dass der Schalter „Kritische Hinweise“ auf GRÜN (Ein) steht.
   • Ist dies aus, hörst du bei Stummschaltung keinen Alarm!
     
   • Stelle die restlichen Einstellungen nach deinen Wünschen ein:

7. Hilfe & Fehlerbehebung
Wenn etwas nicht funktioniert, unterscheide bitte: Spinnt die Technik (App) oder stimmen deine Daten (Inhalt) nicht?

Problem	Lösung
App zeigt alte Daten	Manchmal speichert die App alte Stände (Cache). Lösung: Öffne das Menü, tippe auf „Abmelden“. iPhone-Nutzer: Bestätige die Frage „Möchte zum Anmelden fwportal.com verwenden“ mit „Fortfahren“, um dich wirklich vollständig abzumelden. Schließe danach die App und melde dich neu an.
Kein Push-Alarm	1. Hast du beim ersten Start alle Fragen mit „Erlauben“ bestätigt? 2. iOS: Prüfe in den iPhone-Einstellungen unter Mitteilungen, ob „Kritische Hinweise“ aktiv sind. 3. Prüfe in den App-Einstellungen unter „Schleifen“, ob deine Einheit aktiviert ist.
Weißer Bildschirm	Prüfe deine Internetverbindung und starte die App neu.

7.2 Inhaltliche Probleme (Falsche Daten)
Hier liegt der Fehler meist in der Datenbank der Feuerwehr. Du kannst das in der App nicht selbst ändern. Bitte wende dich an den zuständigen Kameraden:

Problem	Ursache	Lösung (Wer hilft mir?)
AGT-Ampel ist Rot	Ein Termin (z. B. Streckendurchgang oder G26) wurde durchgeführt, aber noch nicht im System eingetragen.	📞 Wende dich an deinen Atemschutzwart. Er muss den Termin nachtragen.
Adresse/Rang falsch	Deine Stammdaten sind veraltet (z. B. nach Umzug oder Beförderung).	📞 Wende dich an deinen Schriftführer oder Ortsbrandmeister.
Alarm fehlt komplett	Du bist im System nicht der richtigen Alarmgruppe oder Schleife zugeordnet.	📞 Wende dich an den Gerätewart oder Admin.

8. Rechtliches & Datenschutz
Im Seitenmenü unter dem Punkt „Informationen“ findest du jederzeit wichtige rechtliche Hinweise:

• Impressum: Informationen zu FWportal GmbH und Kontaktmöglichkeiten.
• Datenschutz: Detaillierte Hinweise, wie deine Daten verarbeitet werden. Wichtig: Die App speichert Daten nur zur Anzeige zwischen (Cache), die Datenhoheit liegt auf dem sicheren FWPortal-Server. Siehe Datenschutzerklärung.
• Lizenzen: Übersicht über verwendete Open-Source-Software sowie genutzte Drittanbieter-Bibliotheken 
• Verwendete Medien / Schriftarten:  Auflistung der in der APP genutzten Schriftarten.
• Support & Kontakt: Unsere Kontaktdaten -> Support

Teil 2: Funktionsbeschreibung

Zielgruppe: Administratoren, IT-Verantwortliche

• Systemarchitektur

1.1 Frontend & Authentifizierung

Die App ist eine hybride Anwendung, die native Elemente (Navigation, Push-Handling) mit Web-Views kombiniert.

• Login-Flow: Der Nutzer startet auf einem nativen Splash-Screen („Moin!“) und initiiert den Login-Prozess.
  • iOS Spezifikum: Da der Login über login.fwportal.com (OAuth/OIDC) erfolgt, erzwingt iOS (ASWebAuthenticationSession) einen System-Dialog („…möchte fwportal.com verwenden“), den der User bestätigen muss.
• Session Management: Die Option „Angemeldet bleiben“ nutzt ein persistentes Token, das lokal sicher gespeichert wird. Ein expliziter Logout via Seitenmenü löscht dieses Token. Auch beim Logout fragt iOS nach Bestätigung, um die Session im SafariViewController-Cookie-Store zu bereinigen.

1.2 Datenstruktur & Visualisierung

• Dashboard: Aggregiert Daten aus den Endpunkten /profile, /operations/last und /agt/status.
• Mitgliedschaften: Werden als Accordion-Element dargestellt, um Historien und Mehrfach-Mitgliedschaften (z. B. JF und FF) übersichtlich zu gliedern.
• Navigation: Die App nutzt Intents (Android) bzw. URL Schemes (iOS), um Geokoordinaten an die auf dem Gerät installierte Navigationssoftware zu übergeben.

 

• Alarmierung & Notification Management

2.1 Kanäle & Berechtigungen (Critical Alerts)

Die App nutzt native Push-Technologien, um Alarme auch im „Nicht stören“-Modus zuzustellen.

• iOS (Critical Alerts): Die App besitzt das Entitlement com.apple.developer.usernotifications.critical-alerts. Der Nutzer muss beim ersten Start explizit die Berechtigung für „Kritische Hinweise“ erteilen. In den iOS-Systemeinstellungen kann dies granular verwaltet werden (Töne, Banner, Kennzeichen).
• Android (Notification Channels): Jede Alarmschleife wird als eigener Kanal angelegt, der vom Nutzer priorisiert werden kann (Override Do Not Disturb).

2.2 Alarmierungsweg & Interaktion

Push-Nachrichten werden über APNS (iOS) und FCM (Android) versendet.

• Payload: Die Nachricht enthält neben dem Text (body) und Titel (title) auch spezifische action_buttons.
• Interactive Notifications: Die App registriert „Alarm Categories“, die es ermöglichen, API-Calls (response: positive/negative) direkt aus der Benachrichtigung heraus zu senden (Actionable Notifications), ohne die App vollständig in den Vordergrund zu laden.

• Logik der AGT-Tauglichkeit

Die Ampel-Visualisierung im Frontend folgt einer strikten AND-Logik basierend auf den empfangenen Datensätzen.

Status GRÜN (Valid) erfordert:

1. G26.3: valid_until >= current_date
2. Unterweisung: last_date + 1 Jahr >= current_date
3. Übungsanlage: last_date + 1 Jahr >= current_date
4. Einsatz/Übung: last_date + 1 Jahr >= current_date

Exception Handling:

• Fehlt ein Datensatz (null oder „Unbekannt“), wird dies als ungültig gewertet und führt zum Status ROT.