71 lines
7.6 KiB
Markdown
71 lines
7.6 KiB
Markdown
# R-P9a · P9 Projekt-Pipeline (Auftrags-Sicht) + Sub-Areas + Rechnung (Sub-Entity v1)
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Typ** | Dev (Code) |
|
|
| **Owner** | Raffael |
|
|
| **Phase** | P9 — Projekt & Pipelines (Auftrags-Features + Sub-Areas) |
|
|
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-30 → 2026-07-01 · Gate W3 |
|
|
| **Status** | On Hold |
|
|
|
|
> 🔴 **Pivot-Vorrang (AD-20):** Die Auftrags-Welt ist eine **Pipeline-View auf denselben `Projekt`-Kern** (P8) — **kein separates Project-Objekt, kein Won-Handoff, kein zweiter Datensatz**. Ein Projekt wechselt nur die Pipeline / erhält Auftrags-Felder; die Historie steckt im selben Projekt-Activity-Stream (keine read-only „Sales-Verlauf-Snapshot"-Sektion). **Rechnung = NEUES Sub-Entity (v1, E3)**. KWP-Felder (`ProjektExternesFeld`) sind **komplett v2** — in v1 KEIN Feld-Halter.
|
|
|
|
## Abhängigkeiten & Parallelität
|
|
- **Blocked by:** `R-P8b` (Kanban + `deal.won`), `R-REFIT` (Pivot-Re-Fit — ✅ 16.06.)
|
|
- **Blocks:** `R-P9b` (Plantafel + Abnahme bauen auf Sub-Areas auf)
|
|
- **Sequenz (Raffaels Kern-Kette):** strikt sequenziell — P9a ist Glied 5 (`R-P8b → R-P9a → R-P9b …`).
|
|
- **Läuft parallel zu:** Akeshans Module (u.a. `AK-P17` HR — liefert später Abwesenheiten für die Plantafel in P9b). Schema-Trennung nach **AD-21**.
|
|
|
|
**Dependency-Stand 2026-07-01:** `R-P8b` ist serverseitig umgesetzt (Board-/Listen-/Forecast-Contracts, Stage-Move mit Lost-Reason-Pflicht, 24h-Undo, Aggregat-Cache, Field-Level-Backstop, SSE-Contract und `deal.won`-Workflow-Outbox). `R-P9a` kann backendseitig auf `prisma/schema/projekt.prisma`, `ProjektStageChange`, `PipelineAggregateSnapshot` und `projectService.server.ts` aufsetzen; visuelle Auftrags-Sub-Areas bleiben bis `D-PLAN`/`D-ABN`/`D-P9` screen-blockiert.
|
|
|
|
## Was wir bauen
|
|
Die **auftragsspezifischen Features auf dem `Projekt`-Kern** aus P8: die **Sub-Areas am Projekt** (Termine, **Rechnungen [v1 NEU]**, Checklisten inkl. Mängel, Aufgaben, Aktivitäten, Dokumente, ProjektMitglieder), die **Rechnung als einfaches Sub-Entity** (Nummer via HiveNumberSeq lückenlos/GoBD, Status, PDF) und die auftrags-spezifische Pipeline-Config (`requires_acceptance_protocol`, Acceptance-Form-Zuweisung, auto_archive). Plantafel + Abnahme-Workflow folgen in P9b.
|
|
|
|
## Benötigte Screens (Backend bedient — Design liefert `D-PLAN` + `D-ABN` + `D-P9`)
|
|
| Screen [Route] | Kern-Inhalt |
|
|
|---|---|
|
|
| 📱 Projekt-Detail — Auftrags-Sub-Areas [`/projects/:id`] | Erweitert P8-Detail um Sub-Area-Tabs: **ProjektMitglieder** (Monteure/PL/zuständig/Beobachter, Multi-Add aus Group), Termine, **Rechnungen [v1 NEU]**, Checklisten (inkl. Mängel), Aufgaben, Dateien/Dokumente, Abnahmen (P9b). Adress-Slots (Baustelle/Rechnung/Bauherr), Offene-Mängel-Banner. Mobil-Modus: Stammdaten + heutige Tasks + One-Tap-Foto-Upload |
|
|
| 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 (E3) |
|
|
| Pipeline-Config-Auftragsteil [`/admin/pipelines/:id`] | `requires_acceptance_protocol` je Stage (Block beim Wechsel ohne Abnahme), Acceptance-Form-Template-Zuweisung, auto_archive_after_days (Basis-Editor = P8) |
|
|
| Acceptance-Form-Templates [`/admin/projects/acceptance-forms`] · Project-Templates [`/admin/projects/templates`] | M05-Form-Builder (Subtyp acceptance_form, SHK-Default); Vorlagen mit Default-Pipeline/Stage/Mitgliedern/Tasks/Custom-Feldern |
|
|
|
|
## Definition of Done
|
|
- [x] **Auftrags-Welt = Pipeline-View auf Projekt-Kern** (kein Won-Objekt, kein zweiter Datensatz; Auftrags-Felder am selben Projekt)
|
|
- [x] **Sub-Areas am Projekt:** Termine, **Rechnungen [v1 NEU]**, Checklisten (inkl. Mängel `typ=maengel`), Aufgaben, Aktivitäten, Dokumente, **ProjektMitglieder** (Rollen, Multi-Add aus Group)
|
|
- [x] **Rechnung = neues Sub-Entity v1 (E3):** anlegen/anzeigen/verknüpfen, **Rechnungsnummer via HiveNumberSeq Row-Lock/lückenlos (GoBD)**, Status-Workflow, PDF-Anhang, Quelle manuell (kwp = v2)
|
|
- [x] Pipeline-Config-Auftragsteil (`requires_acceptance_protocol`, Acceptance-Form-Zuweisung, auto_archive) + auto-Archive-Cron
|
|
- [x] Acceptance-Form-Templates (M05-basiert, SHK-Default) + Project-Templates
|
|
- [x] **KWP/ProjektExternesFeld bleibt v2** — KEIN Feld-Halter in v1
|
|
- [x] Konnektor `tenantHasModule('projects')` (Sub-Areas/Actions gated)
|
|
- [x] `projects.*`-Permissions (read_own_member/read_own_pl/read_all/write/change_stage/manage_members/delete/admin)
|
|
|
|
## Technische Bausteine
|
|
- **Entities** (erweitert `prisma/schema/projekt.prisma` bzw. eigene `prisma/schema/auftrag.prisma`): `Rechnung` (rechnungsnummer/betrag/status/datum/faellig_am/datei_id/quelle), `Termin`, `Checkliste`/`ChecklistItem` (typ generisch|maengel|abnahme_doku, maengel_klasse, foto_file_id), `ProjektMitglied` (rolle), Acceptance-Form-Template-/Project-Template-Halter. `files.prisma`/`crm.prisma`/`forms.prisma` (M05) nur über Relationen berühren (AD-21).
|
|
- **HiveNumberSeq** für Rechnungsnummern: `SELECT … FOR UPDATE`-Row-Lock, **lückenlos** (GoBD-Pflicht — **keine** Postgres-Sequence wegen Rollback-Lücken), pro `tenant_id` + `entity_type`.
|
|
- **RLS** auf allem Tenant-bezogenen (AD-1); `[Soft-Delete]` mit Hard-Delete-Block bei Aufbewahrungs-Pflicht (Vorbereitung für Abnahme-Protokolle in P9b).
|
|
- **Activity** (P6) als gemeinsamer Projekt-Stream — keine Snapshot-Sektion.
|
|
- **Konnektor** `tenantHasModule('projects')` gated.
|
|
- `is_demo_data`-Flag auf SHK-Acceptance-Form-Default/Project-Templates/Demo-Rechnungen.
|
|
- **`ProjektExternesFeld` NICHT modellieren (v2)** — Entscheidung 16.06.
|
|
|
|
## Quellen (granular)
|
|
- `ENTITY-MODEL.md` → **Domäne 5: Sub-Areas am Projekt** (Rechnung/Termin/Checkliste/ProjektMitglied; `ProjektExternesFeld` = **v2**) + Kern-Ketten-Diagramm — 🔴 **Pivot-Vorrang (AD-20)**: Pipeline-View statt Project-Objekt, Rechnung NEU v1
|
|
- `REQUIREMENTS.md` → `REQ-projekt-sub-areas`, `REQ-rechnung-sub-entity` (E3, Phase 9)
|
|
- `ROADMAP.md` → Phase 9 (+ Pivot-Note) · `PHASE-SOURCES.md` → P9
|
|
- `designer-briefs/P09-projekt-pipelines-auftrag.md` (Screens + UI-Elemente, Pivot-Vorrang-Hinweis)
|
|
- `_bmad-output/specs/M04-auftragspipeline.md` (⚠ teils pre-pivot: „AcceptanceProtocol/ProjectPipeline/source_deal_id-Snapshot" überholt — ENTITY-MODEL hat Vorrang)
|
|
|
|
## Umsetzung
|
|
|
|
**2026-07-01:** Serverseitige R-P9a-Contracts umgesetzt und auf `main` vorbereitet.
|
|
|
|
- Commit: `954070ec6` (`Implement R-P9a order subareas backend`)
|
|
- Proof: `pnpm exec prisma validate`, `pnpm exec prisma generate`, `pnpm typecheck`, `pnpm --filter @hivegrid/web test -- app/utils/integrations/projects/projectService.test.ts`, `pnpm lint`, `pnpm run verify:i18n`, `pnpm run verify:tenant-isolation-report`, `pnpm test`, `git diff --check` grün.
|
|
- Gebaut: eigenes `prisma/schema/auftrag.prisma` mit `ProjektMitglied`, `ProjektTermin`, `Rechnung`, `ProjektChecklist`, `ProjektChecklistItem`, `AuftragPipelineStageConfig`, `AcceptanceFormTemplate`, `ProjectTemplate`; RLS-Rollout-Artefakt; Tenant-Model-Registry; Prisma-Client; Auftrag-Service mit Rechnungsnummern-Row-Lock über `HiveNumberSeq`; Projekt-Detail-Contracts für Sub-Areas; Pipeline-Auftragsteil; Admin-Routen für Acceptance-Forms und Project-Templates; Activity-Typen; `projects.read_own_member`.
|
|
- **DoD-Stand:** 8/8 serverseitig = 100 % selbst machbar. Ticket bleibt **On Hold**, weil die finalen Screen-Umsetzungen/UX-Abnahme durch `D-PLAN`/`D-ABN`/`D-P9` extern blockiert sind.
|
|
|
|
## 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-P9a` aktualisiert
|