Einsatzcockpit

Echtzeit-Führung im Einsatz — das digitale Cockpit für die Einsatzführung. Multi-User, mandantenfähig, Echtzeit. Für Feuerwehr, BOS und Gemeinden.

🔗 einsatzcockpit.com

Dokumentation: GitHub Wiki · Wiki-Quellen · Lizenz

---

Überblick

Eine vollwertige Webapp, die Einsatzleitern und Schriftführern eine strukturierte, Echtzeit-fähige Arbeitsumgebung bietet.

Zielgruppe: Einsatzleiter, Schriftführer, Atemschutz-Überwacher und UAS-Teams österreichischer Feuerwehren.

Kern-Prinzipien:

• Mehrere Geräte (Tablet, PC, Mobilgerät) arbeiten gleichzeitig am selben Einsatz
• Vollständiges Audit-Log — jede Änderung wird protokolliert (Zeitreise-Funktion)
• Multi-Tenancy — mehrere Organisationen auf einer Instanz, row-level isoliert
• Offline-fähige PWA — eingeschränkte Nutzung auch ohne Netzverbindung
• Native Android-App — eigenständiger Client mit echtem Offline-Datenbestand für Objekte & Kontakte, Live-Einsatzstatus und Homescreen-Widgets

Features

Gegliedert wie Menü und Wiki: zuerst die Einsatzführung, dann die Module in der Reihenfolge, in der man sie im Einsatz braucht.

Einsatz führen

Feature	Beschreibung
Echtzeit-Einsatzführung	WebSocket-basiertes Board für Kräfte, Aufträge, Fahrzeuge und Meldungen; abgeschlossene Einsätze nur noch lesbar
Atemschutzüberwachung	Rückzugsdruckberechnung, Zeitmessung und Warnungen
Lageführung	Taktische Zeichen, Fahrzeug- und Objekt-Layer, Multi-User-Editing, Replay und Druck
Zentrale Suche	Suche über Objekte, Objektdokumente, Einsatz- und Katastrophenpläne, Einsätze, Kontakte, Straßensperren, Wasserstellen und GSL-Daten mit Rechteprüfung
Wetter & lokale Stationen	Nowcast, Warnungen, Radar und optionale Meteobridge-Anbindung
Archiv & Berichte	Audit-Log, Zeitreise und PDF-Exporte

Module

Gruppe	Module
Im Einsatz	Einsatzwissen (Einsatzpläne, Führungswissen, Fachwissen & Lehrbehelfe, Katastrophenschutz, Sondereinsatzmittel und Nachschlagewerk; bestehende Planarten, Freigaben, Akteure, Prüfzyklus, PDF-Quellen, Karte, Offlinefassung und KI-Import) · Kontakte (Einsatztelefonlisten, Verzeichnisse) · Straßensperren (Karte, Nachbarfreigaben, optionale Anfahrtsprüfung) · Förderstrecke (Wasserförderung planen)
Einsatzbegleitend	Fahrtenbuch · Atemschutz-Geräteprüfung · Drohne / UAS (Dokumentation gemäß RL-UAS LFV Vorarlberg 2024)
Verwaltung & Planung	Objekte (Einsatzunterlagen, Alarm-Matching, OCR-Suche, externe Objektpflege) · Probenplan (Jahresplanung, Appell, Nachbereitung, öffentlicher Kalender) · Planspiele (Übungsgenerator für Board und Großschadenslagen) · Mailing
Auswertung	Statistik (Kennzahlen und Diagramme zu den Einsätzen; Statistik-Infoscreen)

Großschadenslage, Alarmierung und Anbindung

Feature	Beschreibung
Großschadenslage & Stab	Phasen-Kanban, Einsatzstellen, SKKM-Regelkreis, Ressourcen, Lagekarte und Einheitenmodus für Fahrzeug-Tablets
Alarm-Integrationen	REST-API, LIS/IPR, DIBOS, SMS, E-Mail, Teams sowie Print & Alarm Gateway und Windows-Druckagent
PWA & mobile Nutzung	Offline-Betrieb, Push-Benachrichtigungen und QR-Schnellzugriff
Native Android-App	Sideload-APK mit zuverlässigem Push, Live-Einsatzstatus, Homescreen-Widgets und Offline-Datenbestand für Objekte & Kontakte
MCP-Server	OAuth-gesicherte KI-Anbindung für Einsätze, Großschadenslagen, Objekte, Kontakte, Einsatz- und Katastrophenpläne, Straßensperren und Fahrtenbuch
KI-Assistent	Optionale Auftragsvorschläge, Lagebilder und Priorisierung per Anthropic Claude
Multi-Org-Support	Mehrere Feuerwehren, gemeinsame Einsätze und strikt isolierte Stammdaten

