M8 – Läufe: Service und Abarbeitung #13

New Issue

2026-09-24T20:44:42Z

florian.wilde commented

2026-09-24 20:44:42 +00:00

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

Quelle: docs/issues/013-laeufe-abarbeitung.md — dort gepflegt, hierher gespiegelt.

**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 --- Quelle: `docs/issues/013-laeufe-abarbeitung.md` — dort gepflegt, hierher gespiegelt.

florian.wilde added this to the v0.1.0 milestone 2026-09-24 20:44:42 +00:00

florian.wilde added the phase-1 backend frontend labels 2026-09-24 20:44:42 +00:00

florian.wilde referenced this issue

2026-09-24 21:34:45 +00:00

Phase 1: MVP #1

florian.wilde referenced this issue

2026-09-24 21:34:45 +00:00

Phase 3: Protokoll, bedingte Schritte, Freigabe #3

florian.wilde referenced this issue

2026-09-25 10:52:32 +00:00

feat(stammdaten): Mitarbeiter, Abteilungen und Geraete #25

florian.wilde referenced this issue from a commit