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

23 KiB
Raw Blame History

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

  • 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)
  • 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)
  • 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)
  • Mängel-Checkliste (typ=maengel) eingebunden + Mängel-Klassifizierung → acceptance_kind; with_defects → Tasks, rejected → zurück in Ausführung + Notification an PL
  • PDF + Auto-Email an Kunden
  • Stage-Wechsel-Validation: requires_acceptance_protocol blockt ohne Abnahme; Hard-Delete blockt bei Abnahme-Protokollen (Aufbewahrung)
  • Konnektor tenantHasModule('projects') (Plantafel/Abnahme gated)
  • 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):

  • Smoke-Test (D.19) — tests/e2e/p9-operations-smoke.spec.ts (Plantafel-Filter-Roundtrip)
  • Hot-Swap-Drill (D.20) — r-p9-operations-interim in packages/ui-mock + scripts/verify-ui-hot-swap.ts
  • Interim-Visual-Baseline (D.21) — p9-operations-interim.visual.test.tsx (Plantafel/Abnahme-Liste/Sub-Areas)
  • 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)

  • 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
  • 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.