Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/D-ABN.md
T

4.7 KiB

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

Davids Delta (David füllt aus)

  • Überschriebene/geänderte Spec-Punkte:
  • Neue UI/UX-Entscheidungen:
  • Subframe-Screen-Link(s):
  • Offene Fragen an Dev: