Notfall-System

Das Notfall-System ermoeglicht es Mitarbeitern, direkt vor Ort einen Notfall-Einsatz zu erstellen und sofort mit der Arbeit zu beginnen. Der komplette Ablauf -- von der Meldung ueber die Dokumentation bis zur Rechnungsstellung -- wird digital abgewickelt.

Feature-Aktivierung

Notfall-Einsaetze muessen von einem Admin in Einstellungen -> Projekttypen aktiviert werden. Zusaetzlich muss das Feature-Flag EMERGENCY auf Server-Ebene aktiviert sein. Erst dann erscheint der Notfall-Button in der Worker-App.

Ueberblick

Mitarbeiter meldet Notfall (Worker-App)
  -> Kunde wird zugeordnet oder neu angelegt
  -> Notfall wird beschrieben (Dringlichkeit, Dauer, Ort)
  -> Einsatz wird erstellt und optional sofort gestartet
  -> Buero wird automatisch per Push benachrichtigt
  -> Mitarbeiter dokumentiert Arbeit (Bautagebuch)
  -> Buero genehmigt und erstellt Rechnung

Fuer Mitarbeiter: Notfall melden

Einstiegspunkt

Auf dem Worker-Dashboard erscheint ein schwebender Aktionsbutton (FAB) am rechten unteren Bildschirmrand. Wenn nur das Notfall-Feature aktiv ist, erscheint ein direkter roter Button mit dem Text "Notfall-Einsatz erstellen". Wenn mehrere Quick-Actions verfuegbar sind (z.B. Zeiterfassung und Notfall), oeffnet sich beim Tippen auf den Plus-Button ein Menue mit allen Optionen.

Der Notfall-Button oeffnet einen 3-Schritte-Wizard als BottomSheet, das 90% der Bildschirmhoehe einnimmt.

Schritt 1: Kunde auswaehlen

Im ersten Schritt wird der betroffene Kunde festgelegt:

• Bestehenden Kunden suchen -- Tippen Sie den Namen oder die Telefonnummer ein. Die Suche unterstuetzt Mehrwort-Suche (jedes Wort muss im Namen oder der Telefonnummer vorkommen)
• Neuen Kunden anlegen -- Falls der Kunde noch nicht existiert, tippen Sie auf "Neuen Kunden anlegen" und geben Sie folgende Daten ein:

Feld	Pflicht	Beschreibung
Name	ja	Name der Person oder Firma
Telefon	nein	Telefonnummer fuer Rueckfragen
Strasse	nein	Strassenadresse
PLZ	nein	Postleitzahl
Ort	nein	Stadt/Gemeinde

• Duplikat-Erkennung -- Bei der Kundenanlage wird automatisch geprueft, ob bereits ein Kunde mit identischem Namen existiert (Gross-/Kleinschreibung wird ignoriert). Falls ja, wird der bestehende Kunde wiederverwendet statt einen Duplikat-Eintrag zu erzeugen

Nach der Kundenauswahl gelangen Sie automatisch zum naechsten Schritt.

Schritt 2: Notfall beschreiben

Hier erfassen Sie alle Details zum Notfall:

Feld	Pflicht	Beschreibung
Titel / Problem	ja	Kurze Beschreibung des Problems (z.B. "Rohrbruch im Keller")
Beschreibung	nein	Detaillierte Problembeschreibung mit weiteren Informationen
Dringlichkeit	ja	Vierstufige Auswahl: Niedrig, Mittel, Hoch, Kritisch (Standard: Hoch)
Ort / Adresse	nein	Genaue Ortsangabe (z.B. "Kellergeschoss, Raum B2")
Geschaetzte Dauer	ja	Vorauswahl: 1h, 2h, 3h, 4h, 6h oder 8h (Standard: 4h)

Entwurf wird gespeichert

Falls Sie den Wizard zwischendurch verlassen (z.B. durch einen eingehenden Anruf), wird Ihr Fortschritt automatisch als Entwurf im Browser gespeichert. Beim naechsten Oeffnen des Wizards koennen Sie dort weitermachen, wo Sie aufgehoert haben. Der Entwurf wird nach erfolgreichem Absenden automatisch geloescht.

Schritt 3: Bestaetigen und Starten

Die Zusammenfassung zeigt alle eingegebenen Daten auf einen Blick:

• Kunde
• Problem/Titel
• Dringlichkeitsstufe
• Geschaetzte Dauer
• Ort (falls angegeben)
• Beschreibung (falls angegeben)

