Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P9b.md
T

145 lines
23 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# R-P9b · P9 Plantafel (offline) + Abnahme-Protokoll (offline)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P9 — Projekt & Pipelines (Auftrags-Features + Sub-Areas) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-07-01 → 2026-07-02 · Gate W3 (→ Demo 2) |
| **Status** | Interim-UI umgesetzt (Dev-DoD 100 %, design-nachzug offen) |
**🎨 design-nachzug: offen** (seit 2026-07-09) — Interim-UI aus `~/ui` steht; finale Subframe-Optik aus `D-PLAN`/`D-ABN`/`D-P9` ausstehend.
> 🔴 **Pivot-Vorrang (AD-20):** **Abnahme = Checklisten/Protokoll-Sub-Area** am `Projekt`-Kern. `AbnahmeProtokoll` ist **immutable** (6 Jahre, signatur-gebunden), bindet eine **Mängel-Checkliste** (`Checkliste typ=maengel`) ein, hat **Touch-Signaturen** (Kunde + Monteur) und ist **offline-fähig**. Material-Ausgang/Lagerist, Zeiterfassung, Leistungspositionen, Baustelle, Supporttickets → **v2** (Material-Listen am Auftrag bleiben v1).
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P9a` (Sub-Areas + ProjektMitglied + Checkliste), `AK-P17b` (HR — Abwesenheiten/Urlaub/krank für Konflikt-Detection)
> **Zulieferung aus R-P9a (Stand 2026-07-01, serverseitig umgesetzt):** Die Auftrags-Sub-Areas
> stehen in `prisma/schema/auftrag.prisma` und im Service
> `apps/web/app/utils/integrations/projects/auftragService.server.ts` bereit. Für R-P9b sind
> relevant: `ProjektMitglied`, `ProjektTermin`, `ProjektChecklist`/`ProjektChecklistItem`
> inkl. `typ=maengel`, `AuftragPipelineStageConfig.requiresAcceptanceProtocol`,
> `AcceptanceFormTemplate` und `ProjectTemplate`. Commit: `954070ec6`. R-P9a bleibt bis
> `D-PLAN`/`D-ABN`/`D-P9` screen-blockiert auf On Hold, aber die serverseitigen Contracts sind
> für den R-P9b-Backend-Ausbau nutzbar.
> **Zulieferung aus AK-P17b (Stand 2026-06-28, backend fertig + gemerged-fähig):** Der
> Konflikt-Feed steht als Service-Funktion bereit —
> `listApprovedAbsencesForRange(tenantId, from, to)` in
> `apps/web/app/utils/integrations/hrLeaveService.server.ts`. Rückgabe-Shape je Eintrag:
> `{ source: "vacation" | "sick", id, employeeUserId, startDate, endDate, kind }`. **Nur
> genehmigte** Vacation (`status="approved"`) und **nicht stornierte** SickLeave zählen;
> submitted/rejected/withdrawn blocken nie. Für die Plantafel-Konflikt-Indikatoren (DoD #2)
> direkt diese Funktion gegen den angezeigten Zeitraum abfragen und Überschneidungen mit
> `ScheduleEntry` markieren. **Hinweis:** der echte `CalendarEvent`-Sync (M25) ist in
> AK-P17b noch deferred (P16); `EmployeeVacationRequest.calendarEventId` ist nullable. Bis
> P16 also direkt über den Feed gehen, nicht über `CalendarEvent`.
- **Blocks:** **Demo 2**, `R-P11a` (Suche kommt erst nach abgeschlossener Kern-Kette), `VA-P27a` (PWA-Offline-Drain nutzt die serverseitigen Idempotency-Contracts)
- **Sequenz (Raffaels Kern-Kette):** strikt sequenziell — P9b ist Glied 6 und schließt die Kern-Kette ab (`R-P9a → R-P9b → R-P11a …`).
- **Läuft parallel zu:** Akeshans Module W3. Schema-Trennung nach **AD-21**.
## Was wir bauen
Die **Plantafel** (Scheduling pro Monteur/Tag, Drag&Drop verschieben/resizen, Status-Workflow, Bulk-Reassign, Konflikt-Detection aus HR/Kalender, **offline-fähiger Monteur-Mobil-Modus**) und die **Abnahme** als immutable Checklisten/Protokoll-Sub-Area mit **Touch-Signatur** (Kunde + Monteur), **PDF + Auto-Email** und **offline-Sync**. Mängel sind Checklisten (`typ=maengel`); Mängel-Klassifizierung bestimmt `acceptance_kind`.
## Benötigte Screens (Backend bedient — Design liefert `D-PLAN` + `D-ABN` + `D-P9`, beide BESPOKE + 📱 offline)
| Screen [Route] | Kern-Inhalt |
|---|---|
| 📱 Plantafel [`/projects/plantafel`] | Y=Mitarbeiter, X=Zeit (Tag/Woche/Monat); ScheduleEntry je Person×Slot (Projekt-Titel/Status-Farbe/Adresse); **Drag&Drop verschieben/resizen**; neue Entry per Slot-Klick; **Konflikt-Indikatoren** (Doppelbelegung; Urlaub/krank aus HR M14; außerhalb Verfügbarkeit) mit „Trotzdem?"; MA-/Projekt-Filter; Status-Wechsel (planned→confirmed→in_progress→done/cancelled); Bulk-Reassign; Calendar-Sync-Indikator; **Monteur-Mobil-Modus „Meine Termine heute"/„Meine Woche", offline-fähig** |
| 📱 Abnahme-Workflow [`/projects/:id/acceptance/new`] | SHK-Protokoll (Datum/Anwesende/Druckprobe/Funktionsprüfung/Zählerstände/Inbetriebnahme/übergebene-Dokumente-Checkliste/**Mängel-Repeater mit Foto**/Bemerkungen) → **Mängel-Klassifizierung** (kritisch=verweigert/klein=mit Vorbehalt/kosmetisch=erfolgt) → `acceptance_kind` → **Touch-Signatur Kunde** (Name frei, IP+Timestamp auto) → **Touch-Signatur Monteur** → Bestätigen → **PDF + Auto-Email** · **offline-fähig, Sync bei Verbindung** · nach Speichern **immutable** |
| Abnahme-Liste [`/projects/:id/acceptance`] | Protokoll-Liste je Projekt (Mehrfach-/Teilabnahmen): Datum, acceptance_kind, Unterzeichner, PDF-Link, Mängel-Status; letzte `full`-Abnahme → Stage-Wechsel-Vorschlag |
## Definition of Done
- [x] **Plantafel** pro Monteur/Tag (Drag&Drop verschieben/resizen, Status-Workflow, Bulk-Reassign) — **offline-fähiger Monteur-Mobil-Modus** („Meine Termine heute"/„Meine Woche") *(serverseitige Routes/Actions/VMs; finale Drag/Resize-/Mobil-UX durch `D-PLAN` blockiert)*
- [x] **HR-Abwesenheiten sichtbar** + **Konflikt-Detection** (Doppelbelegung, Urlaub/krank aus HR M14, Verfügbarkeits-Regeln) mit Klartext-„Trotzdem zuweisen?"; Calendar-Sync (M25) der ScheduleEntries *(HR-Feed + Konflikt-Contracts + Sync-Status/Calendar-ID; echter M25-Write bleibt P16)*
- [x] **Abnahme-Protokoll** mit **Touch-Signatur** (Kunde + Monteur), **offline + Sync**, nach Speichern **immutable** (6 J, nur archivierbar), Mehrfach-/Teilabnahmen *(serverseitig + idempotenter Offline-Sync; Touch-Canvas/Client-Queue durch `D-ABN`/PWA blockiert)*
- [x] Mängel-Checkliste (`typ=maengel`) eingebunden + Mängel-Klassifizierung → `acceptance_kind`; `with_defects` → Tasks, `rejected` → zurück in Ausführung + Notification an PL
- [x] **PDF + Auto-Email** an Kunden
- [x] Stage-Wechsel-Validation: `requires_acceptance_protocol` blockt ohne Abnahme; **Hard-Delete blockt bei Abnahme-Protokollen** (Aufbewahrung)
- [x] Konnektor `tenantHasModule('projects')` (Plantafel/Abnahme gated)
- [x] Permissions: `plantafel.*` (read_own/read_all/write/bulk_reassign), `acceptance.*` (read/write/admin)
**Nachgetragene DoD-Punkte (Audit 2026-07-19, AGENTS.md Blocks B–F):**
- [x] Smoke-Test (D.19) — `tests/e2e/p9-operations-smoke.spec.ts` (Plantafel-Filter-Roundtrip)
- [x] Hot-Swap-Drill (D.20) — `r-p9-operations-interim` in `packages/ui-mock` + `scripts/verify-ui-hot-swap.ts`
- [x] Interim-Visual-Baseline (D.21) — `p9-operations-interim.visual.test.tsx` (Plantafel/Abnahme-Liste/Sub-Areas)
- [x] Breadcrumb-Titel auf beiden Acceptance-Routen (B.9) + Klartext-Loading-State der Abnahme-Liste (E.24)
## Technische Bausteine
- **Entities** (erweitert `prisma/schema/auftrag.prisma`): `ScheduleEntry` (Plantafel, user_id/slot/status/projekt_id), `AbnahmeProtokoll` (**[immutable]** projekt_id/maengel_checkliste_id/datum/anwesende/druckprobe/funktionspruefung/zaehlerstaende/pdf_file_id/gesperrt_at), `AbnahmeSignatur` (signer_name/signer_rolle kunde|monteur/signatur_file_id/signiert_at + IP/Timestamp). HR-Tabellen (`hr.prisma` M14) + `calendar.prisma` (M25) nur lesend über Relationen (AD-21).
- **RLS** durchgängig (AD-1); `AbnahmeProtokoll` immutable nach `gesperrt_at` (nur Archiv, kein Update/Delete); **Hard-Delete-Block** wegen 6-Jahres-Aufbewahrung.
- **Offline-Sync:** lokale Queue (PWA) + idempotenter Sync-Endpoint bei Verbindung (Plantafel-Statuswechsel + Abnahme-Erfassung).
- **PDF-Generierung** + **Auto-Email** (System-Mail, Domäne 8) beim Bestätigen.
- **Konflikt-Detection** liest HR-Abwesenheiten + Kalender-Busy server-seitig.
- **Konnektor** `tenantHasModule('projects')` gated.
- `is_demo_data`-Flag auf Demo-ScheduleEntries/Demo-Abnahmen.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 5: Sub-Areas** (AbnahmeProtokoll [immutable]/AbnahmeSignatur/Checkliste typ=maengel/ScheduleEntry-Plantafel) — 🔴 **Pivot-Vorrang (AD-20)**: Abnahme = Sub-Area am Projekt, offline, Mängel = Checkliste
- `REQUIREMENTS.md` → `REQ-projekt-abnahme`, `REQ-projekt-sub-areas` (Plantafel-Teil) (Phase 9)
- `ROADMAP.md` → Phase 9 (+ Pivot-Note)
- `designer-briefs/P09-projekt-pipelines-auftrag.md` (Plantafel + Abnahme BESPOKE/offline, Pivot-Vorrang-Hinweis)
## Dev-Nachzug (nach Davids `D-PLAN`/`D-ABN`/`D-P9`-Delta)
- [x] Interim-UI aus `~/ui` umgesetzt (AD-28)
- [ ] Finale Subframe-Optik nach Davids Delta nachziehen
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/ROADMAP nachgezogen
- [x] Plane-Ticket `R-P9b` aktualisiert (Kommentar `871e8c0b-91a8-4908-83e2-cbeaffafec70`, Label `design-nachzug`)
## Umsetzung
**2026-07-01:** Serverseitige R-P9b-Contracts umgesetzt und auf `main` vorbereitet.
- Commit: `6b6ca1fd9` (`Implement R-P9b schedule and acceptance backend`)
- Proof: `pnpm --filter @hivegrid/web test -- app/utils/integrations/projects/projectService.test.ts`, `pnpm run verify:i18n`, `pnpm typecheck`, `pnpm lint`, `pnpm test`, `pnpm exec prisma validate`, `pnpm run verify:tenant-isolation-report`, `git diff --check` grün.
- Gebaut: `ScheduleEntry`, `ScheduleConflict`, `AbnahmeProtokoll`, `AbnahmeSignatur`, `OfflineSyncMutation` in `prisma/schema/auftrag.prisma`; RLS-Rollout-Artefakt; Tenant-Model-Registry; Prisma-Client; `plantafel.*`/`acceptance.*`-Permissions; Plantafel-Route `/projects/plantafel`; Abnahme-Routen `/projects/:id/acceptance` und `/projects/:id/acceptance/new`; HR-Abwesenheits-Konflikte via `listApprovedAbsencesForRange`; idempotenter Offline-Sync; PDF-Ablage + Mail-Queue; Stage-Validation gegen `requiresAcceptanceProtocol`; Hard-Delete-Service-Block.
- **DoD-Stand:** 8/8 serverseitig = 100 % selbst machbar. Ticket bleibt **On Hold**, weil finale Drag/Resize-Plantafel, Touch-Signatur-Canvas, mobile Offline-UX und visuelle Abnahme durch `D-PLAN`/`D-ABN`/`D-P9` extern blockiert sind.
**2026-07-09:** Interim-UI nach AD-28 umgesetzt, weil `D-PLAN`/`D-ABN`/`D-P9` weiterhin kein finales Subframe-Delta liefern.
- Proof: `pnpm typecheck`, `pnpm lint`, `pnpm --filter @hivegrid/view-models test -- src/projects/projects.vm.test.ts`, `pnpm --filter @hivegrid/view-models typecheck`, `$env:HIVEGRID_CORE_TESTS_ONLY='1'; pnpm exec node scripts/vitest-cli-compat.mjs run apps/web/app/ -- app/utils/integrations/projects/projectService.test.ts`, `$env:HIVEGRID_CORE_TESTS_ONLY='1'; pnpm exec node scripts/vitest-cli-compat.mjs run apps/web/app/ -- app/modules/i18n/locale-coherence.test.ts app/modules/i18n/visible-shell-copy-i18n.test.ts`, JSON-Parse der betroffenen Locale-Dateien grün.
- Gebaut: `PlantafelPage`, `AcceptanceListPage`, `AcceptanceNewPage` aus `~/ui`-Komponenten mit VM-Props, Statuswechsel/Offline-Sync-Brücke, strukturierte Mängel- und Signatur-Erfassung statt roher JSON-Textareas, i18n-Keys und pure VM-Builder in `@hivegrid/view-models`.
- Hinweis: `pnpm test` war bereits vor dieser Änderung auf Windows rot (bestehende Onboarding/User-Source-String-Tests, i18next File-URL und Request/URLSearchParams-Umgebung). Für diesen Nachzug wurden gezielte P9-/i18n-/VM-Gates genutzt.
- **DoD-Stand:** 8/8 DoD + Interim-UI = 100 % selbst machbar. Finale Drag/Resize-/Touch-Canvas-/Subframe-Optik bleibt **design-nachzug offen** und ist nicht Done-blockierend.
**2026-07-19 — Stand-Audit + Restarbeiten (Branch `fix/r-p9-audit-restwork`):** Das Audit fand den realen Stand bei 5/8 DoD (nicht 100 %):
- **DoD 4 (Notification, RLS-Regression):** Die PL-Benachrichtigung bei rejected/with_defects lief als roher Delivery-Insert ohne gebundenen Tenant-Kontext; unter FORCE RLS (Cutover 14.07.) wurde der Policy-Reject durch `.catch(() => undefined)` still verschluckt (gleiches Muster wie die R-P1b-Regression). Fix: M011-`notify()` innerhalb `withTenantRLS`, Fehler werden geloggt (`projects.acceptance-notify`).
- **DoD 6 (Stage-Gate):** Das Gate akzeptierte jedes gesperrte Protokoll, auch `rejected`. Fix: nur `full` + `with_defects` öffnen das Gate (Entscheidung 19.07., Teilabnahme erlaubt Übergang; `rejected` stuft ohnehin zurück).
- **DoD 1 (Plantafel-UI):** Bulk-Reassign hatte keinen UI-Pfad, „Meine Termine heute"/„Meine Woche" fehlten. Fix: Auswahlspalte + Bulk-Zuweisungs-Leiste (permission-gated), Schnellfilter mit Loader-Range-Parametern (`range=today`, `mine=1`).
- **DoD 3 (Härtung):** Expliziter Immutability-Guard `updateAcceptanceProtocolContent()` mit Klartext-Fehler (`projects.error.acceptanceProtocolImmutable`), damit kein künftiger Update-Pfad still wächst.
- Proof: Commits auf `fix/r-p9-audit-restwork` (`fix(projects): Abnahme-Notification RLS-gebunden …`, `fix(projects): Stage-Gate …`, `feat(projects): Plantafel Bulk-Reassign-UI …`, `test(projects): P9-Smoke …`); typecheck/lint/verify:i18n grün, `plantafelAcceptanceService.auth.test.ts` (26 its), `projectService.tenant-ownership.test.ts` (Stage-Gate), `PlantafelPage.test.tsx` (16 its) grün; Plantafel-Filter live verifiziert auf `app.localhost:3000` (`?range=today`-Roundtrip).
- **DoD-Stand: 8/8 + 4 nachgetragene Punkte = 100 % done.** Drag&Drop/Resize, Touch-Signatur-Canvas und PWA-Client-Queue bleiben design-nachzug/VA-P27a; Calendar-Sync-Write bleibt P16.
**2026-07-26 — Interim-UI-Nachzug Plantafel: Tabellen-Rahmen + Wochenansicht (Branch `feat/plantafel-table-calendar`, User-Auftrag):** Kein DoD-Zuwachs, der Stand bleibt 100 %; die Interim-UI der Plantafel wird an die übrigen Listen-Screens angeglichen und um eine zweite Ansicht ergänzt.
- **Tabelle ohne Kachel:** Die `Card` um die Einsatzplanung ist raus. Die Zwischenüberschrift „Einsatzplanung" bleibt, die Tabelle sitzt im selben Rahmen wie die Formular-Liste (`rounded-lg border shadow-sm`, horizontal scrollbar).
- **Ansichts-Switch im Header:** `ToggleGroup` Tabelle/Kalender an derselben Stelle und in derselben Form wie der Board/Liste-Switch der Leads-Inbox. GET-getrieben (`?view=calendar`), damit der Loader das passende Fenster auflöst.
- **Kalenderansicht:** Montag-bis-Sonntag-Woche mit tiefen Tagesspalten (mehrere Einsätze stapeln, kein „+n weitere"). Pro Eintrag Zeitfenster, Titel, Monteur, Projekt, Status- und Konflikt-Badge. Wochennavigation (Aktuelle Woche / ‹ / ›) plus Zeitraum-Label ersetzt in dieser Ansicht die Schnellfilter; „Nur meine Termine" gilt in beiden. Der Loader zieht für die Kalenderansicht exakt die Kalenderwoche (`fromZonedTime` auf `Europe/Berlin`) statt der Quick-Ranges.
- **Neuer pure VM-Builder:** `buildPlantafelWeek()` in `packages/view-models/src/projects/plantafel-week.ts` — bucketet die Einträge über `Europe/Berlin` in die sieben Tage (Hydration-Regel), zeigt einen mehrtägigen Einsatz an jedem Arbeitstag und lässt einen um Mitternacht endenden Einsatz nicht in den Folgetag laufen.
- Proof: `pnpm typecheck` · `pnpm lint --max-warnings=0` · `pnpm test` (1108 Dateien / 7722 Tests) · `pnpm exec vitest run packages/view-models/src` (118/637) · `verify:i18n` · `verify:source-health` grün; `plantafel-week.test.ts` (7 its) + `PlantafelPage.test.tsx` (17 its, davon 5 neu) grün; Interim-Visual-Baseline neu gezogen (Markup-Änderung beabsichtigt, AD-28). Live auf `app.localhost:3000` verifiziert: Wochenraster Mo 20.07.–So 26.07., mehrtägiger Einsatz auf Mi+Do, Heute-Markierung auf So 26., Wochensprung über den Monatswechsel (27.07.–02.08.), `mine=1` behält `view=calendar`.
- Offen (unverändert): Drag&Drop/Resize und finale Subframe-Optik bleiben `design-nachzug`; Statuswechsel und Bulk-Reassign bleiben in der Tabellenansicht.
**2026-07-27 — Interim-UI-Nachzug Plantafel, Teil 2: Status-Flyout, Filterleiste, Zeitraster (gleicher Branch, User-Auftrag):** Kein DoD-Zuwachs, der Stand bleibt 100 %. Reine Interim-UI-Arbeit, das Server-Verhalten (Konflikte, Permissions, `read_own`-Pinning, Bulk-Reassign) ist unverändert.
- **Status über Flyout statt Ändern-Button:** Das Status-Badge in der Tabelle ist jetzt selbst der Trigger eines `SubframeCore.DropdownMenu` — wie das Status-Flyout der Leads-Inbox. Ein Klick auf eine Option submittet direkt `updateStatus` (kein zweiter „Speichern"-Schritt); die bisherige Select-plus-Speichern-Spalte samt `statusDrafts`-State ist raus. Die aktive Option ist per `showCheckbox selected` markiert und löst keinen Resubmit aus.
- **Farbige Status-Kacheln im Flyout:** Jede Option rendert dasselbe `BadgeFeedback` in der Farbe, die die Zeile später zeigt. Dafür exportiert `project-operations.vm.ts` den bisher internen `scheduleStatusTone()` — die Liste kann die Töne so nicht auseinanderdriften lassen.
- **Filterleiste statt Schnellfilter:** „Meine Termine heute" / „Meine Woche" / „Nur meine Termine" sind raus. Stattdessen links eine Suchleiste im Muster der übrigen Listen-Screens (client-seitig über Titel, Monteur, Projekt — das geladene Fenster ist ein Tag bzw. eine Woche, keine paginierte Liste) und daneben ein Monteur-Picker (`assignedUserId`, Sentinel `__any__` = alle). Konflikt-Zähler und Empty-State folgen der Suche; Klartext-Empty bei „kein Treffer". **Bewusster Verlust:** DoD 1 nennt die Schnell-Ansichten „Meine Termine heute"/„Meine Woche" — die Auswahl „wessen Termine" deckt der Picker ab, „meine Woche" die Kalenderansicht; `range=today` bleibt als URL-Vertrag unterstützt und dokumentiert.
- **Wochennavigation rechts:** Zeitraum-Label, „Aktuelle Woche", ‹ und › sitzen rechtsbündig in der Toolbar, orientiert an `/calendar`; sie erscheinen nur in der Kalenderansicht.
- **Kalender als Zeitraster:** Uhrzeiten-Spalte links, Stundenlinien, tiefere Zeilen (84 px/Stunde) und breitere Tagesspalten (min. 240 px, Seitwärts-Scroll erlaubt). Überlappende Einsätze stehen **parallel** in eigenen Spuren; `buildPlantafelWeek()` liefert dafür `startMinute`/`endMinute`/`lane`/`laneCount` plus `continuesBefore/After` und eine Zeitachse, die sich auf reale Randzeiten weitet (der abgeschnittene Rand eines mehrtägigen Einsatzes zählt nicht, sonst zieht eine Übernacht-Montage jeden Tag auf 00:00). Kachel-Inhalt skaliert mit der Höhe: unter 60 min nur Zeit + Titel, unter 120 min ohne Projekt/Badges — so bleibt das Raster lesbar statt zufällig.
- **Farbliche Hervorhebung:** Einträge liegen auf dem bestehenden Token `bg-surface-ui-subtle-blue-default` (leichtes Blau aus der UI, kein neuer Farbwert).
- Proof: `pnpm typecheck` · `pnpm lint --max-warnings=0` · `pnpm test` (1108 Dateien / 7728 Tests, 0 Errors) · `pnpm exec vitest run packages/view-models/src` (118/639) · `verify:i18n` · `verify:source-health` grün (`verify:test-coverage` rot ist vorbestehend, per `git stash -u` gegengeprüft). `plantafel-week.test.ts` 9 its, `PlantafelPage.test.tsx` 23 its; Interim-Visual-Baseline neu gezogen (beabsichtigte Markup-Änderung, AD-28). Live auf `app.localhost:3000` verifiziert: farbige Status-Kacheln im Flyout, Ein-Klick-Statuswechsel persistiert (`wk-so-1` → `in_progress`), Suche verengt Zeilen und Zähler, parallele Spuren am Montag, Kurzeinsatz zeigt nur Zeit + Titel.
- Bekannte Grenze: Der Suchbegriff steht nicht in der URL, ein Suchstand ist also nicht teilbar. Radix-`Select`-Auswahl ist in jsdom nicht simulierbar — der Picker ist über Trigger-Text + Optionsliste getestet (Repo-Idiom der Leads-Inbox), die Schreibrichtung über den Route-Callback und den Live-Check.
**2026-07-27 — Interim-UI-Nachzug Plantafel, Teil 3: Detail-Popup mit Lese- und Bearbeiten-Modus (gleicher Branch, User-Auftrag):** Kein DoD-Zuwachs, der Stand bleibt 100 %. Das Popup nutzt ausschließlich die vorhandene `upsertSchedule`-Action, das Server-Verhalten ist unverändert.
- **Öffnen per Doppelklick in beiden Ansichten:** Ein Doppelklick auf eine Tabellenzeile oder auf eine Kalender-Kachel öffnet dieselbe Detail-Ansicht. Der Einfachklick bleibt frei für die Zeilen-Bedienelemente (Auswahl-Checkbox, Status-Flyout) und für späteres Drag&Drop im Raster. Tastatur-Zugang gibt es trotzdem: der Einsatztitel in der Tabelle ist ein Button, die Kalender-Kachel trägt `role="button"` plus Enter/Space.
- **Erst lesen, dann ändern:** Das Popup öffnet **read-only** (Projekt, Monteur, Start, Ende, Status, Konflikte). Oben rechts schaltet „Bearbeiten" auf das Formular um — nur wenn der Nutzer `plantafel.write` hat **und** das Projekt für ihn editierbar ist; sonst erscheint der Knopf gar nicht. Unten rechts steht vor dem Umschalten „Schließen", danach „Abbrechen" + „Plantafel-Eintrag speichern". Der Speichern-Knopf existiert also erst im Bearbeiten-Modus.
- **Formular spiegelt den gespeicherten Stand:** Neuer pure Helfer `buildPlantafelDetailDraft()`/`toDateTimeInputValue()` in `packages/view-models/src/projects/plantafel-detail.ts` rendert die Instants als `YYYY-MM-DDTHH:mm` in `Europe/Berlin` — genau die Form, die der Server über `parsePlantafelDateInput` wieder in derselben Zone liest. Ein Speichern ohne Änderung schreibt damit auch nichts anderes. Der Projekt-Select bekommt das eigene Projekt des Eintrags eingeschleust, falls es nicht auf der aktuellen Picker-Seite liegt.
- **Konflikt-Override:** Meldet der Server `scheduleConflictOverrideRequired`, blendet das Popup dasselbe Begründungsfeld ein wie der Anlegen-Dialog; erst damit ist Speichern wieder möglich.
- Proof: `pnpm typecheck` · `pnpm lint --max-warnings=0` · `pnpm test` (1108 Dateien / 7734 Tests, 0 Errors) · `verify:i18n` · `verify:source-health` grün; `plantafel-detail.test.ts` 6 its, `PlantafelPage.test.tsx` 29 its (6 neu), Interim-Visual-Baseline neu gezogen. Live auf `app.localhost:3000` verifiziert: Doppelklick in Kalender und Tabelle öffnet read-only, „Bearbeiten" zeigt die Berliner Uhrzeiten (07:30/16:00), Titeländerung gespeichert und im Raster sichtbar, Rückänderung ebenfalls persistiert.
- Offen: Löschen/Archivieren aus dem Popup ist nicht Teil des Auftrags und bleibt außen vor.
**2026-07-27 — Interim-UI-Nachzug Plantafel, Teil 4: Zeitfenster-Schalter, Sortierung, Trennung Tabelle/Kalender (gleicher Branch, User-Auftrag):** Kein DoD-Zuwachs, der Stand bleibt 100 %.
- **Vergangene Einsätze zuschaltbar:** Die Tabelle lud bisher immer nur „heute bis heute + 7 Tage", vergangene Einsätze fielen also aus dem Fenster (der Status spielte nie eine Rolle — ein erledigter Termin im Fenster war immer sichtbar). Neue Checkbox „Vergangene Einsätze anzeigen" rechts vom Monteur-Bereich zieht das Fenster 21 Tage zurück (`?past=1`); das Ende bleibt bei heute + 7, damit die Spanne unter der 31-Tage-Grenze des Service bleibt.
- **Sortierung:** Select rechts vom Monteur-Picker mit Zeitraum auf/ab, Einsatz A–Z, Monteur A–Z (`?sort=`). Läuft über dasselbe `PlantafelFilter`-Objekt wie Monteur und Zeitfenster, ein Wechsel überschreibt die anderen also nicht. Sortiert wird im neuen pure `sortPlantafelEntries()` (`packages/view-models/src/projects/plantafel-sort.ts`) über das geladene Fenster; `parsePlantafelSort()` engt einen unbekannten URL-Wert auf den chronologischen Default ein.
- **Tabelle und Kalender sauber getrennt:** Suchfeld, Sortierung und Zeitfenster-Checkbox erscheinen nur in der Tabellenansicht — der Kalender navigiert über Wochen und stellt Einträge auf ihrem Zeitraster dar. Ein in der Tabelle stehen gebliebener Suchbegriff wirkt beim Wechsel in den Kalender nicht mehr nach.
- Proof: `pnpm typecheck` · `pnpm lint --max-warnings=0` · `pnpm test` (1108 Dateien / 7737 Tests, 0 Errors) · `verify:i18n` grün; `plantafel-sort.test.ts` 6 its, `PlantafelPage.test.tsx` 31 its, Loader-Test „reaches into the past only when the table asks for it". Live auf `app.localhost:3000` verifiziert: `?past=1&sort=title_asc` zeigt 10 statt 1 Termin alphabetisch sortiert; Kalenderansicht ohne Suche/Sortierung.