9.3 KiB
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.AbnahmeProtokollist 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.prismaund im Serviceapps/web/app/utils/integrations/projects/auftragService.server.tsbereit. Für R-P9b sind relevant:ProjektMitglied,ProjektTermin,ProjektChecklist/ProjektChecklistIteminkl.typ=maengel,AuftragPipelineStageConfig.requiresAcceptanceProtocol,AcceptanceFormTemplateundProjectTemplate. Commit:954070ec6. R-P9a bleibt bisD-PLAN/D-ABN/D-P9screen-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)inapps/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 mitScheduleEntrymarkieren. Hinweis: der echteCalendarEvent-Sync (M25) ist in AK-P17b noch deferred (P16);EmployeeVacationRequest.calendarEventIdist nullable. Bis P16 also direkt über den Feed gehen, nicht überCalendarEvent.
- 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-PLANblockiert) - 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_protocolblockt 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.prismaM14) +calendar.prisma(M25) nur lesend über Relationen (AD-21). - RLS durchgängig (AD-1);
AbnahmeProtokollimmutable nachgesperrt_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 = ChecklisteREQUIREMENTS.md→REQ-projekt-abnahme,REQ-projekt-sub-areas(Plantafel-Teil) (Phase 9)ROADMAP.md→ Phase 9 (+ Pivot-Note) ·PHASE-SOURCES.md→ P9designer-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-P9baktualisiert
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 --checkgrün. - Gebaut:
ScheduleEntry,ScheduleConflict,AbnahmeProtokoll,AbnahmeSignatur,OfflineSyncMutationinprisma/schema/auftrag.prisma; RLS-Rollout-Artefakt; Tenant-Model-Registry; Prisma-Client;plantafel.*/acceptance.*-Permissions; Plantafel-Route/projects/plantafel; Abnahme-Routen/projects/:id/acceptanceund/projects/:id/acceptance/new; HR-Abwesenheits-Konflikte vialistApprovedAbsencesForRange; idempotenter Offline-Sync; PDF-Ablage + Mail-Queue; Stage-Validation gegenrequiresAcceptanceProtocol; 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-P9extern blockiert sind.