Sie haben zwei Optionen:

Option	Beschreibung
Sofort starten (roter Button)	Der Einsatz wird erstellt, sofort als "In Bearbeitung" markiert und die Zeiterfassung beginnt automatisch ab dem aktuellen Zeitpunkt
Nur erstellen	Der Einsatz wird als "Geplant" erstellt. Sie koennen ihn spaeter manuell starten

Nach dem Einsatz

Erstellen Sie wie gewohnt einen Bautagebuch-Eintrag ueber den Dokumentation-Wizard. Dieser durchlaeuft den normalen Genehmigungsprozess durch das Buero.

Was passiert im Hintergrund?

Beim Erstellen eines Notfall-Einsatzes werden automatisch folgende Schritte in einer einzigen Datenbank-Transaktion ausgefuehrt (alles-oder-nichts):

1. Kunde aufloesen -- Bestehender Kunde wird gefunden, oder ein neuer wird angelegt (mit Duplikat-Pruefung)
2. Sammel-Projekt finden oder erstellen -- Pro Kunde existiert genau ein Projekt vom Typ "Notfaelle - [Kundenname]". Gibt es bereits eines, wird es wiederverwendet
3. Kommunikations-Channel -- Bei neuen Projekten wird automatisch ein Team-Chat erstellt
4. Team zuweisen -- Admin-Benutzer werden immer zugewiesen. Buero-Mitarbeiter und Projektleiter werden basierend auf der Konfiguration automatisch als Projektmitglieder und Chat-Teilnehmer hinzugefuegt
5. Notfall-Aufgabe erstellen -- Eine Aufgabe vom Typ notfall_einsatz mit Dringlichkeit, Beschreibung und Notfall-Metadaten wird im Sammel-Projekt angelegt
6. Mitarbeiter zuweisen -- Der meldende Mitarbeiter wird automatisch der Aufgabe zugewiesen. Die Zeitplanung wird auf den aktuellen Zeitpunkt plus geschaetzte Dauer gesetzt
7. Benachrichtigung -- Alle Admin-, Office- und Projektleiter-Benutzer der Firma erhalten eine Push-Benachrichtigung (asynchron, blockiert nicht die Einsatz-Erstellung)

Sammel-Projekt-Konzept

Fuer jeden Kunden gibt es genau ein Notfall-Sammel-Projekt. Wenn derselbe Kunde mehrere Notfaelle hat, werden diese als separate Aufgaben im selben Projekt zusammengefasst. Das haelt die Projektliste uebersichtlich und buendelt alle Einsaetze pro Kunde an einer Stelle.

Dringlichkeitsstufen

Stufe	Farbe	Bedeutung	Prioritaet im System
Kritisch	Rot	Sofortige Gefahr, unverzuegliches Handeln erforderlich	Dringend (urgent)
Hoch	Orange	Wichtiger Notfall, baldiges Handeln noetig	Hoch (high)
Mittel	Gelb	Kein akuter Notfall, aber zeitnah zu bearbeiten	Mittel (medium)
Niedrig	Blau	Kann geplant werden, keine unmittelbare Gefahr	Mittel (medium)

Die Dringlichkeitsstufe bestimmt automatisch die Prioritaet der erstellten Aufgabe und beeinflusst die visuelle Darstellung in allen Ansichten.

Notfall-Einsaetze im Worker-Dashboard

Aktive Notfall-Einsaetze werden im Worker-Dashboard besonders hervorgehoben:

• Aktiver Einsatz (Hero-Karte) -- Rot-verlaufender Hintergrund (statt blau bei normalen Einsaetzen) mit Warnsymbol
• Geplante Einsaetze (Karten) -- Roter Seitenrand und roetlicher Hintergrund, um sie von regulaeren Aufgaben abzuheben
• Timeline-Ansicht -- Rote Punkte und rote Kartenhintergruende, mit "Notfall"-Badge an jedem Einsatz
• Drei Aktionen: Starten, Abschliessen und Bericht schreiben (Bautagebuch)

Das System erkennt Notfall-Einsaetze automatisch am Projektnamen (beginnt mit "Notfaelle -").

Fuer Buero und Projektleitung: Notfaelle verwalten

Benachrichtigung

Sobald ein Mitarbeiter einen Notfall meldet, erhalten alle Admin-, Buero- und Projektleiter-Benutzer eine Push-Benachrichtigung mit:

