278 lines
33 KiB
Markdown
278 lines
33 KiB
Markdown
# R-P8b · P8 Konfigurierbarer Kanban + Forecast/Reporting
|
||
|
||
| | |
|
||
|---|---|
|
||
| **Typ** | Dev (Code) |
|
||
| **Owner** | Raffael |
|
||
| **Phase** | P8 — Projekt & Pipelines (Kern + Pipeline-Engine) |
|
||
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-28 → 2026-06-29 · Gate W3 |
|
||
| **Status** | Umgesetzt — 10/10 DoD (Audit 2026-07-18), Restarbeiten-PR offen · design-nachzug offen |
|
||
|
||
**🎨 design-nachzug: offen** (seit 2026-07-08) — Interim-UI aus `~/ui` (AD-28); S01/S03 des `WF-P8`-Flows am 2026-07-11 integriert, **Delta-Nachzug 2026-07-18** (PR #154: S01a/S03a-Empty-States, S01b 2-Spalten-Umbruch, M03 Kontextmenü, Karten auf neue `KanbanCard`-Slot-API). **Baseline-Nachzug 2026-07-28/29 (PR #286):** Board und Liste sind gegen Davids Handoff vom 2026-07-28 **neu** gebaut — `ProjectCard` statt `KanbanCard`, die S01-Filterleiste mit vier Facetten und Chips, S03 als Davids Tabelle; 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):** EIN konfigurierbarer Pipeline-Kanban (ein Board für **alle** Pipeline-Typen sales/auftrag/custom) statt getrenntem Sales-Kanban + Projekt-Kanban. Karten = Projekte des `Projekt`-Kerns. Drop in `gewonnen`/`verloren`-Stage = Pipeline-internes Stage-Event, **kein Won-Handoff**.
|
||
|
||
## Abhängigkeiten & Parallelität
|
||
- **Blocked by:** `R-P8a` (Projekt-Kern + Pipeline-Engine + PipelineAccess/-FieldConfig/-FieldVisibility)
|
||
- **Blocks:** `R-P9a` (Auftrags-Welt baut auf demselben Kern auf; `deal.won`-Event), `R-P11b` (Dashboard verbraucht Sales-Aggregate)
|
||
- **Sequenz (Raffaels Kern-Kette):** strikt sequenziell — P8b ist Glied 4 (`R-P8a → R-P8b → R-P9a …`).
|
||
- **Läuft parallel zu:** Akeshans Module W3. Schema-Trennung nach **AD-21**.
|
||
|
||
**Dependency-Stand 2026-07-01:** `R-P8a` ist serverseitig umgesetzt (Projekt-Kern, Pipeline-Engine, Field-Level-Konfig, Lost-Reasons, Permissions, M049 Auto-Projektanlage) und bleibt nur wegen fehlender `D-KANBAN`/`D-P8` Screens auf On Hold. `R-P8b` kann backendseitig auf `prisma/schema/projekt.prisma` und `projectService.server.ts` aufsetzen; visuelle Kanban-/Listen-Abnahme bleibt screen-blockiert.
|
||
|
||
## Was wir bauen
|
||
Den **EINEN konfigurierbaren Kanban** über dem Projekt-Kern: Spalten = Stages der gewählten Pipeline, Drag&Drop-Stage-Wechsel mit Validation, gewonnen/verloren-Workflow (Lost-Reason-Pflicht), Pipeline-Switcher, SSE-Realtime. Dazu die **Listen-View** (Filter/Bulk/CSV/Spalten-Konfig), **Forecast/KPIs/Stage-Conversion/Lost-Verteilung** mit Aggregat-Cache und **Field-Level-Sichtbarkeit** (Volumen/Aggregate) über `PipelineFieldVisibility` (Backstop `deals.read_aggregates`). Emittiert `deal.won` für nachgelagerte Phasen.
|
||
|
||
## Benötigte Screens (Backend bedient — Design liefert `D-KANBAN` + `D-P8`)
|
||
| Screen [Route] | Kern-Inhalt |
|
||
|---|---|
|
||
| Pipeline-Kanban (konfigurierbar) [`/projects` · `/projects/pipelines/:id`] | Spalten = Stages (Name, Projekt-Anzahl, Aggregat-Volumen gegated, Win-%); Projekt-Karten (Titel, gegatetes Volumen, Avatar, Datum, max. 3 Tags, Stuck-Marker); **Drag&Drop** mit Stage-Validation; Drop `gewonnen` → Bestätigung, Drop `verloren` → Lost-Reason-Pflicht; **Pipeline-Switcher**; Filter + „nur meine"; Bulk-Select; Pagination pro Spalte (100+); SSE-Realtime |
|
||
| Projekt-Liste [`/projects/list`] | Cross-Pipeline-Sicht (Pipeline-Spalte + -Filter), Projekt-Nummer/Titel/Stage/Volumen (gegated)/Kontakt/Zeitraum/letzte Activity, sortierbar, Spalten-Konfig, Bulk, CSV-Export, Pagination |
|
||
| Forecast/KPI-Quellen (Widgets in P11) | Datenquellen: Pipeline-Forecast (Volumen × Win-%), realisierter Umsatz, KPIs pro Verantwortlichem, Stage-Conversion-Rates, Lost-Reason-Verteilung — Aggregat-Cache (kein eigener Screen, Widgets in P11) |
|
||
|
||
## Definition of Done
|
||
- [x] **EIN konfigurierbarer Kanban** (serverseitiger Board-Contract, Stage-Wechsel-Validation, gewonnen/verloren-Workflow mit Lost-Reason-Pflicht, Pipeline-Switcher) + **SSE-Realtime**
|
||
- [x] **Listen-View** mit Filter / Sort / Bulk-Contract / Spalten-Konfig-Contract / CSV-Export / Pagination
|
||
- [x] **Forecast/KPIs** (Volumen × Win-%, realisierter Umsatz, KPIs pro Verantwortlichem) + **Stage-Conversion-Rates** + Lost-Reason-Verteilung — alles mit **Aggregat-Cache** *(Audit 2026-07-18 wieder geöffnet — Rebuild-Trigger + Owner-KPIs fehlten — und am selben Tag geschlossen, siehe Notiz „Forecast-Verdrahtung")*
|
||
- [x] **Field-Level-Permissions** (Volumen/Aggregate): primär `PipelineFieldVisibility`, Backstop `deals.read_volume_*`/`read_aggregates`; Volumen ohne Recht → „—"
|
||
- [x] 24h-Rückgängig-Banner aus gewonnen/verloren-Stages (serverseitig via `undoStageChangeUntil`)
|
||
- [x] **`deal.won`-Event** emittiert (Extension-Point für P9/Reporting)
|
||
- [x] Konnektor `tenantHasModule('projects')` (Kanban/Listen/Actions gated)
|
||
|
||
**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** (`projects.vm.test.ts` deckt `buildKanbanVM`/`buildProjectListVM` ab)
|
||
- [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)
|
||
- [x] **D21 Interim-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:** `ProjektStageChange` und `PipelineAggregateSnapshot` in `prisma/schema/projekt.prisma` ergänzt, RLS-Artefakt und Tenant-Snapshot-Registry nachgezogen. `projectService.server.ts` liefert jetzt Board-VM (`loadProjectBoard`), Stage-Move mit Validation, Lost-Reason-Pflicht, 24h-Undo (`undoLastProjectStageChange`), Listen-Query mit Filter/Sort/Pagination/CSV, Forecast/KPI-Aggregat-Cache, Field-Level-Backstop für Volumen/Aggregate und `deal.won` via Workflow-Outbox. Routes: `/projects`, `/projects/list`, `/projects/pipelines/:pipelineId`, `/projects/pipelines/:pipelineId/stream`.
|
||
|
||
**Proof:** `pnpm typecheck`, `pnpm lint`, `pnpm run verify:i18n`, `pnpm run verify:tenant-isolation-report`, `pnpm --filter @hivegrid/web test -- app/utils/integrations/projects/projectService.test.ts` und full `pnpm test` grün.
|
||
|
||
**Stand:** R-P8b: 7/7 DoD = 100 % serverseitig done. Ticket bleibt fachlich **On Hold**, bis `D-KANBAN`/`D-P8` final geliefert und die Drag&Drop-/Listen-/Banner-UI visuell abgenommen ist.
|
||
|
||
**2026-07-08 — Interim-UI aus `~/ui` (AD-28, Akeshan):** Auf der vorhandenen Backend-Basis zwei Interim-Screens (VM als Prop, kein handgeschriebenes Tailwind): **konfigurierbarer Kanban** `/projects` + `/projects/pipelines/:id` (`PipelineKanbanPage` aus `KanbanColumn`/`KanbanCard` — Spalten=Stages mit gegatetem Aggregat, Karten, Pipeline-Switcher, „nur meine", Stage-Move per Karten-Control mit gewonnen-Bestätigung/verloren-Lost-Reason-Pflicht-Dialog, Bulk-Move, Quick-Create), **Projekt-Liste** `/projects/list` (`ProjektListPage` — Filter/Sort/Spalten-Konfig/CSV-Export/Pagination, Volumen gegated). Geteilter Loader/Action `projectBoardRoute.server`. Pure VMs `project-board.vm`/`project-list.vm`; Bulk via `bulkMoveProjectStage`. Interim-Deckung DoD B 6–10 / E 22–25 grün. **Proof:** Commits `45a78df29` (Kanban), `de51eac10` (Liste); `pnpm --filter @hivegrid/web typecheck` grün, i18n-parity/`verify:sidebar-routes`/`verify:cross-cutting-models` grün; Screen-RTL (`PipelineKanbanPage` 2, `ProjektListPage` 2) + VM-Unit (`projects.vm.test`, 11) grün. **Offen (getrackter Nachzug):** finale Subframe-Optik (`design-nachzug`), echtes HTML5-**Drag&Drop** + **Live-SSE-Client** (Endpoint `…/stream` existiert, `data-sse-href` als Hinweis gesetzt), Bulk-Mutation auf der Liste (Cross-Pipeline-Semantik), Forecast/KPI-**Widgets** (bewusst **P11**), e2e-Smoke/Hot-Swap/Visual-Interim-Baseline (CI/Windows). %-Stand unverändert 7/7 serverseitig; Interim-UI-DoD steht, finale Optik bleibt Nachzug.
|
||
|
||
**2026-07-08 (Interim-Nachzug 2):** Kanban um echtes HTML5-**Drag&Drop** ergänzt (Karte ziehen → Zielspalte; Drop auf gewonnen/verloren löst weiter Bestätigungs- bzw. Lost-Reason-Pflicht-Dialog aus; Karten-Select bleibt als Fallback/a11y), **Freitext-Suche** (serverseitig über `loadProjectBoard({ q })` → `projectListWhere`) und **Demo-Daten-Toggle** (`?demo=show`) — Projekt-Liste ebenfalls mit Demo-Toggle. Board rendert bei unbekannter Pipeline-ID jetzt **404 statt 500** (`loadKanbanData` fängt den `CatalogError` ab). Proof: `pnpm --filter @hivegrid/web typecheck` grün, `PipelineKanbanPage.test` (5) + `ProjektListPage.test` (3) + `projectService.test` (25) grün. **Weiterhin offen (Nachzug):** Live-SSE-Client — der Stream (`…/stream`) sendet nur Snapshot-on-connect + 30s-Heartbeat, **keine Change-Events**; echtes Realtime braucht Backend-Pub/Sub (moveStage → publish), also über Interim hinaus. Ebenfalls offen: Bulk-Mutation auf der **Liste** (Cross-Pipeline-Semantik; interim nur auf dem Board), **finale Subframe-Optik** (`design-nachzug`), e2e/Hot-Swap/Visual-Baseline. **Bewusst v2:** Forecast/KPI-Widgets → P11.
|
||
|
||
**2026-07-11 — P8-Subframe-Nachzug:** S01 Kanban und S03 Projekt-Liste aus `WF-P8 Pipelines` in die vorhandenen Screens übernommen: Subframe-nahe Header-, Ansichtswechsel-, Filter-, Tabellen- und Board-Struktur, ohne Router-/DB-Zugriff im Screen. `canAdmin` wird im servergebauten Board-VM ausgewertet; Board, Liste und Pipeline-Konfiguration sind über tenant-spezifische Pfade verbunden. **Proof:** Tenant-Routen-Typecheck grün; `PipelineKanbanPage` 7/7, `ProjektListPage` 3/3 und `projectService` 25/25 Tests grün; `verify:i18n` grün; fokussiertes ESLint ohne Warnungen. **Stand:** 7/7 DoD = 100 % done · 0 DoD-Punkte offen. Nachzug: visuelle Browser-/Snapshot-Abnahme und der bereits dokumentierte echte Live-SSE-Publish/Client.
|
||
|
||
**2026-07-11 — Staging-Demo-Proof:** Sieben Business-Demo-Projekte sind über offene, gewonnene und verlorene Sales-Stages sowie Montage/Abnahme der Auftragspipeline verteilt. Werte, Prioritäten und relative Deadlines decken Karten, Aggregate, Stuck-Marker, Pipeline-Wechsel und Tabellenansicht ab; die UI zeigt sie bewusst erst mit aktiviertem Demo-Daten-Filter. **Proof:** idempotenter `stagingDomainDemoSeed` mit fokussiertem 2/2-Test. **Stand:** 7/7 DoD = 100 % done.
|
||
|
||
## Technische Bausteine
|
||
- **Erweitert `prisma/schema/projekt.prisma`** (keine neuen Kern-Entities — Kanban/Forecast lesen auf Projekt/Pipeline/Stage aus R-P8a); Aggregat-Cache-Tabelle bzw. materialisierte Sicht für Forecast/KPIs.
|
||
- **RLS** durchgängig (AD-1); Kanban-Query filtert über `PipelineAccess` + `PipelineFieldVisibility` (server-seitig, nie durchsickern).
|
||
- **SSE-Realtime** für Karten-Bewegung + Spalten-Aggregate; Stage-Wechsel append-only in **Activity** (P6) + `deal.won`-Event.
|
||
- **HiveNumberSeq** (aus R-P8a) bleibt Quelle der Projekt-Nummern; hier nicht neu.
|
||
- **Konnektor** `tenantHasModule('projects')` gated.
|
||
- `is_demo_data`-Flag auf Demo-Projekten respektiert (Aggregate filtern bei Echt-Start-Bereinigung).
|
||
|
||
## Quellen (granular)
|
||
- `ENTITY-MODEL.md` → **Domäne 5** (Projekt/Pipeline/Stage + PipelineFieldVisibility für gegatete Aggregate) — 🔴 **Pivot-Vorrang (AD-20)**: ein Board für alle Pipeline-Typen, kein Won-Handoff
|
||
- `REQUIREMENTS.md` → `REQ-projekt-kanban-listen-view`, `REQ-projekt-forecast-kpis`, `REQ-pipeline-rechte-config` (Field-Level) (Phase 8)
|
||
- `ROADMAP.md` → Phase 8 (+ Pivot-Note)
|
||
- `designer-briefs/P08-projekt-pipelines-kern.md` (Kanban BESPOKE, Pivot-Vorrang-Hinweis)
|
||
|
||
## Dev-Nachzug (nach Davids `D-KANBAN`/`D-P8`-Delta)
|
||
- [x] S01 Kanban und S03 Liste gegen den Subframe-Flow integriert
|
||
- [ ] Visuelle Browser-/Visual-Regression-Abnahme
|
||
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
|
||
- [ ] REQUIREMENTS/ROADMAP nachgezogen
|
||
- [ ] Plane-Ticket `R-P8b` aktualisiert
|
||
|
||
### 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: echter SSE-Publish + Listen-Bulk (Restarbeiten RA-C2)
|
||
Die beiden zuletzt offenen Nachzüge aus der Notiz vom 2026-07-08 sind geschlossen.
|
||
|
||
**1. Echter Live-SSE-Publish/Client (vorher nur Snapshot + 30s-Heartbeat).** Als Pub/Sub wird der **bereits vorhandene** In-Process-`EventEmitter` (`~/utils/stream/emitter.server`) genutzt — derselbe, der schon den Workflow-Execution-SSE-Stream trägt. **Keine neue Infra-Abhängigkeit.** Neu: `projectBoardEvents.shared.ts` (reiner Wire-Contract: Event-Name + Change-Payload, ohne Server-Imports, damit der Client-Hook ihn importieren darf) und `projectBoardEvents.server.ts` (`projectBoardChannel(tenantId, pipelineId)` = `projectBoard:<tenantId>:<pipelineId>`, `subscribeToProjectBoard`, `publishProjectBoardChange`; hebt einmalig das 10-Listener-Limit, da viele Board-Viewer denselben Kanal abonnieren). Publish-Punkte liegen bewusst in der **Orchestrierungs-Schicht** (`projectBoardRoute.server`, `projectDetailRoute.server`, `projects.list`-Action), nicht im `projectService.server` — so bleibt der Service frei von `emitter.server` (dessen `loadRequiredWebConfig()` beim Modul-Load sonst in den reinen Service-Test-Importgraph gezogen würde). Abgedeckte Mutationen: Stage-Move (Board **und** Detail), Bulk-Move, Quick-Create, Stammdaten-Update, 24h-Undo, Listen-Bulk-Archiv. `bulkMoveProjectStage` liefert dafür jetzt zusätzlich die betroffenen `pipelineIds`. Der Stream (`…/stream`) sendet weiterhin Snapshot-on-connect + Heartbeat, **plus** echte `projects.board.changed`-Events. Client: neuer Hook `useBoardLiveUpdates` (EventSource auf `sseHref`, revalidiert die Route bei jedem Change-Event), verdrahtet in **beiden** Board-Routes. Der Screen bleibt pur (kein Router-Hook in `PipelineKanbanPage`), das VM wird weiter serverseitig gebaut — Loader/VM-Grenze unverändert. Heartbeat/Snapshot lösen keine Revalidierung aus, also keine Poll-Schleife.
|
||
|
||
**2. Cross-Pipeline-Bulk auf der Liste.** Bewusst **Bulk-Archiv** statt Bulk-Stage-Change: Stages gehören zu genau einer Pipeline, ein Stage-Wechsel ist also pipeline-gebunden und über eine Cross-Pipeline-Auswahl nicht sinnvoll definiert — Archivieren gilt dagegen einheitlich für jedes Projekt, unabhängig von seiner Pipeline. Neu im Service: `archiveProject` + `bulkArchiveProjects` (gated über `projects.delete`, RLS via `withTenantRLS`). **Cross-Pipeline-Semantik:** jedes Projekt wird einzeln gegen seinen **eigenen** Pipeline-Edit-Scope geprüft (`projectEditScopeWhere` wertet `PipelineAccess` pro Projekt aus) — eine Auswahl über mehrere Pipelines hinweg wird also Projekt für Projekt korrekt autorisiert, statt pauschal gegen eine Board-Pipeline. Reuse von `normalizeBulkProjectIds` (100er-Limit) und `publishProjectSearchUpsert` (setzt `archived` aus `archivedAt`, Zeile fällt aus der aktiven Suche). Die `/projects/list`-Route bekommt eine `action` (`bulkArchive`-Intent nach dem bestehenden Single-Mutation-Muster der Board-Route) und publiziert pro betroffener Pipeline ein Board-Change-Event. VM: `ProjectListData.canArchive` (aus `projects.delete`, optionales Input-Perm, Default `false`). Screen: Zeilen-Auswahl + „Alle auswählen", Bulk-Bar mit Anzahl, Archiv-Button mit Bestätigungs-Dialog; ohne `projects.delete` erscheint keine Auswahl-Spalte. Neue i18n-Keys unter `projects.listView.*` (de + en).
|
||
|
||
**Proof:** `pnpm --filter @hivegrid/web typecheck` und `pnpm --filter @hivegrid/view-models typecheck` grün (Exit 0); `pnpm lint` grün (Exit 0, `--max-warnings=0`); `pnpm run verify:i18n` grün (Exit 0); Unit-Tests grün: Projekt-Screens + `projectService` + `projects.list`-Route **74/74** (u.a. neu `ProjektListPage` „cross-pipeline bulk-archives the selected rows" und „hides bulk-archive selection without the archive permission"), view-models **433/433**. Kein Schema-Change (AD-21: kein `db push`, keine Migration) — `archivedAt` existiert bereits. **Einschränkung, bewusst:** Der End-to-End-Beweis des Live-Streams (zwei Browser-Sessions, Karte bewegen, zweites Board aktualisiert sich) braucht einen laufenden Stack und ist lokal nicht gelaufen; verifiziert sind Contract, Verdrahtung und Typen. **Scope-Hinweis:** Der Emitter ist **prozess-lokal** — bei einer einzelnen `hivegrid-web`-Instanz (aktueller Stand) erreichen die Events alle Board-Clients; horizontale Skalierung von web bräuchte einen prozessübergreifenden Transport (z.B. Redis-Pub/Sub) hinter derselben publish/subscribe-API.
|
||
|
||
**Stand:** R-P8b: 7/7 DoD = **100 % done** (unverändert; die beiden Punkte waren Nachzüge, keine offenen DoD-Boxen). Offen bleiben nur: visuelle Browser-/Visual-Regression-Abnahme (Interim-Baseline, Staging) und die finale Subframe-Optik (`design-nachzug`, wartet auf David).
|
||
|
||
> 💡 Vorschlag (außerhalb Ticket-Scope): Sobald `hivegrid-web` auf mehr als eine Instanz skaliert, muss `projectBoardEvents.server.ts` auf einen prozessübergreifenden Transport (Redis-Pub/Sub) umgestellt werden — die publish/subscribe-API ist dafür bereits die einzige Nahtstelle. Betrifft genauso den bestehenden Workflow-SSE-Stream, der denselben Emitter nutzt. Eigenes Ticket, falls gewünscht.
|
||
|
||
### 2026-07-18 — Audit: gestrandete Restarbeiten geborgen + Interim-Test-Tail (Branch `feat/r-p8-restarbeiten`)
|
||
|
||
**Audit-Befund:** Die RA-C2-Nachzüge (echter SSE-Publish + Listen-Bulk-Archiv, Commit `fa56081e9` vom 2026-07-16) lagen **nur auf lokalen `worktree-agent-*`-Branches** — nie gepusht, nie gemergt; der Plane-Kommentar vom 16.07. meldete sie trotzdem als erledigt. Der Working Tree hatte weiterhin nur Snapshot+Heartbeat-SSE und eine Action-lose Liste. Zusätzlich fehlte der komplette Interim-Test-Tail (D19/D20/D21), und DoD 3 (Forecast/KPIs) ist real nur teilweise erfüllt (Cache ohne Rebuild-Trigger, keine Owner-KPIs) — real also 4/10 statt der gemeldeten 100 %.
|
||
|
||
**Umsetzung:** (1) RA-C2 vollständig geborgen (ohne `RESTARBEITEN-TRACKER.md`): `projectBoardEvents.server/.shared`, `useBoardLiveUpdates`, Stream-/Board-/List-Routen, `archiveProject`/`bulkArchiveProjects`, Listen-Bulk-UI, `canArchive`-VM, i18n `projects.listView.*` — Commit-Nachweis auf diesem Branch. (2) D19/D20/D21 wie in der R-P8a-Notiz vom 2026-07-18 (gemeinsamer Smoke, Kanban-Fixture, Visual-Baseline `r-p8-projects-interim`).
|
||
|
||
**Proof:** `pnpm --filter @hivegrid/web typecheck` + `@hivegrid/view-models` + `@hivegrid/ui-mock` grün · `verify:i18n` Exit 0 · Projekt-Screens/Service/VM-Suiten 89/89 grün · `pnpm run test:hot-swap` grün · `verify:ui-visual` 130 passed / 0 failed.
|
||
|
||
**Stand:** R-P8b: **9/10 DoD = 90 % done** (vorher gemeldet: 100 %). Offen: DoD 3 (Forecast-Aggregat-Cache ohne Rebuild-Trigger + fehlende Owner-KPIs — Scope-Entscheid „jetzt vs. P11-Widgets" steht aus, siehe DoD-Anmerkung) sowie der getrackte `design-nachzug`. Kein Schema-Change, keine Migration.
|
||
|
||
### 2026-07-18 — Forecast-Verdrahtung: Rebuild-Trigger + Owner-KPIs (DoD 3 geschlossen)
|
||
|
||
**Scope-Entscheid:** DoD 3 gehört nach Quellenlage zu R-P8b (`REQ-projekt-forecast-kpis` ist Phase 8; `R-P11b` konsumiert die Aggregate nur als `blocked-by`-Abhängiger). Entsprechend jetzt hier verdrahtet, kein Schema-Change (`scopeKey` ist freier String).
|
||
|
||
**1. Rebuild-Trigger.** Neuer Helfer `refreshPipelineAggregatesAfterMutation` (`projectService.server.ts`): läuft **nach** der committeten Mutations-Transaktion, aggregiert also den committeten Stand; Fehler sind fail-open (strukturierter `project-aggregate-refresh-failed`-Log über den scoped Logger, die Schreibaktion schlägt nie deswegen fehl — Cache ist abgeleitete Daten). Verdrahtet an allen Forecast-relevanten Mutationen: `moveProjectStage`, `bulkMoveProjectStage`, `undoLastProjectStageChange`, `createProject`, `createProjectFromQualifiedLead` (M049), `updateProjectStammdaten` (Volumen/Owner), `archiveProject`/`bulkArchiveProjects`, `upsertPipelineStage`/`archivePipelineStage` (Win-%-Änderungen). Bulk-Pfade refreshen einmal pro betroffener Pipeline (internes `refreshAggregates: false` an der Einzel-Mutation), nicht pro Projekt.
|
||
|
||
**2. Owner-KPIs.** `rebuildPipelineAggregateCache` schreibt zusätzlich `owner:<userId>`-Snapshot-Zeilen je `zustaendigePersonId` (projectCount, Potenzial-/Auftragsvolumen, gewichteter Forecast, realisierter Umsatz, lostCount + Lost-Reason-Verteilung); Owner ohne Projekte werden per Stale-Cleanup (`deleteMany` auf `owner:*` not-in) entfernt. `getPipelineForecast` liefert die Zeilen als `ownerKpis`, Geldwerte weiter über die Aggregat-Sichtbarkeit gegated (`PipelineFieldVisibility` + `deals.read_aggregates`-Backstop); der `projects.read_all`-Guard des Forecast-Readers bleibt unverändert.
|
||
|
||
**Kein eigener Screen** — die Ticket-Doc legt fest „kein eigener Screen, Widgets in P11"; die Interim-UI-Stilvorgabe greift daher nicht (kein UI-Anteil). `R-P11b` kann sein `sales.forecast`-Widget (rechnet aktuell live per `groupBy`) beim P11-Nachzug auf `getPipelineForecast` umstellen — dependency-aware vermerkt.
|
||
|
||
**Proof:** `pnpm --filter @hivegrid/web typecheck` grün · fokussiertes ESLint grün · `projects`-Suiten 133/133 grün, darunter neuer Contract-Test „populates the aggregate cache after mutations and exposes owner KPIs" (prüft Owner-Scope, Stale-Cleanup, fail-open-Log und dass ALLE zehn Mutationspfade den Refresh rufen). Commit `a8d33e43c`.
|
||
|
||
**Stand:** R-P8b: **10/10 DoD = 100 % done** (nach PR-Merge). Offen bleibt nur der getrackte `design-nachzug`.
|
||
|
||
### 2026-07-29 — WF-P8-Baseline: Board und Liste neu aus Davids Export (Branch `feat/wf-p8-subframe-baseline`, PR #286, Akeshan, dependency-aware)
|
||
|
||
Davids Handoff `D-P8 + D-KANBAN` vom 2026-07-28 ist die neue Baseline; die Interim-UI aus
|
||
`~/ui` ist damit auf der R-P8b-Strecke abgelöst. Haupt-Querverweis und der Backend-/Schema-Anteil
|
||
stehen in `R-P8a.md`. **Loader/VM-/Intent-Grenze, Stage-Move-Pfad, SSE-Wiring und der
|
||
Forecast-Cache blieben unangetastet** — geändert wurde die Screen-Schicht plus additive
|
||
Board-Backing-Felder.
|
||
|
||
**S01 Kanban.** Davids neue Design-System-Komponente **`ProjectCard`** ersetzt `KanbanCard` auf
|
||
dem Board. Dafür ist das Board-Backing additiv gewachsen: Untertitel (primärer Kontakt · Ort des
|
||
Projektstandorts), Projekttyp als Tag, Start-/Enddatum als Datumsband, nächster Termin als Pille;
|
||
die Priorität trägt jetzt die Kartenfarbe statt eines Badges. Die Begleitdaten kommen über **vier
|
||
feste Queries pro Board** (kein N+1 bei bis zu 100 Karten je Spalte), alle in der RLS-Transaktion
|
||
des Aufrufers. Der Untertitel wird im VM gejoint, damit bei nur einer vorhandenen Hälfte kein
|
||
einzelnes „·" stehenbleibt; Datumswerte bleiben bis zum Screen ISO und werden erst dort in der
|
||
App-Zeitzone formatiert. Griff und Mehrfachauswahl liegen in einer eigenen Zeile im Tag-Slot,
|
||
weil Davids Karte keinen Platz dafür vorsieht.
|
||
|
||
**S01-Filterleiste.** Davids `FilterBar` und `DropdownMenuMultiSelect` sind ins `~/ui`-Kit
|
||
übernommen (neuer Screen-Baustein `BoardFilterBar`) — genau die beiden Komponenten, deren Fehlen
|
||
bei S00 und S07 noch der Grund für die einfachen Selects war. Der Board-Umschalter ist ein
|
||
Header-Chip, die Freitextsuche sitzt in der Leiste, jeder aktive Filter erscheint als
|
||
entfernbarer Chip mit „Zurücksetzen". Vier Facetten sind end-to-end verdrahtet — **Sachbearbeiter**
|
||
(inkl. „Ohne Zuordnung"), **Kundentyp**, **Zeitraum** (inkl. eigenem Von/Bis) und **Auftragswert**;
|
||
alle laufen durch `projectListWhere`, damit Board, Liste und CSV **eine** Filterdefinition teilen
|
||
statt drei. Parameter: `owner` · `kundentyp` · `zeitraum` (+`von`/`bis`) · `wert`.
|
||
|
||
**S03 Projekt-Liste** ist auf Davids Tabelle neu gebaut; sie zieht ihre Begleitdaten über
|
||
denselben Batch wie die Board-Karte, aber **opt-in** — der CSV-Export rendert keine dieser
|
||
Spalten und soll die drei Zusatz-Queries über bis zu 10.000 Zeilen nicht bezahlen.
|
||
|
||
**Bewusste Deltas (nicht stillschweigend weggelassen):**
|
||
- **Tags** fehlen sowohl als S03-Spalte als auch als Facette — es gibt kein Projekt-Tag-Modell.
|
||
- **Zeitraum** ist Single-Select: zwei Perioden gleichzeitig bedeuten nur „die weitere von
|
||
beiden", was aus Checkboxen niemand ablesen kann.
|
||
- **Auftragswert** rendert nur mit `deals.read_volume_all` — eine Bandauswahl verrät sonst genau
|
||
die Zahl, die das Karten-Gate zurückhält.
|
||
- **Kundentyp** bietet die drei Zustände, die `KontaktTyp`/`OrgMerkmal` wirklich unterscheiden;
|
||
der Export listet „Organisation" und „Unternehmen" nebeneinander, was bei uns dieselben Zeilen
|
||
liefert.
|
||
- S03: das Zeilen-Kebab entfällt (sein einziger echter Eintrag würde den Zeilen-Link doppeln);
|
||
„Kontaktrolle" ist nicht gespeichert, die Kunden-Unterzeile trägt daher Projekttyp und Ort.
|
||
- **Vier Abweichungen an den Kit-Komponenten, an David gemeldet:** Freitextfeld und
|
||
„Zurücksetzen"-Knopf der `FilterBar` sind im Export totes Markup ohne Handler, die Checkboxen
|
||
der Multi-Select-Einträge spiegeln die Auswahl nicht, und `DropdownItem` schließt als
|
||
Radix-Menu-Item das Menü bei jedem Klick — für ein Multi-Select unbrauchbar. Ebenso hardcodet
|
||
`ProjectCard` die deutschen Prioritätswörter im Badge; das Label ist lokal ein Prop.
|
||
|
||
**Umsetzungsdetails:** Kundentyp löst seine Kontakte in einer eigenen Query auf, weil
|
||
`ProjektKontakt` nur eine nackte `kontaktId` ohne Relation zu `Kontakt` hält; die
|
||
Sachbearbeiter-Optionen kommen aus der **ungefilterten** Board-Population, sonst würde die
|
||
Auswahl eines Sachbearbeiters alle anderen aus dem Dropdown entfernen; „Zurücksetzen" verwirft
|
||
Suche, Nur-meine und alle Facetten in **einer** Navigation.
|
||
|
||
**Browser-Abnahme 2026-07-29 — zwei echte Fehler gefunden und behoben:** die Datumsfelder des
|
||
eigenen Zeitraums lagen im Zeitraum-Dropdown, dessen Panel nicht mitwächst (das Board schien
|
||
durch) und das ein nativer Datepicker schließt → sie stehen jetzt inline in der Leiste; und ein
|
||
per URL gesetztes „Ohne Zuordnung" filterte ohne Chip weiter, wenn kein Projekt unzugeordnet war.
|
||
|
||
**Proof:** Commits `40b39f013` (`ProjectCard` ins Kit) · `ad6cdeb6f` (Karte aufs Board) ·
|
||
`f6e73aeba` (S03) · `3b5b31d97` (Zähler-Pluralisierung) · `d3b05c56f` (Kit-Sync FilterBar +
|
||
DropdownMenuMultiSelect) · `a38ce506b` (pure Facetten-Logik) · `fdd03476e` (Filterleiste) ·
|
||
`ae900e368` (Browser-Abnahme-Fixes). Volle lokale Gates: `pnpm typecheck` 0 · `pnpm lint` 0
|
||
Warnungen · `pnpm test` **7876 Tests grün** (1125 Dateien) · `verify:ui-visual` 130 passed /
|
||
0 failed · `verify:hardcoded-strings` Exit 0. Neu: `projectFilterFacets.test.ts` (18 Fälle für
|
||
Datums-/Geld-Mathematik und Owner-Prädikate), `PipelineKanbanPage.test.tsx` auf 34 Fälle
|
||
(Facetten-Rendering, Toggle, Wert-Gate, Chips, klebende „Ohne Zuordnung"-Option).
|
||
|
||
**Stand:** R-P8b: **10/10 DoD = 100 % done** (unverändert — dieser Nachzug ersetzt die
|
||
Interim-Optik, er ändert die DoD nicht). Offen bleiben: Demo-Seed für die neuen Zustände,
|
||
Re-Baseline der Visual-Baseline `r-p8-projects-interim` auf die Subframe-Optik (DoD 21) und die
|
||
visuelle Abnahme auf Staging nach Merge.
|
||
|
||
> **Querverweis (2026-07-18, Akeshan, dependency-aware — Subframe-Delta-Nachzug, Branch `feat/subframe-p8-delta-nachzug`):**
|
||
> UI-Nachzug der neuen P8-Subframe-Seiten (10 → 17) betrifft auch die R-P8b-Strecke: `PipelineKanbanPage` auf die neue `KanbanCard`-Slot-API
|
||
> migriert (S01a Filter-Empty + Spalten-Placeholder, S01b 2-Spalten-Umbruch ab 6 Karten inkl. `showSum`-Fix nach Component-Sync,
|
||
> M03 Kontextmenü mit bestehenden Stage-Move-Ops), `ProjektListPage` S03a-Empty-Karte + Paritäts-Footer. Loader/VM/Intents unverändert;
|
||
> SSE-Wiring aus R-P8b bleibt unangetastet. Details + Rest-Delta: `.planning/SUBFRAME-FLOW-INVENTAR.md`; Haupt-Querverweis in `R-P8a.md`.
|
||
|
||
### 2026-07-30 — Live-Abnahme S01, Charge 1 (Branch `fix/wf-p8-kanban-abnahme-charge1`, Akeshan)
|
||
|
||
Sieben Punkte aus der gemeinsamen Abnahme des gemergten WF-P8-Standes (Staging vs. Subframe
|
||
`S01 Kanban-Board`, `52699d37…`, + Wireframe-Doc `WF-P8 Pipelines/Screens/S01 Kanban-Board.md`).
|
||
Reine Screen-/Kit-Schicht: Loader, VM, Intents, Stage-Move-Pfad und SSE-Wiring unberührt.
|
||
|
||
1. **Leeres Filterergebnis zeigt keine Spalten mehr.** Bisher blieb die Spaltenreihe unter dem
|
||
Banner stehen; eine Reihe leerer Stages sagt nichts über den Filter aus, der sie geleert hat.
|
||
2. **„Hängt N T"-Chip ist von der Karte weg.** Davids Karte trägt Tag-Katalog und Projekttyp,
|
||
sonst nichts. `stuckDays` bleibt im VM (andere Leser), nur die Karte rendert es nicht mehr.
|
||
3. **Dropdown-Panels liegen jetzt über der Karte.** Das Tags-Dropdown öffnete *unter* dem
|
||
Preisblock der `ProjectCard`: die Kit-Panels öffnen in einem Portal-Wrapper ohne `z-index`,
|
||
und `ProjectCard` hat eine positionierte `z-10`-Zeile. `DropdownMenu` und
|
||
`DropdownMenuMultiSelect` tragen jetzt `relative z-50` (lokale Kit-Anpassung, kommentiert).
|
||
4. **Spalten-Farbtint raus.** Davids S01 zeichnet alle Spalten auf derselben neutralen Fläche;
|
||
die Stage-Farbe bleibt der Stage-Leiste der Detailansicht.
|
||
5. **Neues Spalten-Dropdown im Kopf** blendet Stages ein/aus; **„Verloren" ist per Default aus**.
|
||
Die Stage bleibt Move-Ziel im Karten-Kontextmenü, damit M01 nicht davon abhängt, dass die
|
||
Spalte sichtbar ist. Sichtwahl der Session, nicht persistiert, kein Permission-Gate.
|
||
6. **Kopf ist Davids Kopfzeile:** eine dichte Zeile (`py-3`) mit Modul-Icon + „Pipelines",
|
||
vertikalem Strich, Board-Auswahl, dann Board/Liste, Spalten, CSV-Export,
|
||
**Board-Einstellungen** und „Projekt anlegen". Kein Subtext. `PageHeader` hat dafür zwei
|
||
additive Props (`dense`, `titleTrailing`) — andere Screens bleiben unverändert.
|
||
Der Button führt auf die **Einstellungen dieses Boards** (S04, `/admin/pipelines/:id`) statt
|
||
auf die Board-Tabelle; gilt für beide Board-Routen.
|
||
7. **Einklappen ist reversibel.** Der Pfeil der eingeklappten Spalte war totes Markup und das
|
||
Kebab, das eingeklappt hatte, ist im eingeklappten Zustand versteckt — die Spalte ließ sich
|
||
nicht wieder öffnen. Der eingeklappte Kopf ist jetzt selbst das Ausklapp-Control (Klick,
|
||
Enter/Space, `aria-label`), und die Kartenzahl steht vertikal wie der Spaltenname.
|
||
|
||
**Proof:** Commits `74c855fd0` (Dropdown-Stacking) · `b6a3c4784` (Einklappen reversibel) ·
|
||
`d030ae77e` (Board-Kopf + Spalten-Deltas). Volle lokale Gates: `pnpm typecheck` 0 ·
|
||
`pnpm lint` 0 Warnungen · `pnpm test` **8036 Tests grün** (1143 Dateien) · `verify:i18n`,
|
||
`verify:ci-baseline`, `verify:source-health`, `test:hot-swap` je Exit 0.
|
||
`PipelineKanbanPage.test.tsx` deckt die neuen Fälle ab (Spalten-Picker inkl. Default-aus für
|
||
Verloren, Kopf-Button nur für Admin, weggefiltertes Board ohne Spalten, kein Staleness-Chip).
|
||
Lokale Browser-Abnahme aller sieben Punkte auf `app.localhost:3001` (Demo-Daten): Kopf wie im
|
||
Export, Panels über der Karte, Einklappen/Ausklappen, Verloren ein-/ausblendbar, weggefiltertes
|
||
Board ohne Spalten, Board-Einstellungen landet auf S04 des gezeigten Boards.
|
||
|
||
**Stand:** R-P8b: **10/10 DoD = 100 % done** (unverändert — Abnahme-Nachzug an der Optik).
|
||
Offen bleiben wie zuvor: Demo-Seed für die neuen Zustände, Re-Baseline `r-p8-projects-interim`
|
||
auf die Subframe-Optik (DoD 21, jetzt zusätzlich durch den neuen Kopf betroffen) und die
|
||
visuelle Abnahme auf Staging nach Merge dieser Charge.
|
||
|
||
### 2026-08-03 — UX-/Performance-Nachzug: Suche und Drag-Revalidierung
|
||
|
||
Die Board- und Listen-Suche hält den Text jetzt als lokalen Draft in der Filterleiste. Tippen
|
||
rendert damit weder das schwere Board neu noch schreibt es fortlaufend `q` in die URL. Erst
|
||
Enter oder der explizite Such-Button committed den getrimmten Wert in die weiterhin teilbare,
|
||
serverseitig ausgewertete URL. Facetten und Reset behalten ihren bisherigen Contract.
|
||
|
||
Beim Drag priorisiert die Kollisionserkennung den Pointer und nutzt `closestCorners` nur noch
|
||
als Keyboard-Fallback. Karten und Spalten werden über vorberechnete Maps statt wiederholter
|
||
linearer Suchen aufgelöst; `will-change` gilt nur für die tatsächlich transformierte Karte.
|
||
Zusätzlich pausieren die beiden Board-Routen ihren SSE-Client während Navigation oder Submit.
|
||
Damit löst die eigene Stage-Mutation nicht mehr gleichzeitig eine SSE-Revalidierung und die
|
||
normale Router-Action-Revalidierung aus. Der serverseitige Stage-/Event-Contract blieb
|
||
unverändert.
|
||
|
||
**Proof:** Commits `5ce31009a` (expliziter Search-Commit) · `3d644e4b0` (Drag-/SSE-Pfad) sowie
|
||
der querschnittliche UI-Nachzug `855188c4c`, `c6758f034`, `093e96bb5`, `8e79def0f` und die
|
||
Visual-Re-Baseline `2d848d36f`. `pnpm typecheck` und `pnpm lint` Exit 0; `pnpm test` **8336
|
||
Tests grün** in 1198 Dateien (60 Integrationstests bewusst geskippt); `verify:i18n`,
|
||
`verify:sidebar-routes`, `verify:source-health`, `test:hot-swap` und `verify:ui-visual` Exit 0
|
||
(`130 passed / 0 failed`). Frische lokale DB: Rollenvertrag + 33 Migrationen grün; HTTP-Smoke
|
||
auf `admin.localhost` und `app.localhost` Login jeweils 200. Die interaktive Browser-Steuerung
|
||
war in der Session nicht als Tool verfügbar; deshalb keine neue visuelle Live-Abnahme behauptet.
|
||
|
||
**Stand:** R-P8b bleibt **10/10 DoD = 100 % done**. Der hier beauftragte UX-/Performance-Nachzug
|
||
ist vollständig umgesetzt; die zuvor dokumentierte visuelle Staging-Abnahme bleibt unverändert
|
||
ein separater Nachzug.
|