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

9.3 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 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

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

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.