• Name des Mitarbeiters, der den Notfall gemeldet hat
• Kundenname
• Problembeschreibung (Titel des Einsatzes)
• Dringlichkeitsstufe (mit deutscher Bezeichnung)

Die Benachrichtigung verlinkt direkt zum Notfall-Projekt.

Notfall-Projekte in der Projektliste

• Notfall-Projekte haben den Projekttyp notfall und sind mit einem roten "Notfall-Sammelprojekt"-Badge gekennzeichnet
• Projektname-Konvention: "Notfaelle - [Kundenname]"
• Der Projektstatus ist standardmaessig "Aktiv" mit Prioritaet "Hoch"

Notfall-Projektansicht

Die Detailansicht eines Notfall-Sammel-Projekts zeigt drei Bereiche mit einer klebenden (sticky) Scroll-Navigation:

Einsaetze

Tabellarische Uebersicht aller Notfall-Aufgaben des Kunden:

Spalte	Beschreibung
Datum	Erstellungszeitpunkt des Einsatzes (Datum und Uhrzeit)
Projekt	Name des Sammel-Projekts (Link zum Projekt)
Worker	Name und Avatar des zugewiesenen Mitarbeiters
Kunde	Kundenname
Problem	Titel/Kurzbeschreibung des Notfalls
Dringlichkeit	Farblich codierte Dringlichkeitsstufe
Status	Offen, In Bearbeitung, Abgeschlossen oder Abgebrochen

Durch Klicken auf eine Zeile klappt ein Detail-Bereich auf mit:

• Vollstaendige Beschreibung
• Ortsbeschreibung
• Geschaetzte Dauer
• Problemkategorie
• Gemeldet von (Name und Telefonnummer mit Direktanruf-Link)
• Ankunftszeit
• Loesungszusammenfassung
• Link "Zum Projekt" fuer den Direktsprung

Einsaetze koennen per Checkbox ausgewaehlt werden, um eine Sammel-Rechnung fuer mehrere Einsaetze gleichzeitig zu erstellen.

Abrechnung

Dieser Bereich zeigt die finanziellen Daten des Projekts:

• Genehmigte Arbeitsstunden mit Stundensaetzen
• Materialkosten (einzeln aufgelistet)
• Gesamtkosten-Uebersicht

Dokumentation

Hier finden Sie alle projektbezogenen Unterlagen:

• Fotos vom Einsatz (hochladen, ansehen, loeschen)
• Notizen (erstellen und verwalten)

Rechnungsstellung

Fuer die Abrechnung von Notfall-Einsaetzen gibt es zwei Wege:

Einzelne Einsaetze abrechnen:

1. Oeffnen Sie das Notfall-Projekt
2. Klicken Sie in der Einsaetze-Tabelle auf das Rechnungssymbol neben einem einzelnen Einsatz

Mehrere Einsaetze zusammen abrechnen:

1. Oeffnen Sie das Notfall-Projekt
2. Waehlen Sie die gewuenschten Einsaetze per Checkbox aus
3. Klicken Sie auf den "Rechnung (X Einsaetze)"-Button in der Kopfzeile

Alternativ ueber den Header:

1. Klicken Sie auf den "Rechnung"-Button im Projekt-Header (rechts oben)
2. Dies erstellt eine Rechnung fuer alle Einsaetze des Projekts

Der Rechnungseditor wird mit automatisch vorbefuellten Daten geoeffnet. Die Rechnungsdaten werden ueber einen speziellen API-Endpunkt geladen und enthalten:

• Arbeitspositionen je Einsatz -- Stunden multipliziert mit dem individuellen Stundensatz (oder dem Firmen-Standardsatz von 65 EUR/h als Fallback)
• Materialpositionen -- Ueber das Budget-System zugeordnete Materialien pro Einsatz
• Zusammenfassung -- Gesamtstunden, Gesamt-Arbeitskosten, Gesamt-Materialkosten und Gesamtbetrag

Konstruktor-Integration

Falls die Konstruktor-Rechnungsstellung aktiviert ist, oeffnet sich der Konstruktor-Editor automatisch. Andernfalls wird der native Rechnungseditor verwendet.

Projekt abschliessen

Wenn alle Einsaetze eines Kunden erledigt und abgerechnet sind:

1. Klicken Sie auf den gruenen "Abschliessen"-Button im Projekt-Header
2. Bestaetigen Sie im Dialog -- das Projekt wird als "Abgeschlossen" markiert
3. Das Abschliessen kann bei Bedarf rueckgaengig gemacht werden

