# R-P8a · P8 Pipeline-Engine + Projekt-CRUD (Sales-Sicht) + Auto-Projekt | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Raffael | | **Phase** | P8 — Projekt & Pipelines (Kern + Pipeline-Engine) | | **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-27 → 2026-06-28 · Gate W3 | | **Status** | Umgesetzt — 13/13 DoD (Audit 2026-07-18), Restarbeiten-PR offen · design-nachzug offen | **🎨 design-nachzug: offen** (seit 2026-07-08) — Interim-UI aus `~/ui` (AD-28); Subframe-Muster aus `WF-P8 Pipelines` am 2026-07-11 integriert, **Delta-Nachzug der 7 neuen Flow-Seiten (10 → 17) am 2026-07-18** (PR #154: S00 Boards-Start, S01a/S03a/S02a/S07a-States, S01b 2-Spalten-Umbruch, M03 Kontextmenü, neue `KanbanCard`-Slot-API). **Baseline-Nachzug 2026-07-28/29 (17 → 23 Seiten, PR #286):** Davids Handoff `D-P8 + D-KANBAN` ist die neue Baseline — die 6 neuen Screens inkl. Datenmodell gebaut (M04-Übergabe, S02-Schnellaktionen, S05/M05 Detail-Schablone) **und** alle Bestands-Screens neu aus dem Export gebaut (S00, S01 inkl. Filterleiste, S03, S04, S06, S07/S07-D/S07a, M01, M03); Interim-UI abgelöst. Offen bleiben nur noch: Demo-Seed für die neuen Zustände, Re-Baseline der Visual-Baseline `r-p8-projects-interim` auf die Subframe-Optik und die visuelle Abnahme auf Staging nach Merge. > 🔴 **Pivot-Vorrang (AD-20):** Das Snapshot-Ticket heißt noch „Deal-CRUD". Korrekt projekt-zentrisch: Es gibt **EINEN `Projekt`-Kern** (typisierte Superset-Tabelle, Deal- + Auftrags-Felder in einer Tabelle). **„Deal" ist ein Pipeline-Typ** (`Pipeline.typ_hint = sales`), **KEINE eigene Entität**. „Projekt-CRUD in Sales-Pipeline-Sicht" statt „Deal-CRUD". `Status` ist immer pipeline-intern (`PipelineStage.stage_kind = offen/gewonnen/verloren`) — kein globaler Projektstatus. ## Abhängigkeiten & Parallelität - **Blocked by:** `R-P7` (Lead-Inbox liefert `lead.qualified`-Event) - **Blocks:** `R-P8b` (Kanban + Forecast bauen auf Engine + Projekt-Kern auf) - **Sequenz (Raffaels Kern-Kette):** strikt sequenziell `R-P7 → R-P8a → R-P8b → R-P9a …`. P8a ist Glied 3. - **Läuft parallel zu:** Akeshans Module W3 (`AK-P14`/`AK-P15` Email/Telefonie u.a.). Schema-Trennung nach **AD-21** (Modul = eigene `.prisma`, `db push` lokal, Migration beim Merge). ## Was wir bauen Den **`Projekt`-Kern als eine typisierte Tabelle** (Superset der Felder + `CustomFieldValue`) und die **Pipeline-Engine** als frei konfigurierbare Views: Pipeline anlegen/benennen/duplizieren/archivieren (`typ_hint` sales/auftrag/custom), Stages je Pipeline (= die Statuswerte), Zugriff je Rolle/User/Gruppe (`PipelineAccess`), Feld-Sichtbarkeit + Pflichtfelder pro Pipeline+Status (`PipelineFieldConfig`) und **Field-Level-Rechte** je Principal (`PipelineFieldVisibility` — z.B. Auftragsvolumen nur für Vertrieb). Dazu fortlaufende Projekt-Nummern (HiveNumberSeq, lückenlos), Lost-Reason-CRUD und das **Auto-Projekt** (M049): `lead.qualified` → Projekt in Sales-Pipeline. Kanban/Listen-View + Forecast folgen in P8b. ## Benötigte Screens (Backend bedient — Design liefert `D-KANBAN` + `D-P8`) | Screen [Route] | Kern-Inhalt | |---|---| | Projekt-Detail [`/projects/:id`] | Inline-Edit Stammdaten (Nummer/Name/Beschreibung/Volumen/potenzieller Wert/Pipeline/Stage/Zeitraum/Adress-Slots), verknüpfte Kontakte mit Rolle, Lead-Herkunft-Hinweis (`konvertiert_aus_lead_id`), klickbare Stage-Bar, Stage-Historie, gewonnen/verloren-Banner mit 24h-Rückgängig, Tags, Custom-Felder (pro Pipeline via PipelineFieldConfig), Activity-Stream, Quick-Actions | | Pipeline-Config-Admin [`/admin/pipelines` · `/admin/pipelines/:id`] | Pipelines-Liste + Editor: Stages (Name/stage_kind/Win-%/Farbe, Drag&Drop), **PipelineAccess** (Principal × kann_sehen/kann_bearbeiten), **PipelineFieldConfig** (Feld × sichtbar/pflicht/Reihenfolge je Status), **PipelineFieldVisibility** (Field-Level-Rechte je Rolle/Gruppe/User), Validation min. 1 gewonnen + 1 verloren, anlegen/duplizieren/archivieren | | Lost-Reasons [`/admin/pipelines/lost-reasons`] | Liste + Add/Edit/Archive (kein Hard-Delete — Reporting), SHK-Default 5 Reasons geseedet | ## Definition of Done - [x] **EIN `Projekt`-Kern** (typisierte Superset-Tabelle: Deal- + Auftrags-Felder + `CustomFieldValue`) mit fortlaufenden Projekt-Nummern (**HiveNumberSeq, Row-Lock/lückenlos**); RLS + Soft-Delete - [x] **Pipeline-Engine:** Pipeline anlegen/benennen/duplizieren/archivieren (`typ_hint` sales/auftrag/custom); `PipelineStage` = die Statuswerte; Validation min. 1 gewonnen + 1 verloren - [x] **PipelineAccess** (wer sieht/bearbeitet Pipeline je Rolle/User/Gruppe) - [x] **PipelineFieldConfig** (Feld-Sichtbarkeit + Pflicht + Reihenfolge je Pipeline/Status; nicht sichtbare Felder **bleiben erhalten**) - [x] **PipelineFieldVisibility** (Field-Level-Rechte je Principal — z.B. Auftragsvolumen nur für Vertrieb; ohne Eintrag = für alle sichtbar) - [x] **M049: `lead.qualified` → Auto-Projekt** (Projekt automatisch in Sales-Pipeline) — Pipeline-Wechsel-Modell, kein Won-Handoff/zweiter Datensatz - [x] **Lost-Reason-CRUD** (kein Hard-Delete, SHK-Defaults geseedet) - [x] Konnektor `tenantHasModule('projects')` (Sidebar + Routes + Actions gated) - [x] `projects.*`/`deals.read_volume_*`-Permission-Backstop (Field-Level primär über PipelineFieldVisibility; Volumen ohne Recht → „—") **Audit-Nachtrag 2026-07-18 (AD-28-Interim-Messlatte, AGENTS.md DoD D18–21 — waren nie als DoD-Punkte erfasst):** - [x] **D18 VM-Unit-Tests** (`packages/view-models/src/projects/projects.vm.test.ts` — Detail/List/Kanban/Admin-Builder) - [x] **D19 e2e-Smoke** (`tests/e2e/projekt-smoke.spec.ts`, gemeinsam für R-P8a/R-P8b) - [x] **D20 Hot-Swap-Drill** (`createProjektBoardInterimFixture*` in `packages/ui-mock` + M017-Drill `scripts/verify-ui-hot-swap.ts`) - [x] **D21 Interim-Visual-Baseline** (`packages/ui-mock/visual-baseline/r-p8-projects-interim.*`, als „interim" markiert, Re-Baseline beim David-Nachzug) ## Umsetzungs-Notiz **2026-07-01 — Server-/Contract-Umsetzung ohne finale Screens:** `Projekt`/Pipeline-Schema in `prisma/schema/projekt.prisma`, RLS-Artefakt `prisma/rls/projekt-isolation.sql`, Tenant-Snapshot-Registry, `projects`-Entitlement, Default-Permissions, Sidebar-Gate und minimale Routes ergänzt. Project-Service baut lückenlose `HiveNumberSeq`-Projekt-Nummern via `SELECT ... FOR UPDATE`, Default-Sales-Pipeline + SHK-Lost-Reasons, Pipeline CRUD/duplicate/archive, PipelineAccess, PipelineFieldConfig, PipelineFieldVisibility, Lost-Reason CRUD und M049 `lead.qualified` → automatische Projektanlage. Der Lead-Detail-Convert-Pfad ruft bei fehlender Projekt-ID direkt `createProjectFromQualifiedLead` auf. **Proof lokal:** Implementierungs-Commit `6c8cec822`; `pnpm typecheck`, `pnpm lint`, `pnpm run verify:i18n`, `pnpm exec prisma validate`, `pnpm run verify:tenant-isolation-report`, `pnpm test` grün. Zusätzlich fokussiert: `projectService.test.ts`, `AppSidebar.test.tsx`, `tenant/models.test.ts`, Entitlements-/RoleDisplay-/UIInventory-Tests. **Stand:** R-P8a: 9/9 DoD = 100 % serverseitig done. Ticket bleibt fachlich **On Hold**, bis `D-KANBAN`/`D-P8` final geliefert und die Screen-Implementierung/visuelle Abnahme nachgezogen ist. **2026-07-08 — Interim-UI aus `~/ui` (AD-28, Akeshan):** Auf der vorhandenen Backend-Basis drei Interim-Screens (VM als Prop, kein handgeschriebenes Tailwind) ergänzt: **Projekt-Detail** `/projects/:id` (`ProjektDetailPage` — Inline-Edit Stammdaten, klickbare Stage-Bar, Gewonnen/Verloren-Banner mit 24h-Undo, Lost-Reason-Dialog, Kontakte, Activity-Stream; additiv über den unveränderten P9-Sektionen), **Pipeline-Config-Admin** `/admin/pipelines` (`PipelineAdminPage` — Stage-Editor add/archive/reorder, PipelineAccess/-FieldConfig/-FieldVisibility, create/duplicate/archive, Validity-Hinweis), **Lost-Reasons** `/admin/pipelines/lost-reasons` (`LostReasonAdminPage` — add/rename/archive). Pure VMs in `packages/view-models/src/projects/*`. Minimal ergänztes Backend (kein Schema-Change): `updateProjectStammdaten`, `loadProjectDetail`, `listPipelinesForAdmin`, `upsertPipelineStage`, `archivePipelineStage`; neuer Activity-Typ `project_updated`. Interim-Deckung DoD B 6–10 / E 22–25 grün. **Proof:** Commits `e12dd4c03` (Detail + VMs + Backend), `b97634226` (Admin/Lost-Reasons); `pnpm --filter @hivegrid/web typecheck` + `@hivegrid/view-models` grün, `verify:i18n`/i18n-parity, `verify:sidebar-routes` (26), `verify:cross-cutting-models` (178/178) grün; VM-Unit (`projects.vm.test`, 11) + Screen-RTL (`ProjektDetailPage` 5, `PipelineAdminPage` 4, `LostReasonAdminPage` 4) grün. **Offen (getrackter Nachzug):** finale Subframe-Optik (`design-nachzug`), Stage-Reorder als echtes Drag&Drop, e2e-Smoke/Hot-Swap-Drill/Visual-Interim-Baseline (CI/Windows-blockiert), Custom-Feld-Werte am Projekt (kein Storage im Schema). %-Stand unverändert 9/9 serverseitig; Interim-UI-DoD steht, finale Optik bleibt Nachzug. **2026-07-08 (Interim-Nachzug 2):** Projekt-Detail (`/projects/:id`) rendert bei unbekannter/nicht-sichtbarer Projekt-ID jetzt **404 statt 500** (Loader fängt den `CatalogError` ab → `projectNotFoundResponse`). **RBAC-Lücke behoben (querschnittlich):** die `projects.*`/`deals.*`-Permissions waren zwar definiert, aber in keiner Rollen-Matrix zugewiesen (`packages/db/src/permissions-seed.server.ts`) → kein Rolle konnte das Modul öffnen (500 auf `/projects`). Grants für SuperUser/Admin (alle) + User (read_own/-member/write/change_stage + `deals.read_volume_own`) ergänzt; greift idempotent beim `SEED_ON_BOOT`-Deploy. **Weiterhin offen (Nachzug):** Stage-Reorder als echtes Drag&Drop im Pipeline-Admin (interim: Hoch/Runter), **Custom-Feld-Werte am Projekt** (kein `CustomFieldValue`-Storage am Projekt im Schema), **finale Subframe-Optik** (`design-nachzug`), e2e/Hot-Swap/Visual-Baseline. **2026-07-11 — P8-Subframe-Nachzug:** Den MCP-Flow `WF-P8 Pipelines` (10 Pages) auditiert und die kanonischen Muster in die bestehenden VM-/Action-Grenzen integriert. `PipelineAdminPage` übernimmt S04/S07 (Header-Navigation, Dialog zum Anlegen, vorhandene Stage-/Access-/Feld-Konfiguration), `LostReasonAdminPage` S06. Die zwischenzeitlich gelöschten, laut aktuellem Ticket weiterhin verbindlichen Admin-Routen `/admin/pipelines` und `/admin/pipelines/lost-reasons` wurden wiederhergestellt, mit `projects.admin`, Meta-Titeln und gegenseitiger Erreichbarkeit verdrahtet. **Proof:** Tenant-Routen-Typecheck grün; `PipelineAdminPage` 4/4, `LostReasonAdminPage` 4/4 und `projectService` 25/25 Tests grün; `verify:i18n` grün; fokussiertes ESLint ohne Warnungen. **Stand:** 9/9 DoD = 100 % done · 0 DoD-Punkte offen; außerhalb der Ticket-DoD bleiben Browser-/Visual-Regression-Abnahme und echtes Drag&Drop im Admin-Stage-Editor als Nachzug. **2026-07-11 — Staging-Demo-Proof:** Der bereits doppelt gegatete Staging-Boot-Seed (`SEED_DEMO_DATA=true` + `ALLOW_STAGING_DEMO_SEED=true`) legt im Business-Demo-Tenant idempotent zwei Pipelines mit zehn Stages, drei Verlustgründe sowie eine Owner-Access- und Field-Visibility-Konfiguration an. Alle Zeilen tragen `isDemoData=true`; ein erneuter Seed stellt archivierte Demo-Konfiguration wieder her. **Proof:** `stagingDomainDemoSeed.server.test.ts` 2/2 und `SeedService.test.ts` 14/14 grün. **Stand:** 9/9 DoD = 100 % done. **2026-07-16 — Dependency-Impact aus AK-P15b:** Projektanlage, idempotenter M049-Replay, Stage-Wechsel/-Undo sowie relevante Stammdaten-/Projektleiter-Änderungen synchronisieren den entity-linked Projekt-Chat jetzt innerhalb der bestehenden Tenant-/RLS-Transaktion über `ensureAndSyncProjectChannelIfEnabledWithTx`. Bei deaktiviertem Chat-Modul ist der Hook ein No-op. `projekt.prisma`, Pipeline-, Nummern- und Projekt-Pivot-Verträge bleiben unverändert. Das Projekt-Detail erhält additiv einen optionalen Chat-Link; ohne Modul, Permission oder aktive Mitgliedschaft bleibt die Affordance verborgen. Proof: `project-sync.server.test.ts`, `projectChatLink.server.test.ts` und `projects.vm.test.ts`. **R-P8a bleibt 9/9 DoD = 100 % done; keine DoD-Regression.** ## Technische Bausteine - **Entities** (eigene `prisma/schema/projekt.prisma`): `Projekt` (Superset, `stage_id`=Status, `konvertiert_aus_lead_id`, Adress-Slots), `Pipeline` (`typ_hint`), `PipelineStage` (`stage_kind`/win_probability/color), **`PipelineFieldConfig`** (pipeline_id/stage_id NULL=pipeline-weit/field_key System ODER `custom:`/sichtbar/pflicht/reihenfolge), **`PipelineFieldVisibility`** (field_config_id/principal_type rolle|gruppe|user/principal_id/kann_sehen/kann_bearbeiten), **`PipelineAccess`** (pipeline_id/principal/kann_sehen/kann_bearbeiten), `ProjektKontakt` (M:N-Brücke, Rolle), `Adresse`, Lost-Reason. `leads.prisma`/`crm.prisma` nur über Relationen berühren (AD-21). - **HiveNumberSeq** für Projekt-Nummern: `SELECT … FOR UPDATE`-Row-Lock, **lückenlos** (keine Postgres-Sequence wegen Rollback-Lücken), pro `tenant_id` + `entity_type`. - **RLS** auf allem Tenant-bezogenen (AD-1); `[Soft-Delete]` auf Projekt/Pipeline/Kontakt. - **Konnektor** `tenantHasModule('projects')` gated. - `is_demo_data`-Flag auf geseedeten SHK-Pipelines/Stages/Lost-Reasons/Demo-Projekten. - Field-Level-Sichtbarkeit **primär über `PipelineFieldVisibility`**, harte `deals.read_volume_*`-Bundles nur als Backstop. ## Quellen (granular) - `ENTITY-MODEL.md` → **Domäne 5: Projekt-zentrischer CRM-Kern** (Projekt/Pipeline/PipelineStage/**PipelineFieldConfig**/**PipelineFieldVisibility**/**PipelineAccess**/ProjektKontakt) + Kern-Ketten-Diagramm + Modellierungs-Fragen 3 (Pipeline-Rechte) & 4 (HiveNumberSeq) — 🔴 **Pivot-Vorrang (AD-20)**: ein Projekt-Kern, Deal = Pipeline-Typ, kein Won-Handoff - `REQUIREMENTS.md` → `REQ-projekt-kern-datenmodell`, `REQ-pipeline-rechte-config`, `REQ-projekt-pipeline-wechsel` (Phase 8) - `ROADMAP.md` → Phase 8 (+ Pivot-Note) - `designer-briefs/P08-projekt-pipelines-kern.md` (Screens + UI-Elemente, Pivot-Vorrang-Hinweis) ## Dev-Nachzug (nach Davids `D-KANBAN`/`D-P8`-Delta) - [x] Subframe-Flow inventarisiert und Screen-Muster in die bestehenden Adapter-/VM-Grenzen integriert - [ ] Visuelle Browser-/Visual-Regression-Abnahme - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/ROADMAP nachgezogen - [ ] Plane-Ticket `R-P8a` aktualisiert (Titel von „Deal-CRUD" auf projekt-zentrisch nachziehen) ### 2026-07-15 — e2e-Smoke nachgezogen (RA-B3) DoD-19-Smoke für die Projekt-Pipeline (Kanban) ergänzt: `tests/e2e/projekt-smoke.spec.ts` (gemeinsam für R-P8a/R-P8b). Flow: Login → `/projects` (Board) öffnen → Board-Toolbar sichtbar (`ui.projects.board.toolbar`) → Hauptaktion: Board-Suche `smoke` eintragen + „Anwenden" → Loader-Roundtrip (`?q=smoke` in der URL). Auth/Skip-Muster exakt wie `files`/`tasks`/`calendar`/`booking`, keine Produkt-Code-Änderung (bestehende `data-ui-id`-Hooks genutzt). **Proof:** `pnpm exec playwright test tests/e2e/projekt-smoke.spec.ts --list` sammelt den Spec (chromium); `pnpm exec eslint tests/e2e/projekt-smoke.spec.ts --max-warnings=0` grün; `pnpm --filter @hivegrid/web typecheck` grün. Voller Playwright-Lauf braucht einen laufenden Stack + im Test-Tenant aktiv geschaltetes Projekt-Modul; ohne E2E-Credentials/Modul skippt der Smoke sauber. Interim-Visual-Baseline (D21) bleibt offen. ### 2026-07-15 — Nachzug: CustomFieldValue-Storage + echtes Drag&Drop (Restarbeiten RA-C1) Zwei versteckte Rest-Positionen aus dem Dev-Nachzug (2026-07-08) geschlossen. **Kein Schema-Change nötig** (also kein `prisma db push`/Migration): beide Lücken waren reine Verdrahtung. **1) Custom-Feld-Werte am Projekt (Storage + Wiring).** Wichtiger Befund: der Nachzug-Vermerk „kein CustomFieldValue-Storage im Schema" war überholt — das **polymorphe `CustomFieldValue`** (in `crm.prisma`, ENTITY-MODEL Domäne 5) trägt `projekt` bereits im `CustomFieldEntityType`-Enum („so P7/P8 attach without a migration"), ist tenant-scoped (`TENANT_SCOPED_MODELS`) und RLS-policied (`crm-isolation.sql`). Kein neues, projekt-spezifisches Modell angelegt (das wäre eine Duplizierung gegen das LOCKED ENTITY-MODEL und ein PR-Block). Stattdessen die bestehende Struktur verdrahtet: - Neuer Service `setProjectCustomFieldValue` (`projectService.server.ts`): prüft `projects.write` + Projekt-Edit-Scope, validiert Definition-Existenz + entityType-Match, upsertet in `CustomFieldValue` (auto-audit via M001), loggt `project_updated`-Activity (DoD 14). RLS-gebunden via `withTenantRLS`. - Loader `loadProjektDetailP8` liest jetzt `getCustomFieldValues` + `listCustomFieldDefinitions` (entityType `projekt`) und liefert `customFieldDefs`; VM `ProjektDetailData` um `customFields` erweitert; `ProjektDetailPage` rendert eine Custom-Felder-Karte (Read-only-Liste + Set-Formular, nur bei `canWrite`). Intent `setCustomField` im Route-Action + `projects.write`-Gate. **2) Echtes Drag&Drop im Admin-Stage-Editor.** Die Interim-Hoch/Runter-Buttons durch echtes Drag&Drop ersetzt — `@dnd-kit` (bereits Dependency, gleiches Muster wie `formWidget`-Canvas/`PipelineKanbanPage`): `PipelineAdminPage` hat jetzt `StageList` (DndContext + verticalListSortingStrategy) mit Greif-Handle je Stage. Beim Drop persistiert der neue Intent `reorderStages` die komplette Reihenfolge über den neuen Service `reorderPipelineStages` (Positionen in 10er-Schritten neu vergeben, RLS-gebunden). VM/Loader/Action-Grenze unangetastet (Component ruft nur `onSubmit`). **Proof (lokal, Worktree):** `pnpm --filter @hivegrid/web typecheck` grün · `pnpm --filter @hivegrid/db typecheck` grün · `pnpm lint` grün (0 Warnungen) · `pnpm run verify:tenant-policy-contract` PASS 268/268 (kein neues RLS-Modell) · `pnpm run verify:i18n` grün. Tests: `projects.vm.test` 16/16 (inkl. 2 neue customFields-Fälle), `ProjektDetailPage` 10/10 (2 neue: setCustomField + Perm-Gate), `PipelineAdminPage` 5/5 (1 neu: Drag-Handle statt Up/Down), `projectService` 28/28. i18n-Keys ergänzt (de+en): `projects.detail.section.customFields`, `projects.detail.customFieldsEmpty`, `projects.fields.customField`, `projects.admin.dragStageAria`. **Stand:** DoD unverändert 9/9 = 100 %. Zwei Dev-Nachzug-Residuen (Custom-Feld-Werte am Projekt · echtes Drag&Drop) sind damit **erledigt**. Weiter offen (getrackter Nachzug, außerhalb DoD): finale Subframe-Optik (`design-nachzug`), e2e-Smoke/Hot-Swap-Drill/Visual-Interim-Baseline (CI-blockiert). ### 2026-07-18 — Audit: gestrandete Restarbeiten geborgen + Interim-Test-Tail (Branch `feat/r-p8-restarbeiten`) **Audit-Befund:** Die oben dokumentierten Nachzüge vom 2026-07-15 (Custom-Feld-Wiring + Admin-Drag&Drop, Commit `7f4a99ffd`) lagen **nur auf lokalen `worktree-agent-*`-Branches** — nie gepusht, nie gemergt; der Plane-Kommentar vom 15.07. meldete sie trotzdem als erledigt. Zusätzlich fehlte gegen die AD-28-Interim-Messlatte der komplette Test-Tail (D19/D20/D21) im Repo — real also 10/13 statt der gemeldeten 100 %. **Umsetzung:** (1) RA-C1 path-scoped aus `7f4a99ffd` geborgen (nur P8-Pfade; VR-P22b-/Forms-/Tracker-Anteile bewusst nicht übernommen), i18n-Keys chirurgisch gespliced — Commit `429a45d44`. (2) D19-Smoke aus demselben Commit übernommen (`tests/e2e/projekt-smoke.spec.ts`). (3) D20: `createProjektBoardInterimFixtureViewModel/-Page` via echtem `buildKanbanVM` in `@hivegrid/ui-mock` + M017-Hot-Swap-Drill-Registrierung. (4) D21: Interim-Visual-Baseline `r-p8-projects-interim` erzeugt und in `verify:ui-visual` verdrahtet (Pass-Count 127 → 130). **Proof:** `pnpm --filter @hivegrid/web typecheck`, `@hivegrid/view-models`, `@hivegrid/ui-mock` grün · `verify:i18n` Exit 0 · `projects.vm.test` 17, Projekt-Screens+Service 43, `ui-mock/index.test` 20, `verify-ui-mock-visual.test` 32 grün · `pnpm run test:hot-swap` grün · `verify:ui-visual` 130 passed / 0 failed · `playwright --list` sammelt den Projekt-Smoke. **Stand:** R-P8a: **13/13 DoD = 100 % done** (9 Original + 4 Audit-Nachtrag D18–21). Kein Schema-Change, keine Migration. Offen bleibt ausschließlich der getrackte `design-nachzug` (finale Subframe-Optik + visuelle Browser-Abnahme, siehe Tag). > **Querverweis (2026-07-18, Akeshan, dependency-aware — Subframe-Delta-Nachzug, Branch `feat/subframe-p8-delta-nachzug`):** > Der P8-Flow in Subframe ist von 10 auf 17 Seiten gewachsen; der `design-nachzug` wurde UI-seitig weitgehend abgetragen: > S00 Boards-Startseite (neuer Screen `BoardsStartPage` + Route `/projects/boards` + Sidebar-Eintrag, gleiche Read-Permission wie `/projects`), > S01a/S03a Empty-States, S01b 2-Spalten-Umbruch (Component-Sync `KanbanColumn`/`KanbanCard`; **Breaking-Card-API** → `PipelineKanbanPage` > und `LeadBoardPage` auf Slot-API migriert, `SortableKanbanBoard` forwarded `showSum/twoColumn/wrapAfter`), S02a Edit-Modus-Banner + > System-Feld-Tags, S07a Dialog-Error-State (inkl. minimaler Server-Duplikat-Check in `projectService.createPipeline`, > Key `projects.error.pipelineNameDuplicate`), M03 Karten-Kontextmenü. Demo-Seed um 6 „Neu"-Projekte erweitert (P-00009…P-00014, 2× idempotent > verifiziert). Engine/Schema/Worker unangetastet, keine Migration. Rest-Delta und Details: `.planning/SUBFRAME-FLOW-INVENTAR.md` (5. Update). > Die visuelle Browser-Abnahme auf Staging bleibt offen (nach Merge/Deploy). > **Querverweis (2026-07-18, Akeshan, dependency-aware — Polish nach Staging-Sichtung, Branch `feat/subframe-p8-boards-hierarchy`):** > Drei Befunde aus der Staging-Sichtung umgesetzt: (1) **Navigations-Hierarchie aufgelöst** — die P8-Wireframes (Stand 2026-07-08, > kein S00, Einstieg = Kanban mit „zuletzt genutztes Board") sind älter als Davids Subframe-„S00 Boards-Startseite" (2026-07-15, > „Wähle ein Board aus"); die neueste Aussage gewinnt: **ein** konsolidierter Sidebar-Eintrag „Boards" → `/projects/boards` > (`activePaths: ["projects"]` hält ihn auf Kanban/Liste/Detail aktiv), der bisherige „Projekte"-Eintrag entfällt. > Mit David rückbestätigen; Wireframes-Nachzug (S00 in WF-P8) offen. (2) Boards-Seite auf geteilte `PageShell`/`PageHeader`-Primitives > + volle Breite gehoben (`max-w-7xl`-Wrapper der Route entfernt) — Headline/Container jetzt wie die übrigen Screens bzw. Subframe-S00. > (3) S01b-Umbruch-Bug: `wrapAfter` war fix 6 — bei >12 Karten erzeugte `grid-flow-col` überzählige Tracks mit überlappenden Karten > (auf Staging sichtbar); jetzt `max(6, ceil(Karten/2))`. > **Querverweis (2026-07-18, Akeshan, dependency-aware — Backend-Nachzug fürs P8-Rest-Delta, Branch `feat/p8-boards-backend-nachzug`, von Akeshan explizit beauftragt trotz R-P8-Ownership):** > (1) **S00-Sperr-/Anfrage-Semantik:** Neues Modell `PipelineAccessRequest` in eigener `prisma/schema/pipelineAccessRequest.prisma` > (AD-21, bare-String-Refs — `projekt.prisma` unangetastet), RLS-Vertrag 292→293 (`tenant-scope-manifest` + Generator), Migration > `20260718090000_wf_p8_pipeline_access_request` (DO-guarded, Inverse-SQL, FORCE RLS + Policy). Gesperrte Boards (deny-Regel) > erscheinen auf `/projects/boards` ausgegraut mit „Nutzung anfragen"; Anfrage → Notification an `projects.admin` (M011) + Audit > `pipeline.access_requested`; User-Freigabe in den Board-Einstellungen resolved offene Anfragen (approved). (2) **„Hängt N T"**: > Karten-Tag ab 7 Tagen Verweildauer im Stage (Batch aus `ProjektStageChange`, kein N+1; nur offene Spalten). (3) **Kontextmenü**: > Duplizieren (`duplicateProject` — neue HiveNumber, Stammdaten + Kontakt-Links, keine Won/Lost/Undo-Felder) + Archivieren > (Confirm-Dialog → bestehendes `archiveProject`, Gate `projects.delete`). `handleKanbanIntent` mit `kanbanIntentPermission`. > Offen: Schwester-Route `projects.pipelines.$pipelineId` ohne die neuen Menü-Items; Kontextmenü-Undo bewusst ausgelassen. --- ## Querverweis-Notiz — WF-P8 Subframe-Baseline (2026-07-28, Akeshan) **Warum diese Notiz hier steht:** `R-P8a` gehört Raffael. Der Nachzug unten wurde vom User beauftragt und geht über reinen UI-Nachzug hinaus (Schema + Services), darum die dependency-aware Dokumentation nach AGENTS.md §„Ticket-Änderungen". **Auslöser.** Davids Handoff `D-P8 + D-KANBAN` vom 2026-07-28 hat den Subframe-Flow `WF-P8 Pipelines` von 17 auf **23 Seiten** neu geschnitten. `S01b` und `S02a` sind entfallen; 6 fachlich neue Screens sind dazugekommen, die vorher **kein Backing** hatten. Lokaler Wireframe-Stand ist Source of Truth (neuer als das Origin-Repo). **Was gebaut wurde** (Branch `feat/wf-p8-subframe-baseline`): - **M04/M04a/M04b/M04c Pipeline-Übergabe** — ein Dialog mit vier Tabs. Neue Modelle `PipelineHandover` / `PipelineHandoverItem`, neues Feld `Pipeline.nachfolgePipelineId`, neue Permission `projects.handover`. Trigger ist statusbasiert (letzte Stage der Pipeline), **kein** Button — so von David validiert. - **S02-A/N/T/F Schnellaktionsmodale** — neues Modell `ProjektNotiz` mit Sichtbarkeits-Gate (`alle` / `innendienst` / `nur_ich`) + Permission `projects.notes.read_internal`; neues Feld `ProjektTermin.typ`. - **S05 Detail-Schablone + M05 Modal Bestandsfeld** — neues Modell `PipelineFieldGroup`, `PipelineFieldConfig` um `groupId/pflichtAbStageId/hinweis/istSystem/gesperrt` erweitert, neue Route `/admin/pipelines/:pipelineId/fields`. - **S02 Detailansicht** — Felder Quelle/Projekttyp/Promotion sowie Projektkontaktdaten (`Projekt.email/telefon/fax`) ergänzt. **Was bewusst unangetastet blieb.** Die Pipeline-Engine, der Stage-Move-Pfad (`moveProjectStage`), Forecast/Aggregate und der Worker. `updatePipeline` wurde nur additiv um die Nachfolge-Pipeline erweitert; bestehende Aufrufer bleiben gültig, weil das Feld nur übernommen wird, wenn das Formular es tatsächlich mitschickt. **Entscheidungen, die Raffael kennen sollte:** 1. **M04 löscht nichts.** Die Wireframes sagen nicht, was mit abgewählten Begleitdaten passiert. Umgesetzt als explizites Übergabe-Paket (was das nächste Team bekommt); abgewählte Notizen/Dateien/Aufgaben/Termine bleiben unverändert am Projekt. Nicht-destruktiv, weil ein stilles Löschen aus dem Screen nicht ableitbar ist. 2. **Nachfolge-Pipeline sitzt in den Board-Einstellungen.** Kein Subframe-Screen zeigt dieses Control, aber M04 kann ohne es nicht auslösen. Fachlich gehört es zur Board-Konfiguration. Selbstreferenz wird abgelehnt. 3. **Notizen sind ein eigenes Modell, nicht `Activity`.** Die Activity-Timeline ist flach und hat kein Leser-Gate; eine „Nur ich"-Notiz würde dort leaken. Beim Anlegen wird weiterhin ein Activity-Eintrag geschrieben — **ohne** den Notiztext. **Rest-Delta (Arbeitsliste, nicht stillschweigend weggelassen):** - S05-Feldtypen **Prozent, Datum + Uhrzeit, Person/Team, Adresse, Link** fehlen. Sie bräuchten eine Erweiterung des modulübergreifenden `CustomFieldDatentyp`-Enums (P6 CRM) samt Renderern und Validatoren — bewusst nicht blind mitgebaut, weil sonst Typen entstehen, die speichern aber nie korrekt anzeigen. - **S02 KWP-Integrationsblock** (Projektnummer/Abteilung/Sachbearbeiter/Auftragsstatus) ist read-only Sync-Bestand aus `kwp.prisma` und noch nicht an den Screen angebunden. - Die **12 Bestands-Screens** (S00/S01/S01a/S03/S03a/S04/S06/S07/S07-D/S07a/M01/M03) sind funktional integriert, aber noch nicht 1:1 gegen den neuen Subframe-Stand nachgezogen. - **Demo-Seed** für die neuen Zustände (Übergabe-Kandidaten, Notiz-Sichtbarkeiten, Feldgruppen) und die **visuelle Browser-Abnahme** stehen aus. - Aus dem Vorgänger-Nachzug weiter offen: Kontextmenü-Undo, Start-Datum + `flagVariant` auf der Karte, Deep-Link zum Anlege-Dialog. **Proof (2026-07-28).** `pnpm exec prisma validate` grün · `verify:migrations-parity` grün (3 Migrationen, Replay gegen leere DB) · `verify:tenant-policy-contract` grün (376/376) · `typecheck-web` ohne Fehler · `eslint --max-warnings=0` auf allen berührten Pfaden grün · `i18n-check` + Diacritics grün · 157 Tests in `screens/projects` + `view-models/projects` grün. **%-Stand R-P8a:** unverändert 13/13 DoD = 100 % (dieser Nachzug erweitert den Screen-Bestand, er ändert die R-P8a-DoD nicht). Der `design-nachzug`-Tag bleibt **offen** — siehe Rest-Delta oben. ### 2026-07-29 — Bestands-Screens auf Davids Baseline neu gebaut (Fortsetzung, Branch `feat/wf-p8-subframe-baseline`, PR #286) Der zweite Teil des Baseline-Auftrags: die **12 Bestands-Screens**, die am 28.07. noch als Rest-Delta offen standen, sind gegen Davids Stand vom 2026-07-28 **neu** gebaut — nicht angeglichen. R-P8a-Anteil: - **S07 Board-Verwaltung + S04 Board-Einstellungen — Aufteilung.** David schneidet die frühere Akkordeon-Seite in zwei Screens: `S07` ist eine **Board-Tabelle** (`/admin/pipelines`, eine Zeile je Board mit Typ/Spalten/Projekte/Zugriff/Status, Suche + 3 Facetten, Zeilenmenü, Fußzeile), `S04` sind die **Board-Einstellungen je Board** (neue Route `/admin/pipelines/:pipelineId`, Spaltentabelle mit Drag-Reihenfolge und Inline-Feldern, Detailfelder-Promo nach S05, M04-Nachfolge-Board, Zugriffsregeln). Beide Routen teilen sich `pipelineAdminAction.server`, damit der Schreibpfad nicht in zwei auseinanderlaufende Kopien zerfällt. Das S00-Zahnrad zeigt jetzt auf die echte S04-Route statt auf einen Hash-Anker. - **S07-D / S07a** Dialog- und Fehlerzustände des Anlege-Dialogs, **S06** Verlustgründe, **M01** Verloren-Dialog, **M03** Karten-Kontextmenü — alle auf Davids aktuellem Export. - **S00** war bereits am 28.07. fertig; die Zahnrad-/Facetten-Deltas stehen dort. **Bewusste Deltas (nicht stillschweigend weggelassen):** `SettingsPage` und `Table.Cell variant="align-right"` fehlen im lokalen Kit; die Spalten-Status-Auswahl behält die drei echten `stageKind`-Werte statt der Freitext-Status des Exports (Kanban, M01 und die Gewinn-/Verlust-Zahlen lesen genau dieses Enum); Farbe, Gewinn-%, Zugriff und Nachfolge-Board bleiben, obwohl der Export sie weglässt, weil kein anderer Screen sie konfiguriert; die Zugriffsspalte meldet die **Form** der Einschränkung, keinen Teamnamen (`PipelineAccess` hält Rollen-/Gruppen-/User-IDs); der Board-Status leitet sich aus der bestehenden gewonnen/verloren-Invariante ab, statt ein zweites Flag einzuführen, das ihr widersprechen könnte. **Proof:** Commits `eb663b702` (S00) · `c76023386` (M01) · `e08c4b064` (M03) · `8f3c27b0a` (S06) · `5b7be1026` (S04) · `2c372d942` (S07) · `fa66fcbe9` (S04-404 über den i18n-Katalog) · `7c46b6d4b` (Intent-Tests am neuen Ort). Volle lokale Gates am Ende der Strecke: `pnpm typecheck` 0 · `pnpm lint` 0 Warnungen · `pnpm test` 7876 Tests grün · `verify:ui-visual` 130 passed / 0 failed · `verify:hardcoded-strings` Exit 0. Browser-Abnahme lokal erfolgt (S00 inkl. Zahnrad-Deep-Link, S05-Rendering) — dabei zwei echte Layout-Bugs gefunden und behoben, dokumentiert im Interim-UI-Playbook §„`~/ui`-Felder in einer umbrechenden Flex-Zeile". **%-Stand R-P8a:** unverändert **13/13 DoD = 100 %**. Der `design-nachzug`-Tag ist damit **bis auf zwei benannte Punkte abgetragen** und bleibt formal offen für: (1) Demo-Seed für die neuen Zustände (Übergabe-Kandidaten, Notiz-Sichtbarkeiten, Feldgruppen), (2) Re-Baseline der Interim-Visual-Baseline `r-p8-projects-interim` auf die Subframe-Optik (DoD 21) und die visuelle Abnahme auf Staging nach Merge. Der Rest des Delta-Katalogs vom 28.07. bleibt unverändert offen (S05-Feldtypen, S02-KWP-Block — beide ohne Datenmodell). **2026-07-30 — S02 Detailansicht, Stufe B (Datenmodell), KWP-Block und S05-Feldtypen (Akeshan, Fortsetzung PR #286):** Der letzte große Rest des Baseline-Nachzugs ist gebaut. **S02 ist jetzt Davids Screen.** Kopf mit Board-Chip, ID-Pille samt Kopieraktion und „Speichern“; sechs Feldgruppen (Kontakte und Adressdaten als echte Accordions, die vier anderen divider-geführt); schwebende Schnellaktionsleiste; 340px-Seitenleiste. Der Status ist kein Header-Select mehr, sondern das erste Feld der Grunddaten. Neu verdrahtet: Projektleiter (`Projekt.projektleiterId` existierte, stand aber in keinem VM), „Zuständige Personen“ und „Monteure“ als Mehrfachauswahl über `ProjektMitglied` (jede Auswahl schreibt sofort — es gibt keinen Draft, der eine halbe Mitgliederliste halten könnte), Kontakte als Firmen- und Ansprechpartner-Karten über `Kontakt.kontaktTyp` mit Link ins CRM, und die drei Adress-Slots, die vorher **nie gelesen oder geschrieben** wurden. Die beiden optionalen Slots liegen hinter Schaltern, und der Schalter **ist** der FK: ausschalten löst den Slot und entfernt die `Adresse`-Zeile, solange kein Kontakt noch auf sie zeigt. **Stufe B (Datenmodell).** Neues `ProjektAdressDetail` (ein Zeile je Projekt und Slot) für die Adress-Zusätze — bewusst **nicht** als Spalten an `Adresse`: das ist eine geteilte CRM-Entität, ein „Zahlungsziel“ dort würde in jede Kontaktadresse lecken. **Modulübergreifend** in `crm.prisma` (gehört zu `R-P6`/Raffael, dort vermerkt): `Kontakt` bekommt Website, USt-IdNr., Handelsregister, Kundennummer, Kunde-seit, Branche, Mitarbeiterzahl, Position und Erreichbarkeit; `KontaktTelefon` bekommt einen `typ` (haupt/durchwahl/mobil/fax) statt zweier weiterer Skalare an `Kontakt`, weil ein Kontakt mehrere Durchwahlen haben kann. „Letzter Kontakt“ wird aus der Activity-Timeline **abgeleitet**, nicht gespeichert — eine Spalte wäre eine zweite Wahrheit, die beim ersten vergessenen Schreiber auseinanderläuft. S02 rendert die Kontakt-Stammdaten **read-only** und verlinkt zum Pflegen nach P6. **KWP-Block gebaut, read-only.** Projektnummer, Auftragsstatus und letzter Abgleich eines gebundenen Projekts, gelesen aus dem bestehenden `AppEntityBinding`-Snapshot — kein Schema-Change nötig, der Link existierte schon. Zwei Deltas: der Export zeichnet die Felder als Eingaben, aber KWP ist ein Inbound-Mirror ohne Schreibpfad (editierbare Felder würden Eingaben still verwerfen); und **Abteilungsnummer/Sachbearbeiter kommen im KWP-Vertrag überhaupt nicht vor** — Spiegel-Spalten dafür könnte kein Importer füllen, das ist eine Frage an David/VR-P32. **S05 Feldtyp + Options-Editor.** Der Feldtyp ist ein echter Selector über alle 12 Enum-Werte statt Lesetext, Auswahloptionen haben einen Editor mit Reihenfolge, Bezeichnung, Farbe und Hinzufügen/Entfernen. `CustomFieldDefinition.optionen` war opakes JSON ohne Leser; die Form ist jetzt einmal in `parseCustomFieldOptions`/`serializeCustomFieldOptions` festgelegt und liest Alt-Zeilen weiter. „Mehrfachauswahl“ ist **kein** zweites Flag, sondern schaltet zwischen `select` und `multiselect`. **Umtypisieren wird abgelehnt, sobald Werte gespeichert sind** (Klartext-Fehler statt ein Datum still als Zahl zu lesen); `select` ↔ `multiselect` bleibt erlaubt, beide halten Optionswerte. **Proof:** Commits `1cfe33fb2` (Feldgruppen) · `7a9fad50e` (Projektleiter + Mitglieder) · `c3679d6f2` (Kontakte-Accordion) · `48e82433f` (Adress-Slots) · `2bf2cdb92` (Seitenleiste) · `148183e0b` (Visual-Re-Baseline) · `a3817e2e4` (Feldbreite) · `f00358844` (Adress-Zusätze) · `79d5d3d19` (crm.prisma) · `3f5ffb756` (KWP read-only) · `147ba10de` (Letzter Kontakt) · `c048b06e0` (Migration + Zählwerte) · `e223fec9e` (S05). Volle lokale Gates: `pnpm typecheck` 0 · `pnpm lint` 0 Warnungen · `pnpm test` **7916 Tests grün** · `verify:ui-visual` 130 passed / 0 failed · `verify:i18n`, `verify:hardcoded-strings`, `verify:tenant-policy-contract` (377/377), `verify:cross-cutting-models` (377/377 · 230/230), `verify:prisma-baseline` alle Exit 0. `prisma migrate deploy` gegen eine **frisch erzeugte leere DB** replayt alle fünf Branch-Migrationen; die neue Tabelle kommt mit FORCE RLS und ihren vier Policies heraus (`infra/LESSONS.md §9`). Browser-Abnahme lokal erfolgt: Monteur zuweisen (Chip aus dem Loader, Activity-Eintrag), Adresse samt Zufahrt speichern und nach Reload persistent, Projektleiter über den Header, Kontakt-Stammdaten auf der Karte, S05 mit Reihenfolge/Farbe/Mehrfachauswahl gegen ein Feld im Alt-Format und der Retype-Schutz mit seiner Meldung. Dabei ein echter optischer Fehler gefunden und behoben (die Beschreibung sprengte als einziges Feld die Feldspalte). **%-Stand R-P8a:** unverändert **13/13 DoD = 100 %**. Der `design-nachzug`-Tag bleibt offen für genau noch drei Punkte, alle außerhalb der Ticket-DoD: (1) Demo-Seed für die neuen Zustände, (2) Re-Baseline der Visual-Baseline auf die Subframe-Optik + visuelle Abnahme auf Staging nach Merge, (3) die fünf S05-Feldtypen Prozent/Datum+Uhrzeit/Person-Team/Adresse/Link, die das modulübergreifende `CustomFieldDatentyp`-Enum samt Renderern brauchen. Der frühere Punkt „S02-KWP-Block ohne Anbindung“ ist damit **erledigt** (read-only gebaut); neu notiert: Abteilungsnummer/Sachbearbeiter fehlen im KWP-Inbound-Vertrag und „Firma/Kontakt suchen oder neu anlegen“ hat auf der Detail-Route keinen Intent. ## Umsetzungs-Notiz 2026-07-30 (Nachmittag) — Rest-Delta zu Davids Export abgetragen Der vom User beauftragte Durchgang „alles nachbauen, wie David es hat; was technisch nicht geht, bleibt weg und wird gemeldet". Neun Slices, jeder einzeln committed, live gegen die lokale Instanz abgenommen. **Zwei echte Fehler in der eigenen Merge-Migration** (CI-rot, `7b488c762`): der FK von `ProjektAdressDetail` auf `Projekt` scheiterte unter `FORCE ROW LEVEL SECURITY` — Postgres validiert den Constraint mit einem internen Join über `Projekt` und verweigert ihn auch dem Tabellen-Owner (42501 → P3018 in der Shadow-DB); eine leere referenzierende Tabelle hilft nicht. Der FK liegt jetzt im gleichen `NO FORCE`/`FORCE`-Fenster wie der `Pipeline`-Block. **Der lokale Replay war grün, weil diese Verbindung Superuser ist.** Zweitens hatte der M03-Commit `Projekt.redoStageId`/`redoLostReasonId` per `db push` angelegt und nie in die Migration gefaltet (AD-21). Beide Gates, die das finden — `verify:migrations-parity` und `verify:rls-live` — gehören bei Schema-Änderungen in die Pre-Push-Runde und stehen jetzt in `docs/AGENT-CHECKLIST.md`. **Demo-Seed (`d37448656`, `0fb9a026c`):** das Flaggschiff-Projekt trägt Quelle, Promotion, Beschreibung, Start/Deadline, eigene Kontaktdaten, Projektleiter, Mitglieder in beiden Rollen und alle drei Adress-Slots samt Zusätzen; Kontakte die Stufe-B-Stammdaten (nach Typ getrennt) und typisierte Zweitnummern; die Vertriebs-Pipeline drei Feldgruppen, neun Feld-Konfigurationen und drei Custom-Field-Definitionen, davon eine **absichtlich im Alt-Format** `{select:[…]}`; dazu drei Notizen (eine je Sichtbarkeit), drei Termine (einer je Typ), das Nachfolge-Board für M04 und Stage-Wechsel für „Hängt N T" und den Verlauf. Nebenbei ein bestehender Idempotenz-Fehler behoben: der Seed brach auf jedem Tenant ab, dessen Automation-Steps schon mit cuid existierten. **Suchfeld-Optik (`5dd35fd09`):** Davids borderlose Suche trug bei uns Rahmen, weiße Füllung und 8px/12px Innenabstand. Ursache ist nicht die Komponente, sondern `@tailwindcss/forms`, das jede nackte `` stylt; `TextInput`/`SearchInput`/`NumberInput`/`InputOtp` neutralisieren das längst, `FilterBar`/`DropdownMenuSelect`/`DropdownMenuMultiSelect`/`Combobox` wurden ohne diesen Reset synchronisiert. Alle vier tragen ihn jetzt. Die Leiste selbst war korrekt (surface-neutral-secondary auf surface-neutral-primary — Davids Verhältnis, im Browser gemessen). **S02-Felder (`6af02813d`, `190e0f8c0`):** Notizen auf Firmenkarte, Ansprechpartner-Karte und allen drei Adress-Slots; „E-Mail für Rechnungen"; Telefon und Ansprechpartner vor Ort am Bauherr-Slot; Durchwahl/Mobil/Fax als eigene Zeilen (dafür wird `KontaktTelefon.typ` endlich gelesen — die Spalte lag seit Stufe B ungenutzt im Schema); Adresszeile auf der Firmenkarte. **Projekt-Tags (`5f4262879`, `20b6929d1`):** die Notiz „kein Tag-Modell" war falsch — `crm.prisma` hat längst ein tenantweites `Tag` plus polymorphes `TagAssignment`, dessen Kommentar `entityType = "projekt"` ausdrücklich nennt. Kein neues Schema, keine Migration: Karten-Chips, S03-Spalte und Facette lesen über denselben Batch wie die übrigen Begleitdaten, der Filter löst Tag → Projekt-IDs auf und läuft durch `projectListWhere`, also teilen Board, Liste und CSV eine Definition. Parameter `tags`. **S05-Feldtypen (`be952d174`):** alle fünf ergänzt. Die alte Begründung („braucht erst Renderer und Validatoren") hielt nicht: für die anderen zwölf gibt es die auch nicht, jeder Wert ist heute ein String im Textfeld. Enum-Werte per `ALTER TYPE ADD VALUE` in der Branch-Migration. **Kontakt hinzufügen (`9f834d00e`):** Davids drei Wege. Die Suche ist eine eigene Loader-only- JSON-Ressource pro Projekt (der Detail-Loader baut das ganze Projekt zusammen — pro Tastendruck neu wäre absurd), liest über `crm.read_own` und bricht die vorige Anfrage ab. Angelegt wird über den CRM-Service, damit ein Projekt kein zweiter Geburtsort für Kontakte wird; das Verknüpfen ist idempotent auf (Projekt, Kontakt). **Seitenleiste (`ebc0f2081`):** alle sechs Bereiche tragen Inhalt statt eines Hinweissatzes — Verlauf, nächste Termine, offene Aufgaben, sichtbare Notizen, neueste Timeline-Einträge. Read-only bleibt Absicht: die Editoren liegen im Operations-Bereich derselben Route. Termine und Aufgaben werden dafür **selbst** gelesen, weil das P9-Operations-VM einen Zuständigen als rohe User-ID ausgibt (`principalLabel` gibt `userId || groupId` zurück) — brauchbar neben einem Picker, unbrauchbar in einer Rail-Zeile. **Neuer Fund: der Operations-Bereich selbst zeigt damit heute rohe IDs.** **Rest-Deltas geschlossen (`48de62c35`):** Kundentyp mit allen vier Optionen (Organisation = Obermenge, Unternehmen = gewerbliche Teilmenge gmbh/kg — das korrigiert auch die alte Abbildung „Organisation, die keine öffentliche Einrichtung ist", was einen Verein einschloss); Zeitraum als Mehrfachauswahl mit Vereinigung der Bereiche und einem Chip je Periode; Davids Spalten-Kebab mit Einklappen (das Kit konnte `collapsed` längst, niemand nutzte es) und Board-Einstellungen; S05-Live-Vorschau zeigt die konfigurierte Schablone statt eines leeren Platzhalters. **Proof:** Commits `7b488c762` · `d37448656` · `0fb9a026c` · `5dd35fd09` · `6af02813d` · `190e0f8c0` · `5f4262879` · `20b6929d1` · `be952d174` · `f79e8d940` · `9f834d00e` · `ebc0f2081` · `48de62c35` · `f13c9dccf`. Volle lokale Gates: `pnpm typecheck` 0 · `pnpm lint` 0 Warnungen · `pnpm test` **7940 Tests grün** · `verify:ui-visual` 130 passed / 0 failed · `verify:i18n`, `verify:hardcoded-strings`, `verify:tenant-policy-contract` (377/377), `verify:cross-cutting-models`, `verify:migrations-parity` („No difference detected"), `verify:rls-live` („PASS non-superuser migration"), `verify:prisma-baseline-equivalence` alle Exit 0. Browser-Abnahme lokal je Slice erfolgt (Suchfeld gemessen, Adress- und Notizfelder nach Reload persistent, Tag-Filter auf drei Projekte, S05-Retype samt Schutzmeldung, Kontakt suchen/verknüpfen/anlegen, sechs Rail-Bereiche mit aufgelösten Namen, zwei Zeiträume gleichzeitig, Spalte eingeklappt auf 48px). Zum Test angelegte Zeilen wurden wieder entfernt. **%-Stand R-P8a:** **13/13 DoD = 100 %**, unverändert. Offen bleibt außerhalb der DoD: (1) visuelle Abnahme auf Staging nach dem Merge, (2) „Rechnungsadresse" auf der Firmenkarte — `Kontakt` hat genau eine Adress-FK, eine zweite nur für eine hier read-only gezeigte Zeile wäre eine Spalte, die niemand pflegen kann (offener Punkt für P6), (3) Abteilungsnummer und Sachbearbeiter fehlen im KWP-Inbound-Vertrag (Frage an David/VR-P32), (4) der Inhalt des Spalten-Kebabs ist meine Wahl und braucht Davids Bestätigung, (5) rohe User-IDs im P9-Operations-Bereich (`principalLabel`), (6) Wert-Rendering pro Feldtyp fehlt für alle 17 Typen, nicht nur für die fünf neuen. ### 2026-07-31 — Live-Abnahme WF-P8, Chargen 2–7 (Branch `fix/wf-p8-kanban-abnahme-charge1`, Akeshan) Fortsetzung der gemeinsamen Abnahme des gemergten Standes gegen Davids Subframe-Projekt `f023064a5ca0` und die Wireframe-Docs. Charge 1 (S01-Kopf, Spalten, Einklappen) steht in `R-P8b.md`. Reine Screen-/Kit-Schicht plus die unten genannten Backend-Nachzüge; Pipeline-Engine, Stage-Move-Pfad, Forecast und Worker unberührt. **S02 Detailansicht** — voller Neubau nach Export: zwei Spalten mit fester Seitenleiste, Grunddaten mit Euro an den Geldfeldern, Badge-Felder ohne eigenen Rahmen, Personenfelder als Multiselect, Kontakte- und Adress-Kacheln, Schnellaktionsleiste scrollend statt umbrechend, KWP-Kachel und ein einklappbares Pipeline-Panel am Fensterrand mit eigenem Datei-Upload. **S03 Liste · S04 Board-Einstellungen · S05 Detailfelder · S06 Verlust-Gründe · S07 Board-Verwaltung** — je gegen den aktuellen Export neu gebaut (Kopfzeilen, Filterleisten, Tabellenspalten mit Icons, Sortierung archivierter Zeilen ans Ende, Dialoge ohne die grauen Bänder). S05 bekam dabei einen echten Fund: die Systemfelder hatten **gar kein Label** und listeten rohe Spaltenschlüssel; das VM trägt jetzt einen i18n-Key je Systemfeld. **S01a/S03a Empty States** — leeres Board zeigt die Meldung **über** den Spalten, die Liste zeigt bei null Projekten nur die Meldung und gar keine Tabelle. **M01 Verloren-Dialog** — auf Exportmaß (448px), Grund-Auswahl und Notiz gleich breit. **Drag & Drop repariert** — die Karte war nur über einen unsichtbaren 97×24-Streifen greifbar; jetzt ist die ganze Kachel die Ziehfläche, die gezogene Karte hängt am Zeiger und der Cursor ist für die Dauer des Ziehens die greifende Faust. Der Platzhalter einer leeren Spalte ist ausgenommen. Nebenbefund behoben: ein KWP-gebundenes Projekt quittierte den Zug mit einer **500-Seite** (`KwpProjectDomainError` lief ungefangen durch `projectActionErrorResponse`) — jetzt Klartext- Meldung plus Rücksprung der Karte. **M04/M04a–c Pipeline-Übergabe** — die vier Seiten sind vier Tab-Zustände eines Dialogs; jede Art zeichnet jetzt ihre eigene Zeile (Notiz mit Text und „Datum · Autor", Datei mit „Rolle · Größe · Datum" und Typ-Badge, Aufgabe mit Status/Fälligkeit/Priorität/Zuständigem, Termin mit Datumskachel). Dafür trägt das VM die Detailfelder je Art, der Service liefert sie aus vorhandenen Spalten. **Auslöser nachgezogen:** D-P8 sagt `S01 → M04`, gebaut war der Trigger nur auf S02 — der Stage-Wechsel gibt die Nutzlast jetzt zurück und das Board öffnet den Dialog selbst (`loadHandoverVM` teilen sich beide Einstiege, neuer Board-Intent `handoverProject`). **M05 Modal Bestandsfeld** — nach Export: Untertitel nennt die Zielgruppe, Bestandsfelder als Zeilen mit ihrem Typ, Auswahl hervorgehoben und unten bestätigt (zweiter Klick nimmt die Wahl zurück). **S02-A/N/T/F Schnellaktionsmodale** — alle vier auf 448px, ein Feld je Zeile, Exportreihenfolge, Upload als Ablagefläche mit Durchsuchen-Knopf. Fund dabei: Selects und Textfelder liefen gegen die 320px-Deckel des Kits und standen schmaler als der Rest des Dialogs. **Auf Wunsch entfernt (2026-07-31):** der Block „Übergabe an Nachfolge-Board" unten in den Board-Einstellungen (S04) — der Export zeigt ihn dort nicht. **Konsequenz, bewusst getragen:** damit setzt heute kein Screen mehr `Pipeline.nachfolgePipelineId`, und ohne dieses Feld löst M04 nirgends aus. Der Schreibpfad in `updatePipeline` bleibt unverändert und nimmt das Feld weiter an; die Eingabestelle braucht ein neues Zuhause. Ebenfalls auf Wunsch aus S07 entfernt: die Links auf Abnahmeformulare und Projektvorlagen — beide Routen sind seither nur noch per URL erreichbar (offener Punkt, siehe `projectService.test.ts`). **Bewusst nicht gebaut:** Davids Chip-Feld „Eingeladene Personen" im Termin-Dialog — `ProjektTermin` hält genau einen Zuständigen und kennt keine Eingeladenen; die Chips wären ein Bedienelement, das nichts speichert. **Proof:** 43 Commits auf dem Branch, u. a. `7d65c36b9` (S02-Modale) · `20cb8dbab` (M05 + S04) · `7f1d9b560` (M04 auf dem Board) · `b70efcbb2` (M04 nach Subframe) · `f7018f042` (Drag & Drop) · `0adf5620e` (Empty States) · `677cb739c` (S07) · `ca73870f5` (S06) · `a9e76e81b` (S05) · `028fd10d7` (S04) · `e0b099c1b` (S03). Volle lokale Gates nach Rebase auf `origin/main`: `pnpm typecheck` 0 · `pnpm lint` 0 Warnungen · `pnpm test` grün · `verify:i18n`, `verify:source-health`, `verify:ci-baseline` je Exit 0. Browser-Abnahme jedes Punkts lokal auf `app.localhost:3001` mit Demo-Daten; die Übergabe wurde einmal vollständig ausgeführt (Projekt in die Auftrags-Pipeline, 9 Positionen im Paket) und anschließend samt Stage-Wechsel, Aktivitäts- Eintrag und Hilfsverknüpfungen wieder zurückgesetzt. **%-Stand:** R-P8a **13/13 DoD = 100 %**, R-P8b **10/10 = 100 %** — beide unverändert, dies ist ein Abnahme-Nachzug an der Optik. Offen bleibt außerhalb der DoD zusätzlich zu den oben gelisteten Punkten: (7) Nachfolge-Board hat keine Eingabestelle mehr, (8) Abnahmeformulare und Projektvorlagen sind von nirgends verlinkt, (9) Re-Baseline der Visual-Baseline auf die neue Subframe-Optik, (10) visuelle Abnahme auf Staging nach dem Merge.