145 lines
23 KiB
Markdown
145 lines
23 KiB
Markdown
# 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.
|