6.1 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 | geplant |
🔴 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) - 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_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