FAQ & Glossar

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 per Telegram. 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.

Berechtigungen

  • Permission — Atomares Recht zu einer Aktion (z. B. einsatz.edit). Pro Rolle administrierbar.
  • Scope-Filter — Code-Logik, die Datenmengen einschränkt (z. B. „Dispo sieht nur eigene Einsätze"). Nicht administrierbar.
  • Admin-Failsafe — PermissionService::userCan() gibt für Admin-Rolle immer true zurück.
  • Locked-Permission — Permission, die für eine bestimmte Rolle hartcodiert 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 Permission-Prüfung (User::effectiveRoles()). 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

  • 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.
  • Heartbeat — Alle 6 h schreibt der Cron einen Heartbeat-Eintrag und schickt eine Statusnachricht an den Telegram-Status-Chat.
  • 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.
  • SchemaProvider — Code-Klasse, die das DB-Schema definiert und CREATE-Statements ausführt. Es gibt keine separaten SQL-Migration-Files.

Datenformate

  • Textkontrast (ColorContrast) — Bestimmt aus einer beliebigen Hintergrundfarbe (RGB-Hex), ob schwarze oder weiße Schrift darauf besser lesbar ist (nach WCAG 1.4.3). Im Code der Helfer ColorContrast::textOn() (src/ColorContrast.php); flächig genutzt, damit selbst administrierte Farben lesbar bleiben — etwa bei den Farb-Pillen aus der Datenbank, den interaktiven Status-Auswahlfeldern und den Markern der Lagekarte.
  • 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 (Utm32Converter), gespeichert in utm_ost/utm_nord. Kein manuelles Feld; in der Geocode-Übersicht nur als Anzeige. Im Code: src/Utm32Converter.php.
  • 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. Gespeichert in den Spalten plus_code/w3w der einsaetze-Tabelle; im Code orchestriert von src/KurzStandortService.php.
  • 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 — URL-freundliche Topic-Bezeichnung, 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.