7.6 KiB
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-P17HR — 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
- Auftrags-Welt = Pipeline-View auf Projekt-Kern (kein Won-Objekt, kein zweiter Datensatz; Auftrags-Felder am selben Projekt)
- Sub-Areas am Projekt: Termine, Rechnungen [v1 NEU], Checklisten (inkl. Mängel
typ=maengel), Aufgaben, Aktivitäten, Dokumente, ProjektMitglieder (Rollen, Multi-Add aus Group) - 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)
- Pipeline-Config-Auftragsteil (
requires_acceptance_protocol, Acceptance-Form-Zuweisung, auto_archive) + auto-Archive-Cron - Acceptance-Form-Templates (M05-basiert, SHK-Default) + Project-Templates
- KWP/ProjektExternesFeld bleibt v2 — KEIN Feld-Halter in v1
- Konnektor
tenantHasModule('projects')(Sub-Areas/Actions gated) projects.*-Permissions (read_own_member/read_own_pl/read_all/write/change_stage/manage_members/delete/admin)
Technische Bausteine
- Entities (erweitert
prisma/schema/projekt.prismabzw. eigeneprisma/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), protenant_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.ProjektExternesFeldNICHT 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 v1REQUIREMENTS.md→REQ-projekt-sub-areas,REQ-rechnung-sub-entity(E3, Phase 9)ROADMAP.md→ Phase 9 (+ Pivot-Note) ·PHASE-SOURCES.md→ P9designer-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 --checkgrün. - Gebaut: eigenes
prisma/schema/auftrag.prismamitProjektMitglied,ProjektTermin,Rechnung,ProjektChecklist,ProjektChecklistItem,AuftragPipelineStageConfig,AcceptanceFormTemplate,ProjectTemplate; RLS-Rollout-Artefakt; Tenant-Model-Registry; Prisma-Client; Auftrag-Service mit Rechnungsnummern-Row-Lock überHiveNumberSeq; 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-P9extern 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-P9aaktualisiert