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

48 KiB
Raw Blame History

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

  • EIN Projekt-Kern (typisierte Superset-Tabelle: Deal- + Auftrags-Felder + CustomFieldValue) mit fortlaufenden Projekt-Nummern (HiveNumberSeq, Row-Lock/lückenlos); RLS + Soft-Delete
  • Pipeline-Engine: Pipeline anlegen/benennen/duplizieren/archivieren (typ_hint sales/auftrag/custom); PipelineStage = die Statuswerte; Validation min. 1 gewonnen + 1 verloren
  • PipelineAccess (wer sieht/bearbeitet Pipeline je Rolle/User/Gruppe)
  • PipelineFieldConfig (Feld-Sichtbarkeit + Pflicht + Reihenfolge je Pipeline/Status; nicht sichtbare Felder bleiben erhalten)
  • PipelineFieldVisibility (Field-Level-Rechte je Principal — z.B. Auftragsvolumen nur für Vertrieb; ohne Eintrag = für alle sichtbar)
  • M049: lead.qualified → Auto-Projekt (Projekt automatisch in Sales-Pipeline) — Pipeline-Wechsel-Modell, kein Won-Handoff/zweiter Datensatz
  • Lost-Reason-CRUD (kein Hard-Delete, SHK-Defaults geseedet)
  • Konnektor tenantHasModule('projects') (Sidebar + Routes + Actions gated)
  • 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):

  • D18 VM-Unit-Tests (packages/view-models/src/projects/projects.vm.test.ts — Detail/List/Kanban/Admin-Builder)
  • D19 e2e-Smoke (tests/e2e/projekt-smoke.spec.ts, gemeinsam für R-P8a/R-P8b)
  • D20 Hot-Swap-Drill (createProjektBoardInterimFixture* in packages/ui-mock + M017-Drill scripts/verify-ui-hot-swap.ts)
  • 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:<id>/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)

  • 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 <input> 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.