FAQ & Glossar

Kurz-Definitionen aller Fach- und ETB-spezifischen Begriffe.

Allgemein

• ETB — Kurzform des Produktnamens „ETB – Das Einsatztagebuch". Diese App.
• LG — Löschgruppe. Eine taktische Einheit innerhalb der Feuerwehr, meist nach Ortsteil organisiert (z. B. „LG Musterdorf").
• IuK — Information und Kommunikation. Die Funk- und Funkverkehrs-Truppe. IuK-Alarme werden im ETB gesondert behandelt.
• EM — Einsatzmittel. Jede taktische Einheit (Fahrzeug, Gerät, Personal-Trupp), die Du an einen Einsatz schicken kannst.
• ZVF / GF / Ma — Zug- und Verbandführer / Gruppenführer / Mannschaft. Standard-Aufteilung für die Stärke einer Einheit, notiert als „Zug- und Verbandführer / Gruppenführer / Mannschaft / Gesamt". Die Gesamtzahl (letzte, in der Oberfläche doppelt unterstrichene Position) ergibt sich immer aus der Summe der drei Werte davor.
• üÖrt — Überörtlich. Bezeichnet EMs, die nicht aus der eigenen Wache kommen, sondern als Hilfe von außen geschickt werden.

ETB-Konzepte

• Einsatz — Die kleinste dokumentierte Lage. Hat Stichwort, Adresse, Status, EM-Liste, Kommentare. Im Code: einsaetze-Tabelle.
• Abschnitt — Operative Unterteilung eines einzelnen Einsatzes. Z. B. „Wasserversorgung", „Brandbekämpfung". Hat eigenen Leiter, eigene Rufgruppe, eigene EMs. Im Code: einsatz_abschnitt.
• Schwerpunkt (SP) — Klammer über mehreren Einsätzen bei Großlagen. Hat eigenen Dispo, eigenen EM-Pool, eigenes Tagebuch. Im Code: schwerpunkte.
• Pool — Der Einsatzmittel-Pool eines Schwerpunkts. Nur EMs aus dem Pool dürfen den Einsätzen des Schwerpunkts zugewiesen werden.
• Stichwort-Katalog — Administrierbare Liste der Einsatzstichworte Deiner Wehr (Kategorie, volles Stichwort, Anzeige-Variante, Aliase). Speist die Stichwort-Auswahl im Einsatz-Formular und den Mail-Parser-Abgleich. Pflege unter Admin → Stammdaten; im Code: stichwort_katalog.
• Anzeige-Variante — Die verkürzte Schreibweise eines Katalog-Stichworts, die in Listen, Detail und Export erscheint (z. B. B1-Sonstiges statt SU-B1-Sonstiges). Wird durch ein passendes Ausblend-Präfix automatisch abgeleitet oder von Hand gesetzt.
• Ausblend-Präfix — Technisches Präfix vor einem Stichwort (z. B. SU-), das das ETB für die Anzeige-Variante abschneidet. Mehrere Präfixe lassen sich komma-getrennt im Stichwort-Katalog hinterlegen.
• Auto-Zuweisung — Wenn ein neuer Einsatz im Ort eines aktiven Schwerpunkts entsteht, landet er automatisch im SP. Funktioniert nur bei SP-Modus „Orte".
• Digitaler Zwilling NRW (DZ) — Landesweites 3D-Geo-Kartensystem NRWs (dz.nrw.de). Das ETB verlinkt die Einsatzstelle als Karten-Button „DZ" (Einsatz-Detail + Telegram), sofern das Feature feature_dz_nrw_enabled aktiv ist und Koordinaten vorliegen. Nutzt UTM-Koordinaten (EPSG:25832).
• Alarmregel (Multi-Alarm) — Stichwort-Regel, die beim Eintreffen einer Alarm-Mail automatisch Folge-Einsätze oder Folge-Abschnitte anlegt (z. B. UW-ERSTALARM → Grundschutz + Bereitstellung). Im Code: alarm_rule.
• Manuelle Alarm-Auslösung — Eine Folge-Einsatz-Alarmregel per Knopf („Alarm auslösen" in der Einsatz-Übersicht) von Hand auslösen, wenn die Leitstelle keine Mail schickt. Legt Basis-Einsatz + Folge-Einsätze an und alarmiert über den eingestellten Zustellweg. Recht alarm.trigger_manual; 60-Sekunden-Cooldown pro Regel gegen Doppelauslösung (alarm_trigger_throttle).

Rollen

• Admin — Vollzugriff inkl. Admin-Bereich. Failsafe-geschützt gegen Selbst-Aussperren.
• Einsatzleiter (EL) — Operative Spitze, führt und verantwortet alles („accountable"); darf zusätzlich abgeschlossene Einsätze wiedereröffnen und Schwerpunkte schließen/archivieren.
• Lage — Lagedienst, verlängerter Arm des Einsatzleiters: bewertet die Einsatzlage und verteilt die Einsätze an die Disponenten.
• Dispo — Disponent. Sieht per Default nur eigene Einsätze.
• SP-Dispo — Schwerpunkt-Disponent. Sieht alle Einsätze in seinem Schwerpunkt.
• Gast — Mitleser, keine Bearbeitung.
• Einsatzkraft — Reiner Meldungs-Empfänger ohne Zugang: Das Konto kann sich nicht anmelden und dient nur der Adressierbarkeit über die Löschgruppe. Hat per Default kein einziges Recht.

Berechtigungen

• Permission — Atomares Recht zu einer Aktion (z. B. einsatz.edit). Pro Rolle administrierbar.
• Sichtbarkeits-Grenze — fest eingebaute Regel, die Datenmengen einschränkt (z. B. „Dispo sieht nur eigene Einsätze"). Nicht administrierbar.
• Admin-Failsafe — Die Administrator-Rolle hat jedes Recht, unabhängig davon, was in der Rechteverwaltung angehakt ist. So kann sich niemand versehentlich selbst aussperren.
• Locked-Permission — Permission, die für eine bestimmte Rolle fest eingebaut erforderlich ist und nicht abgewählt werden kann (z. B. schwerpunkt.view für SP-Dispo).
• ROLE_SPECIFIC_PERMS — Permissions, die nur bei bestimmten Rollen Sinn ergeben und nur dort in der UI auftauchen (z. B. einsatz.view_all nur bei Dispo).
• Einsatz-Rolle / temporäre Rolle — Einem Benutzer befristet (max. 48 h) geliehene höhere Rolle (Einsatzleiter oder Lage). Vergeben über das Modal „Einsatz-Rollen" (Button auf der Einsatz-Übersicht, Recht user.assign_temp_role, geprüft gegen die effektive Rolle). Wirkt sofort ohne Neuanmeldung und läuft automatisch aus. Admin und SP-Dispo nehmen nicht teil. Seit v4.7.5 darf auch weitervergeben, wer die Rolle selbst nur geliehen hat — die Kette wird dabei über die Laufzeit gedeckelt (endet spätestens mit der eigenen geliehenen Rolle).
• Alarm-Knopf — Einmaliges Rollen-Angebot einer Alarm-Regel: Löst eine Regel mit konfiguriertem Angebot aus (per Mail oder manuell), erscheint im Seitenmenü ein Blitz-Knopf, über den ein Disponent selbst die Rolle Lage oder Einsatzleiter für die konfigurierte Laufzeit (6–48 h ab Übernahme) übernimmt — für Lagen ohne anwesende Führung. Höhere Rollen können das Angebot stattdessen entschärfen; Gast und SP-Dispo sehen es nie. Im Code: alarm_role_offer.
• Highlander-Prinzip — Regel hinter der Einsatz-Rolle: Die geliehene Rolle kommt zur Basis-Rolle dazu (Vereinigung der Rechte), das höhere Recht gewinnt. Die feste Rolle wird nie ersetzt.
• Effektive Rollen — Basis-Rolle plus ggf. aktive temporäre Rolle. Maßgeblich für jede Rechteprüfung. Der Admin-Failsafe wirkt bewusst nur auf die Basis-Rolle — über eine Einsatz-Rolle wird niemand Admin.

Wichtigkeit / Status

• Wichtigkeit — Priorität eines Einsatzes (Default-Stufen: bereitstellung / normal / eilig / großschadenslage). Mit Farbe und Label, in den Stammdaten administrierbar.
• Einsatz-Status — neu → dispo (Disponent) → in_bearbeitung → erledigt → abgeschlossen. Vorwärts-Übergänge nach dispo (Disponent zuweisen) und in_bearbeitung (erstes Einsatzmittel zuweisen) laufen automatisch. Der finale Schritt auf abgeschlossen verlangt das Recht einsatz.abschluss (Vier-Augen-Prinzip). Aus abgeschlossen zurück nur via Wiedereröffnen (Permission einsatz.reopen). Mehr unter mehr zu Status.
• Abschnitts-Status — geplant → aufbau → einsatz → erledigt (Stufen administrierbar, Default-Start „geplant").
• Schwerpunkt-Status — Aktiv → Pausiert → Erledigt → Abgeschlossen (interne Keys: aktiv → pausiert → geschlossen → archiviert). Abgeschlossene Schwerpunkte reaktiviert nur ein Administrator.
• Abschnitts-Sperre (früher „Abschluss-Sperre") — Einsatz kann weder auf erledigt noch auf abgeschlossen gesetzt werden, solange Abschnitte in Arbeit sind (begonnen, aber nicht erledigt); geplante Abschnitte blockieren nicht. Schwerpunkt kann nicht erledigt werden, solange Einsätze weder erledigt noch abgeschlossen sind.
• Warn-Sperre (v4.7.5) — Einsatz bzw. Schwerpunkt kann weder auf erledigt noch auf abgeschlossen gesetzt werden, solange an ihm eine Bevölkerungswarnung noch offen ist (jede Phase außer abgeschlossen). Am Status-Auswahlfeld in Einsatz-Übersicht/-Detail sowie beim Schwerpunkt-Abschluss öffnet sich dafür sofort ein Sperr-Dialog mit Direkt-Abschließen bei aktiver Entwarnung; an den übrigen Wegen (Bulk, Bearbeiten-Formular, Abschluss-Arbeitsplatz) bleibt es bei einer Meldung nach dem Versuch. Mehr unter mehr zu Status.
• Status-Kachel — Die farbige Kachel links an jeder Einsatz- bzw. Abschnitts-Zeile. Zeigt die laufende Nummer (#007 / A#001) und einen Kurz-Status (NEU, DISPO, AKTIV, FERTIG, ABG.); ihre Farbe folgt dem Status. Erscheint in Liste, Detail-Kopf, je Abschnitt und als Lagekarte-Marker.
• Komfort / Kompakt — Umschalter über der Einsatzliste für die Darstellungsdichte: Komfort zeigt luftige Karten-Zeilen mit allen Spalten, Kompakt eine dichte, einzeilige Liste für viele Einsätze. Die Wahl wird pro Browser gemerkt und ändert nur die Anzeige.

System

• Alarmmonitor — Die Vollbild-Ansicht der Seite Rückmeldungen, gedacht für einen Schirm in der Fahrzeughalle. Links das Lagebild der laufenden Einsätze, rechts wer kommt. Läuft kein Einsatz, zeigt er den Warte-Zustand mit Uhrzeit und Wetter. Er fragt in einem einstellbaren Takt nach (Vorgabe 10 Sekunden); die verbleibenden Sekunden stehen unten links.

• Bildschirm-Zugang — Eine Adresse, mit der ein Hallenschirm den Alarmmonitor ohne Anmeldung zeigt. Angelegt unter Meldungen → Rückmeldungen; die Adresse lässt sich anzeigen, kopieren, erneuern und widerrufen. Sie gilt ein Jahr und nur für diese eine Ansicht — mehr als der Monitor ist damit nicht erreichbar.

• Zustellprotokoll — Die Liste, welche Meldung hinausging und was dabei passierte, aufgebaut je Meldung (nicht je Person). Als Problem zählt nur, was nachweislich schiefging: eine unzustellbare Meldung oder eine ausbleibende Rückmeldung. Dass etwas in den Gruppenchat ging, weil andere schon Web Push nutzen, ist kein Problem — das ist der Sinn der Erprobung. Siehe Meldungen.

• Alarm-Fenster — Das Fenster, das bei einem Alarm über der laufenden Seite aufgeht, damit die Antwort nicht erst gesucht werden muss.

• Kurznachricht / Lagemeldung — Ein kurzer Zuruf aus dem Einsatz („ELW raus", „Abbruch"). Ausdrücklich keine Rückmeldung: Sie sagt etwas über die Lage, nicht darüber, wer kommt, und zählt deshalb nicht in die Zahl der Zusagen.

• Angemeldet bleiben — Das Häkchen beim Anmelden, mit dem ein Gerät 90 Tage lang nicht mehr nach dem Passwort fragt. Öffnet die Verwaltung nicht — dafür fragt das ETB weiterhin. Widerrufbar im Profil, einzeln oder für alle Geräte. Nicht zu verwechseln mit einem Gerät für Alarme: Das eine sagt, wo Du angemeldet bleibst, das andere, wohin ein Alarm geht.

• Postfach — Die Seite, auf der alles Nachrichtliche zusammenläuft. Erreichbar über das Briefsymbol mit Zähler, nicht über das Menü. Links stehen Ordner: Wartet auf Dich (braucht eine Antwort oder Entscheidung), Alle Meldungen und je einer pro Gruppe — Alarm, Einsatz, Warnung, System. Der Zähler zählt nur den ersten. Siehe Postfach.

• Entscheidung — Eine Meldung, deren Antwort etwas tut statt etwas zu melden: Gerät freigeben, Warnung freigeben. Sie bleibt 14 Tage offen (eine normale Rückmeldung 4 Stunden), steht so lange unter „Wartet auf Dich" und geht nie über Telegram raus — dort könnte jeder Mitleser sie treffen.

• Meldungs-Bus — Die Schicht, über die alle Nachrichten des ETB laufen. Adressiert wird an Personen, Rollen und Löschgruppen; welcher Weg daraus einen Chat oder eine Benachrichtigung macht, entscheidet der Kanal. Siehe Meldungen.

• Kanal / Zustellweg — Der Adapter, der eine Meldung tatsächlich ausliefert: Telegram oder Web Push. Gilt für die ganze Installation — ein einzelner Benutzer wählt ihn nicht selbst, und es gilt genau ein Weg für alle. Einzige Ausnahme: die Erprobung.

• Erprobung (des Zustellwegs) — Ein Zustand, in dem der Administrator einzelnen Personen einen abweichenden Zustellweg geben kann (Telegram, Web Push oder beides), um den Umstieg mit ein paar Freiwilligen zu üben. Gesetzt wird das je Person unter Benutzer, gestartet und beendet unter Meldungen; das Beenden wählt den Weg für alle und setzt alle Ausnahmen zurück.

• Web Push — Zustellweg ohne Fremddienst: Die Meldung landet direkt als Benachrichtigung auf dem Gerät, adressiert an Personen statt an Chats. Der Inhalt ist unterwegs verschlüsselt; der Push-Dienst des Herstellers sieht ihn nicht. Setzt HTTPS voraus. Siehe Web Push.

• Einladungslink (Web Push) — Einmal-Link, mit dem jemand ohne Anmeldung sein Gerät für Meldungen einrichtet — gedacht für die Rolle Einsatzkraft. Gilt 14 Tage und genau einmal und ist keine Anmeldung.

• Empfangsnachweis — Die Rückmeldung des Geräts, dass eine Benachrichtigung wirklich angekommen ist. Der Unterschied zu „zugestellt": Das sagt nur, dass der Push-Dienst sie angenommen hat. Erst der Empfangsnachweis trägt die Aussage „dieses Gerät klingelt" — und speist die Zustände Erreichbar / Unbewiesen im Profil.

• Geräte-Freigabe — Optionaler Schalter (Vorgabe: aus), der ein neu angemeldetes Gerät so lange still hält, bis ein Administrator es freigibt. Freigegeben wird im Postfach an der Meldung „Neues Gerät" oder in der Geräte-Liste unter Web Push.

• Bereitschaft — Die vier Kacheln unter Web Push, die Personen (nicht Geräte) zählen: erreichbar, unbewiesen, stumm, ohne Gerät. Die Antwort auf „wer ist überhaupt erreichbar?" vor dem Alarm.

• Probealarm — Eine echte Push-Nachricht an ein eigenes Gerät, auslösbar im Profil. Nimmt denselben Weg wie ein echter Alarm — eine Attrappe wäre schlimmer als keine Prüfung. Höchstens alle 30 Sekunden je Person.

• Meldungsart — Ein Anlass, zu dem das ETB meldet (z. B. Hauptalarm, Warnung zur Freigabe). Je Art gibt es eine oder mehrere Regeln, die Empfänger, Text und Rückmeldungen festlegen.

• Zustellstatus — Ergebnis je Empfänger: zugestellt, nur eingeschränkt, nur im ETB sichtbar, nicht gesendet oder fehlgeschlagen. Nur der letzte ist ein Fehler.

• Rückmeldung — Die Antwort auf eine Meldung, immer einer der vorgegebenen Knöpfe („Komme", „ESt", …) — nur so bleibt sie auswertbar. Daneben ist ein kurzer Zusatztext möglich, der sie ergänzt, aber nie ersetzt. Ausgewertet unter Rückmeldungen.

• Sammelmeldung — Der Stand der Rückmeldungen als eigene, leise Meldung an die Führung: wie viele kommen, wer, wie viele noch offen. Sie ersetzt das Lagebild, das im Gruppen-Chat ein Nebenprodukt war, und zählt alle Wege mit — App, Sperrbildschirm und Telegram-Chat; Chat-Einträge tragen dabei den Zusatz „(aus dem Chat)". Siehe Meldungen.

• Zusage — Die Rückmeldungen, die als „kommt" gewertet werden: „Komme", „Komme sofort", „ESt", „Ja", „dabei". Nur sie zählen in die Zahl im Betreff der Sammelmeldung und werden dort namentlich genannt.

• Nachricht (bis 4.9 „Durchsage") — Eine freie Meldung an eine Rolle, eine Einheit oder — wenn der Zustellweg Personen adressiert, also bei Web Push — an eine einzelne Person. Recht mitteilung.durchsage (der Schlüssel blieb), verfasst über den Knopf oben im Postfach. Siehe Nachricht.

• Cron-Token — Geheimer Token, der mit jedem /cron.php-Aufruf mitgegeben werden muss. Schützt vor externer Auslösung.

• Webhook-Secret — Token für Telegram-Webhook-Calls. Wird in der URL mitgesendet und vom ETB geprüft.

• Rückweg — Der Weg, auf dem Telegram-Antworten zurück ins ETB kommen. Zwei Möglichkeiten, immer nur eine gleichzeitig: der Webhook (Telegram stellt zu, sofort, braucht HTTPS und Erreichbarkeit von außen) oder das Abholen (der Cron fragt nach, so frisch wie der Cron-Takt, braucht nichts davon). Umgestellt unter Webhook-Status.

• Heartbeat — Alle 6 h schreibt der Cron einen Heartbeat-Eintrag; der tägliche Heartbeat schickt zusätzlich eine Statusmeldung an die Administratoren — über den eingestellten Zustellweg.

• Soft-Delete — Datensatz wird nicht physisch gelöscht, sondern bekommt deleted_at-Timestamp gesetzt. Für Restore und Revisionssicherheit.

• System-Kommentar — Kommentar mit author_user_id = NULL, geschrieben vom ETB selbst (z. B. bei automatischer EM-Entfernung). Nicht editierbar, auch nicht für Admins.

• Tabellen-Präfix — DB_TABLE_PREFIX in der .env. Erlaubt mehrere ETB-Instanzen in derselben Datenbank.

  Datenformate

• Textkontrast — Das ETB bestimmt zu jeder Hintergrundfarbe selbst, ob schwarze oder weiße Schrift darauf besser lesbar ist (nach WCAG 1.4.3). Das gilt überall dort, wo Du Farben selbst festlegst — Status-Pillen, Auswahlfelder, Marker auf der Lagekarte: Eine frei gewählte Farbe kann die Beschriftung darauf nicht unlesbar machen.

• UTM / EPSG:25832 (Rechtswert / Hochwert) — Metrisches Koordinatensystem (UTM-Zone 32N), das der Digitale Zwilling NRW erwartet. Das ETB hält intern GPS-Koordinaten (WGS84, Latitude/Longitude) und berechnet Rechts- und Hochwert automatisch daraus. Kein manuelles Feld; in der Geocode-Übersicht nur als Anzeige.

• Kurz-Standort — Kompaktes Standort-Kürzel je Einsatz (Plus Code und/oder what3words), automatisch aus den GPS-Koordinaten abgeleitet — zusätzlich zur Adresse. Zwei Anbieter, im Admin einzeln zuschaltbar und beide standardmäßig aus. Beide werden am Einsatz gespeichert und stehen im Export mit drin.

• Plus Code (Open Location Code) — Von Google entwickeltes, offenes Standort-Kürzel (z. B. 9F29MFGX+XG), das eine Fläche statt einer Adresse bezeichnet. Das ETB berechnet ihn offline aus den GPS-Koordinaten — kein API-Schlüssel, keine Kosten. Im Code: src/lib/PlusCode.php.

• what3words — Kommerzieller Dienst, der die Welt in 3-m-Quadrate mit je drei Wörtern adressiert (Notation ///wort.wort.wort, z. B. ///gelagert.betrag.bunten). Die Umwandlung Koordinaten ↔ drei Wörter läuft über eine kostenpflichtige API (der Gratis-Plan kann sie seit dem 25.11.2024 nicht); Schlüssel als W3W_API_KEY in config/.env, nie in der Datenbank. Im Code: src/W3wClient.php.

• Slug — der kurze Name einer Handbuch-Seite in der Adresszeile, z. B. schwerpunkt-liste. Wird in Hilfe-URLs verwendet.

• Markdown / GFM — Auszeichnungssprache des Handbuchs. Parsedown rendert sie zur HTML-Anzeige, GitLab-Wiki rendert sie nativ.

Wenn Du einen Begriff vermisst

Sprich uns an oder mache einen Pull-Request auf docs/handbuch/glossar.md.