Genehmigung

Nach dem Einsatz dokumentiert der Mitarbeiter seine Arbeit im Bautagebuch. Das Office prueft und genehmigt:

1. Der Bautagebuch-Eintrag erscheint in der Genehmigungszentrale (Tab "Ausstehend")
2. Office prueft Stunden, Material und Beschreibung
3. Genehmigen oder Ablehnen (mit Begruendung)
4. Bei Genehmigung werden Kosten automatisch ins Projekt-Budget uebernommen

Nach Genehmigung

Stunden und Beschreibung sind nach der Genehmigung unveraenderlich (gemaess Paragraph 16 ArbZG). Nur Preise (Stundensatz, Materialkosten) koennen nachtraeglich angepasst werden.

Einstellungen

Feature aktivieren (zwei Ebenen)

Das Notfall-System erfordert Aktivierung auf zwei Ebenen:

1. Feature-Flag (Server-Ebene) -- Die Umgebungsvariable FEATURE_EMERGENCY=true muss gesetzt sein. Dies ist ein Opt-in-Feature
2. Firmen-Einstellung -- Ein Admin muss unter Admin -> Einstellungen -> Projekttypen den Schalter Notfall-Einsaetze aktivieren (emergencyAssignmentsEnabled in den Company Settings)

Beide Bedingungen muessen erfuellt sein, damit der Notfall-Button in der Worker-App erscheint und die API-Endpunkte funktionieren.

Notfall-spezifische Einstellungen

In den Firmen-Einstellungen unter notfallSettings koennen folgende Optionen konfiguriert werden:

Einstellung	Beschreibung
Standard-Stundensatz	Stundensatz fuer Notfall-Einsaetze (ueberschreibt den allgemeinen Firmensatz)
Zuschlag in Prozent	Prozentualer Aufschlag auf den Stundensatz fuer Notfall-Arbeit
Problemkategorien	Liste vordefinierter Kategorien (z.B. "Rohrbruch", "Stromausfall", "Heizungsausfall")

Automatische Zuweisung konfigurieren

Bestimmen Sie, wer automatisch neuen Notfall-Projekten zugewiesen wird:

Rolle	Standard	Konfigurierbar
Admin	Immer zugewiesen	nein
Buero-Mitarbeiter	Zugewiesen	ja
Projektleiter	Zugewiesen	ja

Die Konfiguration erfolgt unter Admin -> Einstellungen -> Projekttypen -> Automatische Zuweisung (Abschnitt autoAssignment.notfall in den Company Settings).

Berechtigungen

Aktion	Admin	Backoffice	Projektleiter	Mitarbeiter
Feature aktivieren	ja	nein	nein	nein
Notfall melden (Worker-App)	--	--	--	ja
Alle Notfall-Einsaetze einsehen	ja	ja	ja	nein
Eigene Einsaetze einsehen	--	--	--	ja
Materialien verwalten	ja	ja	ja	nein
Fotos und Notizen hinzufuegen	ja	ja	ja	ja
Fotos und Notizen loeschen	ja	ja	ja	nein
Stunden genehmigen	ja	ja	nein	nein
Rechnung erstellen	ja	ja	nein	nein
Projekt abschliessen	ja	ja	ja	nein

Worker-Sichtbarkeit

Worker sehen in der Einsatz-Uebersicht nur ihre eigenen Notfall-Einsaetze. Admin-, Buero- und Projektleiter-Benutzer sehen alle Einsaetze der Firma.

Notfall-Metadaten

Jeder Notfall-Einsatz speichert zusaetzliche Metadaten im emergencyMetadata-Feld der Aufgabe:

Feld	Beschreibung
Dringlichkeitsstufe	low, medium, high oder critical
Problemkategorie	Frei waehlbare oder vordefinierte Kategorie
Gemeldet von (Name)	Wer hat den Notfall gemeldet (z.B. der Bewohner)
Gemeldet von (Telefon)	Rueckrufnummer des Melders
Erstellt von (Worker-ID)	Welcher Mitarbeiter den Einsatz erfasst hat
Ankunftszeit	Wann der Mitarbeiter vor Ort eingetroffen ist
Loesungszusammenfassung	Kurzbeschreibung der durchgefuehrten Arbeiten
Kundenunterschrift	Digitale Unterschrift des Kunden vor Ort

Verbindungen zu anderen Modulen