→ Alle Funktionen im Wiki · Native Android-App im Wiki · Android-App-Repository

Tech-Stack

Schicht	Technologie
Backend	FastAPI auf Python 3.14, Uvicorn/Gunicorn
Daten	SQLAlchemy 2.x, Alembic, MariaDB 12.3
Frontend	Jinja2, HTMX, Alpine.js, Tailwind CSS, SortableJS
Karten	Leaflet, Leaflet-Geoman, Markercluster
Echtzeit & PWA	WebSockets, Service Worker, Web Push
Dokumente & Medien	WeasyPrint, pypdf, Pillow, ffmpeg
Deployment	NGINX, systemd, Gunicorn auf Port 8092

Quick Start (lokale Entwicklung)

Vorausgesetzt werden Python 3.14, MariaDB 12.3 (Docker, CI, Test- und Produktivsystem; ab 10.11 lauffähig, aber nicht mehr getestet), Node.js 22+ und optional ffmpeg.

git clone https://github.com/BattloXX/Einsatzcockpit.git
cd Einsatzcockpit
python3.14 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
npm install && npm run build
cp .env.example .env                    # DATABASE_URL und SECRET_KEY anpassen
alembic upgrade head && python -m app.seed_data
uvicorn app.main:app --reload --port 8092

Danach: http://localhost:8092. Docker-Datenbank, CSS-Watch-Modus, VAPID und plattformspezifische Hinweise stehen unter Lokale Entwicklung.

Installation (Produktion)

Die produktive Installation beginnt mit den Server-Voraussetzungen. Die anschließenden Wiki-Seiten führen durch Datenbank, App, systemd, NGINX, Erst-Setup, Backups und Updates.

Für einen containerisierten Betrieb baut GitHub Actions bei jedem Push auf main und jedem Release automatisch ein Image und veröffentlicht es nach ghcr.io/battloxx/einsatzcockpit; docker compose pull && docker compose up -d startet App, MariaDB und Redis ohne lokalen Build. Details unter Docker Compose.

Konfiguration

Die vollständige, kommentierte Referenz ist .env.example.

Vor jedem Produktivstart setzen: SECRET_KEY, FERNET_KEY, DATABASE_URL und COOKIE_SECURE=true; bei mehr als einem Worker zusätzlich REDIS_URL. Die Startup-Validierung bricht bei unsicherer Konfiguration ab. Siehe Installation-Troubleshooting.

Für den optionalen MCP-Server ist eine öffentliche HTTPS-URL als PUBLIC_BASE_URL erforderlich. Aktivierung, Limits und Proxy-Vorgaben: MCP-Server.

Datenbank-Migrationen

alembic upgrade head                         # ausstehende Migrationen anwenden
alembic current                              # aktuellen Stand anzeigen
alembic revision --autogenerate -m "text"   # Migration erzeugen
alembic downgrade -1                         # eine Revision zurückrollen

Pre-Flight-Checks, Reihenfolge, Rollback und bekannte Fallstricke: Migration-Runbook.

Frontend-Build

npm install
npm run build       # einmaliger Produktions-Build
npm run dev         # Tailwind Watch-Modus
npm run vendor      # nur bei Bibliotheks-Updates

Die generierte Datei app/static/css/app.css wird mitcommittet.

CLI

python -m app.cli create-admin --username admin --password 'sicheres-passwort'
python -m app.cli create-api-key --label "Alarmierungssystem" --org-id 1
python -m app.cli generate-vapid

Weitere Betriebsbefehle stehen in den jeweiligen Wiki-Kapiteln.

Dokumentation

Das Wiki ist die kanonische Quelle für Installation, Bedienung, Administration, Entwicklung und Betrieb.

