Laufzettel/docs/issues/013-laeufe-abarbeitung.md

#013 M8 – Läufe: Service und Abarbeitung

Status: offen Meilenstein: v0.1.0 Labels: phase-1, backend, frontend Geschätzt: 14 h Tatsächlich: –

Ziel

Das Herz der Anwendung: ein Lauf wird vorbereitet, abgearbeitet, abgeschlossen und archiviert. Der Archiv-Schreibschutz sitzt an genau einer Stelle.

Aufgaben

• laufAnlegenService: aus veröffentlichter Version, Kunde per kundeErmitteln(), optional Mitarbeiter (Verzeichnis oder Freitext mitarbeiterName), optional Gerät, Ticket, Variablen, Zuweisung, Fälligkeit
• Ein Lauf kann als OFFEN angelegt werden, ohne ihn zu starten — das ist der Zuweisungs-Mechanismus, keine eigene Tabelle
• gestartetAm und IN_ARBEIT erst beim ersten Öffnen zur Bearbeitung
• Titelvorschlag <Vorlage> – <Hostname oder Mitarbeiter> – <Datum>
• schrittergebnisSetzenService: einzeln je Schritt (kein Gesamtformular), zustand, wert, notiz, aktualisiertVonId, Protokoll-Eintrag
• NICHT_ZUTREFFEND und FEHLGESCHLAGEN verlangen eine Notiz, sonst LaufFehler
• abschnittNichtZutreffendService: setzt alle Schritte eines Abschnitts mit einer Notiz auf NICHT_ZUTREFFEND (für die beiden Konto-Abschnitte im Onboarding)
• laufAbschliessenService: nur wenn alle Pflichtschritte ERLEDIGT oder NICHT_ZUTREFFEND sind; setzt abgeschlossenAm, abgeschlossenVonId
• laufArchivierenService und laufZurueckholenService (nur ADMIN), beide mit Protokoll-Eintrag
• laufMussVeraenderbarSein(lauf) zentral, aufgerufen vor jeder Änderung an Kopfdaten, Schrittergebnis und Kommentar
• Kommentare je Lauf und je Schrittergebnis
• „Mit AD-Konto verknüpfen“: ein Lauf mit mitarbeiterName wird nachträglich über UPN oder Name mit einem Mitarbeiter verbunden
• Start-Dialog: Vorlage → Mitarbeiter → Gerät (wählen, neu anlegen oder scannen) → Ticket, Variablen, Zuweisung, Fälligkeit; Vorbelegung je Aufrufort, Besitzer des Geräts als Mitarbeiter vorgeschlagen; Vorschläge aus den Namensregeln für upn, sam, mail
• Abarbeitungsansicht: einklappbare Abschnitte mit 01 ·-Nummerierung, Fortschrittsbalken in Lime, je Schritt Zustand, Wert, Notiz, Kommentare und „wer wann“
• Erledigte Schritte durchgestrichen in Nebentext-Farbe, Checkbox erledigt als Lime-Kachel mit dunklem Haken, Pflichtschritte mit rotem Stern
• BEFEHL-Schritte als Codeblock auf #0B0D10 mit Lime-Schrift, Kopier-Knopf, Warnung wenn ein Platzhalter unaufgelöst ist; je Abschnitt „Alle Befehle als Skript kopieren“
• ZAHL außerhalb von Min/Max wird markiert, aber nicht blockiert
• Route Handler GET /api/laeufe/[id]/zustand, Client pollt alle 10 s und pausiert bei verstecktem Tab
• Umschalter „Kompakt / Ausführlich“, ausführlich klappt alle Hilfetexte auf
• Abschließen und Archivieren als getrennte Aktionen
• Screenshots Start-Dialog, Lauf Desktop, Lauf Handy, Befehlsschritt in docs/screenshots/m8/

Akzeptanzkriterien

• Test: ein Lauf ohne Mitarbeiter und ohne Gerät lässt sich anlegen, abschließen und archivieren
• Test: Abschließen scheitert, solange ein Pflichtschritt OFFEN ist
• Test: NICHT_ZUTREFFEND ohne Notiz wird abgelehnt, mit Notiz akzeptiert
• Test: an einem archivierten Lauf schlagen Änderung eines Schrittergebnisses, eines Kommentars und der Kopfdaten fehl
• Test: nur ADMIN holt einen archivierten Lauf auf ABGESCHLOSSEN zurück, mit Protokoll-Eintrag
• Test: gestartetAm bleibt leer, solange der Lauf nur OFFEN ist
• Test: jede Änderung an einem Schrittergebnis, jeder Statuswechsel und jedes Veröffentlichen steht im Protokoll
• Test: die Abschnitts-Aktion setzt alle Schritte des Abschnitts mit derselben Notiz
• Zwei Browser auf demselben Lauf sehen die Änderung des anderen nach höchstens 10 s
• Am Handy bei 390 px kein horizontales Scrollen