Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,58 @@
|
||||
# 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
|
||||
Reference in new issue
Block a user