52 lines
4.8 KiB
Markdown
52 lines
4.8 KiB
Markdown
# D-ABN · Abnahme-Workflow (Bespoke-Mobile)
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Typ** | Screen (Design) |
|
|
| **Owner** | David |
|
|
| **Phase** | P9 — Projekt & Pipelines (Auftrags-Features + Sub-Areas) (bedient `R-P9a`/`R-P9b`) |
|
|
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-29 → fällig 2026-07-01 |
|
|
| **Status** | geplant |
|
|
|
|
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR den Abnahme-Workflow + die Abnahme-Liste** (P9). Die **Plantafel** (P9) → **`D-PLAN`**. Die übrigen P9-Screens (Projekt-Detail-Sub-Areas, Rechnung-Sub-Entity, Pipeline-Config-Auftragsteil, Acceptance-Form-Templates, Project-Templates) sind Compose aus A3/A6 → P9-Compose-Anteil.
|
|
|
|
> 🔴 **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**. Kein separates AcceptanceProtocol-Objekt außerhalb des Projekts.
|
|
|
|
## Abhängigkeiten & Parallelität
|
|
- **Blocked by:** `D-D0b` (Archetypen, Touch-Unterschriften-Primitive, offline-Zustand), `R-REFIT`
|
|
- **Blockt:** —
|
|
- **Bedient (Dev):** `R-P9a`/`R-P9b` (`acceptance.*` — Abnahme als immutable Sub-Area am Projekt-Kern)
|
|
- **Subframe:** Pflicht je Route. Abnahme-Workflow ist **BESPOKE-Mobile** (📱 mobile-first + offline-Sync); Abnahme-Liste aus A2.
|
|
|
|
## Was wir bauen
|
|
**Nur die Abnahme**: das SHK-Abnahme-Protokoll mit Mängel-Repeater (Foto je Mangel), Mängel-Klassifizierung, Touch-Signaturen Kunde + Monteur, PDF + Auto-Email, offline-fähig mit Sync — plus die Abnahme-Liste je Projekt (Mehrfach-/Teilabnahmen). Nach Speichern immutable.
|
|
|
|
## Benötigte Screens
|
|
| Screen [Route] | Kern-Inhalt | Archetyp |
|
|
|---|---|---|
|
|
| 📱 **Abnahme-Workflow** [`/projects/:id/acceptance/new`] | SHK-Abnahme-Protokoll (Datum, Anwesende, Druckprobe ja/nein+Wert, Funktionsprüfung, Zählerstände, Inbetriebnahme/Garantie-Datum, übergebene Dokumente-Checkliste, **Mängel-Repeater mit Foto je Mangel**, Bemerkungen Kunde/Monteur) → **Mängel-Klassifizierung** (kritisch=verweigert / klein=mit Vorbehalt / kosmetisch=erfolgt) bestimmt acceptance_kind → **Touch-Signatur Kunde** (Name eingeben, kann von Kontakt abweichen; IP+Timestamp auto) → **Touch-Signatur Monteur** → Bestätigen → PDF + Auto-Email an Kunden · **offline-fähig, Sync bei Verbindung** · nach Speichern **immutable** (nur archivierbar) | **BESPOKE-Mobile** |
|
|
| Abnahme-Liste [`/projects/:id/acceptance`] | Protokoll-Liste je Projekt (Mehrfach-/Teilabnahmen): Datum, acceptance_kind, Unterzeichner, PDF-Link, Mängel-Status · letzte `full`-Abnahme bestimmt Stage-Wechsel-Vorschlag | A2 |
|
|
|
|
*(Plantafel → `D-PLAN`. Projekt-Detail-Sub-Areas / Rechnung-Sub-Entity / Pipeline-Config-Auftragsteil / Acceptance-Form-Templates / Project-Templates = P9-Compose. Mängel sind Checklisten `typ=maengel`.)*
|
|
|
|
## Features (muss abgedeckt sein)
|
|
- [ ] SHK-Abnahme-Formular (Druckprobe, Funktionsprüfung, Zählerstände, Inbetriebnahme/Garantie, übergebene Dokumente) + **Mängel-Repeater mit Foto je Mangel**
|
|
- [ ] Mängel-Klassifizierung (kritisch/klein/kosmetisch) → bestimmt acceptance_kind; `with_defects` → Mängel als Tasks; `rejected` → zurück in Ausführung + Notification an PL
|
|
- [ ] **Touch-Signatur Kunde + Monteur** (Name abweichbar, IP+Timestamp auto)
|
|
- [ ] PDF + Auto-Email an Kunden; nach Speichern **immutable** (6 J, nur archivierbar; Hard-Delete blockt)
|
|
- [ ] **offline-fähig, Sync bei Verbindung**; Mehrfach-/Teilabnahmen; letzte `full`-Abnahme → Stage-Wechsel-Vorschlag
|
|
|
|
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
|
|
Abnahme-Formular-Renderer (Repeater für Mängel mit Foto-Upload aus Kamera); Mängel-Klassifizierungs-Auswahl (kritisch/klein/kosmetisch); Touch-Unterschriften-Feld (Kunde + Monteur); PDF-Vorschau/-Download; immutable/gesperrt-Banner; Offene-Mängel-roter-Banner; Checklisten-/ChecklistItem-Liste mit Status + Mängel-Klasse + Foto; One-Tap-Foto-Upload; Abnahme-Protokoll-Liste (Datum/acceptance_kind/Unterzeichner/PDF/Mängel-Status); Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext + Lösungs-Knopf).
|
|
|
|
## Quellen (granular)
|
|
- `designer-briefs/P09-projekt-pipelines-auftrag.md` → §Benötigte Screens „📱 Abnahme-Workflow" + „Abnahme-Liste" (NUR diese) + zugehörige Features/UI-Elemente
|
|
- `ENTITY-MODEL.md` → **Domäne 5** (AbnahmeProtokoll/AbnahmeSignatur als immutable Sub-Area am Projekt; Checkliste typ=maengel) — **Pivot-Vorrang**
|
|
- `SCREEN-MAP.md` → §4 Abnahme · `ROADMAP.md` → Phase 9 · `_bmad-output/specs/M04-auftragspipeline.md`
|
|
|
|
## Davids Delta (David füllt aus)
|
|
- [ ] Überschriebene/geänderte Spec-Punkte:
|
|
- [ ] Neue UI/UX-Entscheidungen:
|
|
- [ ] Subframe-Screen-Link(s):
|
|
- [ ] Offene Fragen an Dev:
|