Einstieg	Inhalt
Wiki-Startseite	Einstieg nach Aufgabe, alle Module in Menü-Reihenfolge (Quelle)
Erste Schritte	Login, Oberfläche, Menü und Tastaturkürzel
Einsatz starten	Vom Alarm bis zum laufenden Einsatz
Großschadenslage	Stab, Einsatzstellen, Ressourcen und Einheitenansicht
Einsatzwissen – Gesamtdokumentation	Bedienung, Dokumentpflege, Freigaben, KI, MCP, Architektur und Betrieb
Einsatzwissen – Phase 7	Dokumentreferenzen, Prüfmetadaten, PDF-Scrollen, MCP und Abschlussprüfung
Einsatzwissen – Phase 1	Bestandsaufnahme, Kategorien, Datenmodell, Kompatibilität und Migration
Einsatzwissen – Phase 6	Kompakte Einsatzansicht, Schnellzugriff, Suche, lokale Kerninhalte und mobile Abnahme
Dokumentenviewer – Phase 2	Gemeinsame PDF-/Bildanzeige, Dokumentfolgen, Seitenauswahl und Integration

Die Markdown-Quellen unter docs/wiki/ werden automatisch ins GitHub Wiki gespiegelt.

Tests

pytest -q -n auto
pytest tests/test_breathing.py tests/test_payload_validation.py -v
pytest --cov=app --cov-report=html tests/

Das Projekt besitzt eine umfangreiche Test-Suite; der aktuelle Status ist im CI-Badge sichtbar. Details zu Fixtures, Unit- und Integrationstests: Tests im Wiki.

Sicherheit

• Sichere Sessions, bcrypt-Passwörter, Login-Lockout und verpflichtende Produktions-Secrets
• Double-Submit-CSRF-Schutz und Rate-Limits pro IP beziehungsweise API-Key
• Row-Level-Tenant-Isolation mit zusätzlichen Zugriffskontrollen für gemeinsame Einsätze
• Geschützte Medienauslieferung mit MIME-Prüfung und UUID-Dateinamen
• MCP mit öffentlichen PKCE-Clients, gehashten Tokens und Live-Prüfung von Rollen und Modulstatus

→ Sicherheitsarchitektur und Betriebsanforderungen

REST-API

curl https://einsatzleiter.example.at/api/v1/einsatz/active \
  -H "X-API-Key: ec_xxxx"

Authentifizierung, Payloads, Validierungsregeln, Rate-Limits und weitere Beispiele: REST-API im Wiki.

Der MCP-Endpunkt ist getrennt von der REST-API und wird unter /mcp per OAuth verbunden: MCP-Server im Wiki.

Rollen und Organisationen

Rollen sind kombinierbar; System-, Organisations- und Fachrollen begrenzen Aktionen und Sichtbarkeit. Die vollständige Matrix steht unter Benutzer und Rollen.

Mehrere Feuerwehren können auf einer Instanz betrieben werden und explizit an Einsätzen zusammenarbeiten. Stammdaten bleiben tenant-isoliert; Details unter Organisationen verwalten und Architektur.

KI-Assistent

Der optionale Assistent liefert Auftragsvorschläge, Lage-Hinweise, Lagebilder, Einsatzbericht-Entwürfe und GSL-Priorisierung. Er ist standardmäßig deaktiviert und kann mit eigenem Anthropic-API-Key pro Organisation aktiviert werden; Konfiguration und Bedienung beschreibt Einstellungen.

In-App-Update

Systemadministratoren können ein geprüftes Release-ZIP einspielen; die App schützt vor Zip-Slip, migriert die Datenbank und lädt Gunicorn graceful neu. Der vollständige Ablauf steht unter Updates.

Betrieb

Produktivbetrieb umfasst neben Updates insbesondere automatisierte Datenbank- und Mediensicherungen, regelmäßige Restore-Proben, Off-Site-Kopien und die Kontrolle von Service- und Anwendungslogs. Das Betriebs-Runbook beschreibt die vorgesehenen Abläufe.

Autoren

Name	Rolle
Johannes Battlogg (@BattloXX)	Lead-Entwicklung, Konzept & Design
Roman Reiter	Fachberatung Einsatzleitung & Atemschutz

Version

Aktuell: 2026.10.28 · → Vollständige Versionshistorie

Lizenz

GNU Lesser General Public License v2.1 (LGPL-2.1) — Johannes Battlogg.