Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/D-P9.md
T

60 lines
6.7 KiB
Markdown

# D-P9 · Screens P9 — Projekt & Pipelines (Auftrags-Sub-Areas, ohne Plantafel & Abnahme-Workflow)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P9 — Projekt & Pipelines Auftrag (bedient `R-P9a`/`R-P9b`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-30 → 2026-07-01 · Gate W3 |
| **Status** | geplant (NEU — schließt P9-Screen-Lücke außerhalb Plantafel/Abnahme) |
> **Ergänzt die Bespoke-Tickets `D-PLAN` (Plantafel) und `D-ABN` (Abnahme-Workflow + Abnahme-Liste).** **Dieses Ticket deckt die übrigen P9-Screens**: Projekt-Detail-Auftrags-Sub-Areas, Rechnung-Sub-Entity, Pipeline-Config-Auftragsteil, Acceptance-Form-Templates und Project-Templates. Plantafel-Raster und der Abnahme-Workflow/-Liste sind **NICHT** Teil von D-P9.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A3 Detail + Sub-Area-Tabs, A2 Liste, A5 Modal, A6 Settings)
- **Bedient (Dev):** `R-P9a` (Sub-Areas am Projekt + Rechnung), `R-P9b` (Plantafel offline + Abnahme-Protokoll offline)
- **Parallel/Geschwister:** `D-PLAN` (Plantafel, BESPOKE-Mobile/offline) und `D-ABN` (Abnahme-Workflow + Abnahme-Liste, BESPOKE-Mobile) — D-P9 liefert die A3-Sub-Area-Flächen drumherum; baut auf der P8-Projekt-Detail-Basis auf (`D-P8`); embedded Task-Liste/Files aus `D-P4`
- **Subframe:** Pflicht je Route (A3 + 📱-Variante für Mobil-Modus, A2/A5 Rechnung, A6 Settings/Templates)
## Was wir bauen
Die **auftragsspezifischen Sub-Area-Flächen auf dem `Projekt`-Kern** (ohne Plantafel/Abnahme-Workflow): Erweiterung der Projekt-Detail-View um Auftrags-Sub-Areas, das neue Rechnung-Sub-Entity (v1), den auftrags-spezifischen Pipeline-Config-Teil, die Acceptance-Form-Templates-Verwaltung und Project-Templates.
> 🔴 **Pivot-Vorrang (AD-20):** Es gilt das `ENTITY-MODEL.md`. **Kein separates Project-Objekt** — die Auftrags-Welt ist eine **Pipeline-View auf denselben `Projekt`-Kern** (P8). Kein Won-Handoff, kein zweiter Datensatz, **keine read-only „Sales-Verlauf-Sektion"** — die Historie steckt im selben Projekt-Activity-Stream. **Rechnung ist NEUES Sub-Entity (v1, E3)** am Projekt. Material-Ausgang/Lagerist-Sicht, Zeiterfassung, Leistungspositionen, Baustelle, Supporttickets → v2 (Material-Listen am Auftrag bleiben v1). **KWP komplett v2** — `ProjektExternesFeld` ist in v1 NICHT vorhanden (kein Feld-Halter, erst ab v2; Entscheidung 16.06.).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| 📱 **Projekt-Detail — Auftrags-Sub-Areas** [`/projects/:id`] | Erweitert die P8-Detail-View (D-P8) um Sub-Area-Tabs/Sektionen: **ProjektMitglieder** (Monteure/PL/zuständig/Beobachter mit Rolle, Multi-Add aus Group), **Termine**, **Rechnungen [v1 NEU]**, **Checklisten** (inkl. Mängel `typ=maengel`), **Aufgaben**, **Dateien/Dokumente**, **Abnahmen** (Einstieg → D-ABN) *(KWP-/Externe-Felder erst ab v2 — in v1 nicht)* · Baustellen-/Rechnungs-/Bauherr-Adress-Slots · Offene-Mängel-Banner · **Mobil-Modus: Stammdaten + heutige Tasks + Abnahme-Button + One-Tap-Foto-Upload** | A3 + 📱-Variante |
| Rechnung-Sub-Entity [im Projekt-Detail, Sub-Area] | Rechnung anlegen/anzeigen: Rechnungsnummer (HiveNumberSeq), Betrag, Status (entwurf/gestellt/bezahlt/storniert), Datum, fällig_am, verknüpfte Datei, Quelle (manuell/kwp) · einfaches Sub-Entity am Projekt (v1 NEU, E3) | A2/A5 (in Sub-Area) |
| Pipeline-Config-Auftragsteil [`/admin/pipelines/:id`] | Auftrags-spezifische Stage-Optionen: `requires_acceptance_protocol` je Stage (Block beim Wechsel ohne Abnahme), Acceptance-Form-Template-Zuweisung, `auto_archive_after_days` · (Basis-Pipeline-Editor = P8/D-P8) | A6 |
| Acceptance-Form-Templates [`/admin/projects/acceptance-forms`] | Form-Builder-basiert (M05, Subtyp acceptance_form), SHK-Default geseedet · Verwaltung/Zuweisung | A6 |
| Project-Templates [`/admin/projects/templates`] | Vorlagen mit Default-Pipeline/Stage/Mitgliedern/Tasks/ScheduleEntries/Custom-Feldern | A2 |
*(Plantafel → **D-PLAN**. Abnahme-Workflow + Abnahme-Liste → **D-ABN**. Projekt-Kanban/Listen/Detail-Basis/Pipeline-Engine = P8/D-P8 + D-KANBAN. Material-Ausgang/Lagerist/Zeiterfassung/Leistungspositionen → v2.)*
## Features (muss abgedeckt sein)
- [ ] Sub-Areas am Projekt: Termine, **Rechnungen [v1 NEU]**, Checklisten (inkl. Mängel `typ=maengel`), Aufgaben, Aktivitäten, Dokumente, ProjektMitglieder *(KWP-/Externe-Felder erst ab v2)*
- [ ] Rechnung-Sub-Entity (Nummer/Betrag/Status/Datum/Fälligkeit/Datei/Quelle) anlegen + anzeigen
- [ ] Pipeline-Config-Auftragsteil (`requires_acceptance_protocol`, Acceptance-Template-Zuweisung, `auto_archive_after_days`)
- [ ] Acceptance-Form-Templates-Verwaltung + Zuweisung (SHK-Default)
- [ ] Project-Templates (Default-Pipeline/Stage/Mitglieder/Tasks/ScheduleEntries/Custom-Felder)
- [ ] Offene-Mängel-Banner am Projekt-Detail; Abnahme-Button als Einstieg in D-ABN
- [ ] Mobil-Modus der Projekt-Detail (Stammdaten + heutige Tasks + Abnahme-Button + One-Tap-Foto-Upload)
- [ ] Empty/Loading/Fehler/Permission-Denied/Offline-States (Klartext)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Sub-Area-Tabs/Sektionen am Projekt-Detail; ProjektMitglieder-Liste mit Rollen-Badge (Monteur/PL/zuständig/Beobachter) + Multi-Add aus Group; Rechnungs-Sub-Liste (Nummer/Betrag/Status/Fälligkeit/Quelle/Datei) + Anlage-Form; Checklisten-/ChecklistItem-Liste mit Status + Mängel-Klasse + Foto; KWP-Externe-Felder-Anzeige (read-only); Acceptance-Form-Template-Picker; Project-Template-Auswahl; Stage-Option-Editor (`requires_acceptance_protocol` / Template-Zuweisung / `auto_archive_after_days`); Offene-Mängel-roter-Banner; Abnahme-Button-Einstieg (→ D-ABN); 📱 Mobil-Detail-Variante (Stammdaten + heutige Tasks + One-Tap-Foto-Upload); Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext + Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P09-projekt-pipelines-auftrag.md` (vollständiger Brief MINUS Plantafel & Abnahme-Workflow/Liste — 🔴 Pivot-Vorrang AD-20)
- `ENTITY-MODEL.md` → **Domäne 5** (Sub-Areas am Projekt: Rechnung/Termin/Checkliste/AbnahmeProtokoll/AbnahmeSignatur/ProjektMitglied/ProjektExternesFeld) + Kern-Ketten-Diagramm — 🔴 **Pivot-Vorrang (AD-20)**
- `ROADMAP.md` → Phase 9 (+ Pivot-Note) · `REQUIREMENTS.md` → `REQ-projekt-*` · `PHASE-SOURCES.md` → P9
- `_bmad-output/specs/M04-auftragspipeline.md` (⚠ „AcceptanceProtocol/ProjectPipeline/source_deal_id-Snapshot" = Sub-Area am gemeinsamen `Projekt`-Kern)
- Geschwister-Tickets: `D-PLAN` (Plantafel), `D-ABN` (Abnahme) · Basis: `D-P8` · Dev-Pendant: `ticket-docs/R-P9a.md`, `ticket-docs/R-P9b.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev: