Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/R-P9b.md
T

6.1 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 geplant

🔴 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)
  • Blocks: Demo 2, R-P11a (Suche kommt erst nach abgeschlossener Kern-Kette)
  • 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")
  • HR-Abwesenheiten sichtbar + Konflikt-Detection (Doppelbelegung, Urlaub/krank aus HR M14, Verfügbarkeits-Regeln) mit Klartext-„Trotzdem zuweisen?"; Calendar-Sync (M25) der ScheduleEntries
  • Abnahme-Protokoll mit Touch-Signatur (Kunde + Monteur), offline + Sync, nach Speichern immutable (6 J, nur archivierbar), Mehrfach-/Teilabnahmen
  • 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