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

59 lines
6.1 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** | 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