Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P9b.md
T
2026-07-08 16:15:37 +02:00

89 lines
9.3 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** | On Hold (serverseitig 8/8, Screens/Client-UX blockiert) |
> 🔴 **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)
## 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) · `PHASE-SOURCES.md` → P9
- `designer-briefs/P09-projekt-pipelines-auftrag.md` (Plantafel + Abnahme BESPOKE/offline, Pivot-Vorrang-Hinweis)
- `_bmad-output/specs/M04-auftragspipeline.md` (⚠ teils pre-pivot: „AcceptanceProtocol" als Fremd-Objekt überholt — ENTITY-MODEL hat Vorrang)
## Dev-Nachzug (nach Davids `D-PLAN`/`D-ABN`/`D-P9`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P9b` aktualisiert
## 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.