Notfall-/Schaden-Alert — Architektur-Design (OP-ALERT-1)
Kernaussage. Der Notfall-/Schaden-Alert ist keine neue Parallel-Mechanik, sondern eine Variante des Klärfalls (OP-R3-1) mit drei harten Zusatzregeln: sofortiger Stopp aller laufenden Schritte, erzwungene Eskalation an die Leitung und Fahrzeug gesperrt („nicht weiter anfassen"). Damit gilt für den Werker die eine Regel „eskalieren statt verschlimmbessern" — nicht still selbst nachbessern, sondern Alarm schlagen und dokumentieren, damit die Beweislage gegenüber Kunde/Autohaus sauber bleibt.
Status: Slice 1 gebaut (v0.85.0) — Domäne + DO + Audit + Selbsttest + Alert-Knopf im geteilten Detail-Panel. Bezug: OP-ALERT-1 (Owning-OP) · OP-R3-1 (Klärfall, wiederverwendet) · OP-QS-1 (Foto-Doku, Folge-Slice) · OP-AUDIT-1 (unveränderlicher Beleg) · OP-KOMM-1 (Broadcast-Kanal). Zielgruppe: Anwender (Werkstatt-Team) · IT-Dev/Architektur · Business/Management (Haftung/Risiko). True North: Frage 2 (Standort/Bearbeitungsstand — das Fahrzeug ist gesperrt/blockiert) + die Termintreue-/Risiko-Sicht (ein Notfall ist ein Terminrisiko).
Warum (Anwender-Sicht, Meeting 12.07.2026)
Ein Schaden am Fahrzeug (Beule, Kratzer, Lackplatzer) fällt manchmal erst bei der Bearbeitung auf — unter dem Auto, an der Schwelle — obwohl er nicht vom Betrieb verursacht und bei der Annahme nicht sichtbar war. Der teuerste Fehler ist dann, dass ein Werker still selbst nachbessert (Praxisbeispiel: Montagekleber am Ferrari). Das zerstört die Beweislage. Der Alert dreht das um: ein auffälliger Knopf, der sofort stoppt, sperrt, dokumentiert und die Leitung alarmiert — damit die Leitung den Kunden proaktiv informieren kann („wir machen sofort ein Video, komm vorbei").
Leitprinzip Selbsterklärbarkeit: Werker denken nicht alle mit → der Ablauf ist ein Knopf, ein Pflichtfeld, ein Klick, bewusst schwer zu umgehen.
Wie (Design-Entscheidung: Klärfall-Variante statt Parallel-System)
Der reguläre Klärfall (OP-R3-1) kann einen Auftrag an jeder Stelle unterbrechen, hält Grund +
Eskalations-Flag + Beginn und wird geroutet gelöst (zurück · QS · anderer Schritt · Abbruch). Der Notfall
ist derselbe Kontext mit einem Diskriminator art: 'regulaer' | 'notfall' und Zusatzregeln —
Leitprinzip Einfachheit (kleinste tragfähige Lösung, bestehende Mechanik wiederverwenden):
| Regel | regulärer Klärfall | Notfall/Schaden |
|---|---|---|
| Laufende Schritte | pausiert (Unterbrechung) | pausiert (Hard-Stop) |
| Eskalation | optional (opt-in) | erzwungen (hart true) |
| Fahrzeug gesperrt | nein | ja (fahrzeugGesperrt = art === 'notfall', abgeleitet, D-2) |
| Auflösung | Klärungs-Engine (§5.1) | dieselbe Klärungs-Engine (zurück/QS/Schritt/Abbruch) |
| Audit-Event | klaerfall.gemeldet | notfall.gemeldet (eigener Event-Typ, OP-AUDIT-1) |
Implementierung (Slice 1, v0.85.0)
- Domäne (
server/src/operativ/auftrag.ts):KlaerfallArt+artamKlaerfallKontext;meldeNotfall(auftrag, grund, jetzt, teilschrittInstanzId?)(komponiertpausiereLaufendeSchritte+setzeKlaerfall(art:'notfall', eskaliert:true));fahrzeugGesperrt(auftrag)(abgeleitet). Ein einmal erklärter Notfall lässt sich nicht per regulärem Update herabstufen. - DO (
server/party/leitstand.ts): Messageauftrag.klaerfallumart?: 'notfall'erweitert → eigener Notfall-Zweig mit Chronik-Eintrag + Auditnotfall.gemeldet(Grund + gestoppte Schritte). Broadcast an alle Verbindungen erfolgt wie bei jeder State-Änderung. - Persistenz (
do-state-migrations.tsv21): Backfillart: 'regulaer'auf bestehende Klärfälle. - Client (
services/leitstand.service.ts·auftrag-detail-panel.component.ts):auftragNotfall(...); auffälliger 🚨 Notfall / Schaden-Knopf + Pflicht-Grund-Formular im geteilten Detail-Panel; Kopf-Badge 🚨 Fahrzeug gesperrt statt „⚠ Klärfall", solange der Notfall offen ist. - Selbsttest (
test:notfall, CI-Gate): Hard-Stop laufender Schritte · Eskalation erzwungen · Sperre · regulärer Klärfall sperrt nicht · keine Herabstufung · Lösen hebt die Sperre auf.
Offen (Folge-Slices — mit PO/Anwendern schärfen)
- Foto-/Video-Zwang (OP-QS-1): Beweismittel beim Alarm erzwingen — dieselbe Ein-Schritt- Markier-/Verpixel-Mechanik wie der Feedback-Editor (OP-AI-4 Slice 14) wiederverwenden.
- Alarm-Optik/-Ton auf dem Leit-Bildschirm (OP-KOMM-1): priorisierter Broadcast, „Alarmanlage"- Optik, damit die Leitung sofort eingreift.
- Alert-Knopf auch im Werker-Modus („Meine Arbeit") direkt am Schritt — großflächig, touch-tauglich.
- Freigabe-Workflow der Leitung ausdifferenzieren (wer darf entsperren; QS-Vier-Augen-Bezug G-4).
↩ Zurück zur Doku-Landkarte · Lesepfade · Register (alle OPs)