Das Notfall-System ist kein eigenstaendiges Modul, sondern greift tief in bestehende Module ein. Bei der Erstellung eines Notfalls werden automatisch Datensaetze in bis zu fuenf anderen Modulen angelegt.

Verbindung zu Projekten

Jeder Notfall erstellt automatisch ein Sammel-Projekt fuer den Kunden (Namenskonvention: "Notfaelle - [Kundenname]"). Existiert bereits ein Sammel-Projekt fuer diesen Kunden, wird es wiederverwendet. Alle Notfall-Einsaetze eines Kunden landen im selben Sammel-Projekt als separate Aufgaben. Das haelt die Projektliste uebersichtlich.

Datenfluss: Notfall-Wizard → Kunde zuordnen → Sammel-Projekt finden/erstellen → Aufgabe im Projekt anlegen

Siehe auch: Projekte

Verbindung zur Einsatzplanung

Der Notfall erstellt automatisch eine Aufgabe UND einen Einsatz. Der Worker wird sofort zugewiesen und sieht den Notfall-Einsatz in seiner Worker-App mit roter Markierung (statt blau fuer normale Einsaetze). Die Zeitplanung wird auf den aktuellen Zeitpunkt plus geschaetzte Dauer gesetzt.

Datenfluss: Notfall erstellt → Aufgabe im Sammel-Projekt → Worker zugewiesen → Einsatz erscheint in Worker-App (rot)

Siehe auch: Einsatzplanung, Worker-App

Verbindung zum Bautagebuch

Der Notfall-Einsatz wird nach Abschluss wie ein normaler Bautagebuch-Eintrag behandelt. Der Worker erstellt einen Bericht ueber den Dokumentation-Wizard, der denselben Genehmigungsprozess durchlaeuft: Einreichung → Pruefung durch Buero → Genehmigung/Ablehnung. Nach Genehmigung werden Stunden und Kosten automatisch ins Projekt-Budget uebernommen. Es gilt der gleiche Y-Split (Dual-Signature-Workflow) wie bei regulaeren Eintraegen.

Datenfluss: Einsatz abgeschlossen → Worker erstellt Bautagebuch-Eintrag → Genehmigungszentrale → Kosten fliessen ins Budget

Siehe auch: Bautagebuch, Genehmigungen

Verbindung zu Rechnungen

Notfall-Einsaetze koennen direkt aus der Notfall-Projektuebersicht heraus abgerechnet werden -- entweder als Einzelrechnung (pro Einsatz) oder als Sammelrechnung (mehrere Einsaetze per Checkbox auswaehlen). Die Rechnungspositionen werden automatisch aus den genehmigten Bautagebuch-Eintraegen generiert: Arbeitsstunden x individueller Stundensatz (oder Firmen-Standardsatz von 65 EUR/h) plus zugeordnete Materialkosten.

Datenfluss: Genehmigte Eintraege → Rechnungspositionen werden automatisch befuellt → Rechnung erstellen (Konstruktor oder nativ)

Siehe auch: Rechnungen

Verbindung zum Chat

Bei der Notfall-Erstellung wird automatisch ein Chat-Kanal fuer das Sammel-Projekt erstellt (bei neuem Projekt) oder genutzt (bei bestehendem Projekt). Admin-, Buero- und Projektleiter-Benutzer werden automatisch als Mitglieder hinzugefuegt. So kann die Koordination des Notfall-Einsatzes sofort im Projekt-Chat stattfinden.

Datenfluss: Neues Sammel-Projekt → Chat-Kanal wird erstellt → Team-Mitglieder werden zugewiesen

Siehe auch: Kommunikation

Verbindung zur Kundenverwaltung

Der Notfall-Wizard sucht existierende Kunden per Mehrwort-Suche (Name oder Telefonnummer) oder erstellt schnell einen neuen Kunden (Quick-Create). Dabei greift eine Deduplizierung: Existiert bereits ein Kunde mit identischem Namen (Gross-/Kleinschreibung ignoriert), wird der bestehende Kunde wiederverwendet statt ein Duplikat anzulegen.

Datenfluss: Worker sucht Kunden → gefunden: bestehenden verwenden / nicht gefunden: Quick-Create mit Deduplizierung

Siehe auch: Herzstück

Naechste Schritte

• Worker-App -- So nutzen Mitarbeiter die Worker-App im Alltag
• Kommunikation -- Der automatisch erstellte Team-Chat fuer jedes Notfall-Projekt
• Gefaehrdungsbeurteilung -- Sicherheitsdokumentation fuer Projekte