# Boilerplate-Abgleich: M03 — Sales-Pipeline (Verkaufsfälle / Deals) > Abgleich-Report: Was liefert die Boilerplate (`/Users/raffaelsheikh/Documents/GitHub/boilerplate`) > für M03 fertig, was muss angepasst werden, was fehlt komplett. > Quellen: Detail-Spec `_bmad-output/specs/M03-sales-pipeline.md`, Pflichtenheft `block3.md` (3.1–3.13), > Milestones M059–M064, `AGENTS.md`, `INTEGRATION-CONTRACTS.md`, Boilerplate-Inventur. > Eigene Greps/Reads in der Boilerplate verifiziert (keine Inventur-Blind-Übernahme). | Feld | Wert | | --- | --- | | Modul-ID | M03 | | Name | Sales-Pipeline (Verkaufsfälle / Deals) | | Milestones | M059 (Pipeline-Konfig + SHK-Seed), M060 (Verkaufsfall-CRUD + Pflicht-Vertriebler), M061 (Kanban-UI + Drag&Drop), M062 (Verlust/Gewinn-Gründe), M063 (Auto-Auftragsprojekt + Setter-Closer), M064 (Reporting + Stuck/Auto-Archiv + KWP-Sync) | | Block | Block 3 — Workflow-Kern (Vertrieb & Auftrag) | | Reuse-Level | **low** (solides Querschnitt-Fundament + Bau-Vorlagen, aber **kein** Sales-Domänen-Modell vorhanden — Datenkern komplett neu) | --- ## Kernbefund (Realität) - **Es existiert KEIN Sales-/Deal-/Pipeline-Datenmodell in der Boilerplate.** Grep über `prisma/schema/*.prisma` nach `Deal|Pipeline|Stage|Forecast|Kanban|SalesPipeline` liefert **null Treffer** bei Modellen. Treffer für `Lead`/`LeadEvent` betreffen das **marketing-scoped** `Lead`-Modell (operator-scoped, NICHT tenant-scoped, `email @unique`) — das ist die M01/M02-Funnel-Welt, nicht der tenant-scoped Verkaufsfall aus M03. - **Es existiert KEIN zentrales `Activity`-Modell** wie es M03 (`DealActivity` → zentrale `Activity` aus M1) und `INTEGRATION-CONTRACTS §5` (`logActivity`) verlangen. Vorhanden sind nur `LeadEvent` (Lead-Timeline, `marketingLeads.prisma`) und `RowComment`/`Entity.hasActivity`-Flag im EntityBuilder — kein generischer, cross-entity Activity-Stream. → M045 (Activity-Service) ist Vorbedingung und muss separat existieren. - **HiveGrid-Cloud-Repo enthält derzeit noch KEINEN Boilerplate-Code** (`packages/`, `apps/`, `prisma/schema/` sind leer/abwesend; nur `docs/`, `_bmad*`, leeres `prisma/`). Der Abgleich erfolgt also gegen das separate Boilerplate-Repo; die Übernahme = Code aus Boilerplate als Fundament + neue Sales-Schicht darauf. - **Das stärkste vorhandene Sales-nahe Asset ist der EntityBuilder** (`board`-View = Kanban, `groupBy`, Row/Property/ Tag/Task/Comment/RowPermission, Custom-Felder). Er ist als **Vorlage/Pattern** sehr wertvoll, aber für ein Kern-Vertriebsmodul mit Pflicht-FKs (Kontakt/Firma/Lead/Projekt), Stage-Probabilities, Won/Lost-Reverse-Window, Forecast und Field-Level-Volumen-Permissions **nicht 1:1 als Datenmodell tauglich** (LP-4: Commodity sauber bauen, kein Über-Engineering über generischen No-Code-Layer). --- ## Übernehmbar aus Boilerplate ### Querschnitt / Foundation (1:1 nutzbar) | Boilerplate-Pfad | Was | Wie nutzbar | | --- | --- | --- | | `packages/foundation/src/permissions.ts` | `withTenantScope()`, `withPermission()`, `withOwnerCheck()`, `requirePermission()`; 404-statt-403 bei Deny | 1:1 — deckt Block I (read_own/read_all, 404 für nicht-eigenen Deal, Stage-Change-Gate) | | `packages/foundation/src/audit.ts` | `auditEvent()`, `withAuditMiddleware()` (`AuditEvent`-Hash-Kette) | 1:1 — AV #6 Audit-Default für Stage-Wechsel u. a. (S/W außerhalb Prisma manuell) | | `packages/foundation/src/notifications.ts` | `notify()`, `bundleNotifications()`, Preference-Check, i18n-Key-Zwang | 1:1 — `deal.won`/`deal.stuck`-Notifications (INTEGRATION-CONTRACTS §7) | | `packages/foundation/src/errors.ts` | `CatalogError`, `foundationErrors`, `toPinoLogObject` | 1:1 — Klartext-Diagnostik (3.13, LP-10): Stage-Validation, Stuck, Won/Lost-Confirm | | `packages/foundation/src/idempotency.ts` | `withIdempotency()` | 1:1 — idempotente Deal-Anlage aus Lead/Form/Email/Anruf/Automation (3.7) | | `packages/foundation/src/flags.ts` + `packages/feature-flags/*` | Feature-Flag-Engine (defineFlag/evaluateFlag, React-Hooks) | 1:1 — DoD „Modul ohne Deploy abschaltbar"; Sidebar-`feature_flag` | | `packages/view-models/src/index.ts` | `VMState`, `ActionCallbacks`, `RegistryGate`, `SidebarRegistryItem`, `assertI18nLabel` | 1:1 — VM-Layer-Vertrag (AGENTS A.1–A.5, INTEGRATION §11/§13) | | `packages/i18n/src/index.ts` | Locales (de/en), `formatCurrency`/`formatNumber`/`formatDate`, ICU, `useTranslate` | 1:1 — Volumen-/Datum-Formatierung, i18n-Keys `sales.*` | | `packages/logger`, `packages/observability`, `packages/error-reporter`, `packages/metrics` | Pino-Redaction, PII-Span-Scrub, Sentry, prom-Counter | 1:1 — Logging/Tracing/Error-Querschnitt | | `packages/url/src/canonical.ts` | `appPath`/`appUrl` host-aware | 1:1 — Deal-Routes/Links (`/deals/...`) | | `packages/db/src/client.server.ts` | `getReadDbClient()` (Replica) / `getWriteDbClient()` / `getExtendedDbClient()` | 1:1 — Read-heavy Kanban/Listen via Read-Replica (Performance-Anforderung Block D) | | `packages/db/src/transactions.server.ts` + `packages/db/src/outbox.ts` | `runDbTransaction()`, `publishOutboxEvent()` (atomic Side-Effects) | 1:1 — Stage-Wechsel + Activity + Notification + Automation-Trigger transaktional (`deal.stage_changed`, `deal.won`) | | `packages/db/src/dsgvo/user-fk-map.ts` | Pflicht-Karte aller User-FKs (CI-Gate) | anpassen — neue Deal-FKs auf `User` (`created_by`, `assigned_to`) MÜSSEN ergänzt werden, sonst bricht CI | ### Apps / Infra (1:1 / als-Vorlage) | Boilerplate-Pfad | Was | Wie nutzbar | | --- | --- | --- | | `apps/worker/src/jobs/*` + `apps/worker/src/group-runtime.ts` | BullMQ-Cron-Pattern (single-instance, Gruppen, DI `HandlerDependencies`) | als-vorlage — Daily-Cron für Stuck-Detection (3.8.1/3.8.2), Auto-Archiv Won 30d / Lost 90d (3.8.3/3.8.4, M064) | | `apps/worker/src/outbox/{dispatcher,event-router}.ts` | Outbox-Dispatcher (FOR UPDATE SKIP LOCKED) + Prefix-Routing | anpassen — neues Prefix `deal.` / `sales.` in `DEFAULT_OUTBOX_ROUTING` für Automation-Trigger (3.6/H/M075) | | `packages/queue/src/*` | Queue-Namen, typisierte Producer, `buildIdempotentJobId`, Plan-Prioritäten | 1:1 — Cron-/Job-Infrastruktur für Stuck/Archiv/Forecast-Cache | | `packages/realtime/src/{events,server,client}.ts` | SSE-Serialisierung + Client/Server-Helfer | anpassen — Live-Kanban-Updates (3.4.11, M061). **Achtung:** Boilerplate hat **nur SSE, kein WebSocket** — der „WebSocket vs SSE"-Offene-Punkt der Spec ist faktisch auf **SSE** zu entscheiden; `REALTIME_EVENT_NAMES` um Deal-Events erweitern | | `packages/exports/src/csv/*` + `packages/exports/src/limits.ts` + Worker `export.ts` | CSV-Export (Streaming, Plan-Row-Caps, Injection-Safety) | 1:1 — CSV-Export gefilterter Deals (3.4.10, M061) | | `packages/search/src/schemas/` (`crm-contacts.ts`, `rows.ts` als Muster) + `outbox-publisher.ts` | Meilisearch tenant-scoped Index + Outbox-Reindex | als-vorlage — neues Index-Schema `deals` (Titel/Description/Kontakt-/Firmen-Name, 3.4.5); Registrierung in `indexed-entities.ts` (INTEGRATION §8) | ### UI / App-Shell (als-Vorlage / anpassen) | Boilerplate-Pfad | Was | Wie nutzbar | | --- | --- | --- | | `apps/web/app/components/layouts/sidebars/shadcn/*` + `apps/web/app/application/sidebar/{AppSidebar,SidebarItem}.tsx` | Datengetriebene Sidebar mit Permission-/Feature-Gating, `data-ui-id` | als-vorlage — Sidebar-Eintrag „Verkaufsfälle" (Gruppe ARBEITEN) + „Pipelines" (Gruppe EINSTELLUNGEN); HiveGrid nutzt `packages/ui-hivegrid/src/app-shell/sidebar.config.ts` (neu) | | `apps/web/app/components/ui/*` (shadcn/Radix: table, tabs, dialog, sheet, drawer, badge, card, command, multi-select, pagination, calendar) | Primitive-Bibliothek (~707 Komponenten) | 1:1 / als-vorlage — Deal-Detail-Tabs, Bulk-Select, Filter-Bar, Confirm-Dialoge (Won/Lost), Listen-Tabelle | | `apps/web/app/components/ui/tables/*` (`TableNew`, `TablePagination`, `ColumnSelector`, `RowsLoadMoreCard`) | Tabellen-Bausteine: Cursor-Pagination, Spalten-Konfig, „Mehr laden" | 1:1 — Listen-View (3.4.8 Spalten-Konfig pro User, Cursor-Pagination, Default „zuletzt geändert" | | `apps/web/package.json` → `@dnd-kit/core` 6.3.1, `@dnd-kit/sortable`, `@dnd-kit/utilities` | Drag&Drop bereits als Dependency vorhanden | 1:1 — Kanban-D&D (3.4.3, M061) **und** Pipeline-/Stage-Reorder (3.2.7, M059). Hinweis M061 nennt `react-beautiful-dnd` — faktisch ist **@dnd-kit** vorhanden, das nutzen | | `apps/web/app/modules/formWidget/builder/{Canvas,SortableField,palette}.tsx` | Drag&Drop-Sortier-Editor (SortableField) als konkretes @dnd-kit-Beispiel | als-vorlage — Stage-Liste-Reorder im Pipeline-Editor (M059) | | `packages/ui-mock/src/index.ts` (`MockPage`, `generateMockArtifacts`) + `apps/web/.../hot-swap/HotSwapPageRenderer.tsx` | Hot-Swap-Drill + Visual-Snapshot-Fundament | 1:1 — DoD Hot-Swap-Drill (M017) + Visual-Regression (M016) für Kanban/Detail | | `apps/storybook/*` (lost-pixel, axe a11y, i18n-Decorator) | Visual-Regression + a11y-Gate | 1:1 — Snapshot der Hauptansicht (M016) | ### Domänen-nahe Bau-Vorlagen (als-Vorlage) | Boilerplate-Pfad | Was | Wie nutzbar | | --- | --- | --- | | `prisma/schema/entityBuilder.prisma` — `EntityView` (`layout="board"`, `groupByPropertyId`, `pageSize`, `EntityViewFilter`/`Sort`/`Property`) | Generische Kanban/Board-View-Konfiguration | als-vorlage — Pattern für Stage-Spalten + Filter/Sort/Spalten-Konfig (NICHT als Deal-Datenmodell übernehmen) | | `prisma/schema/entityBuilder.prisma` — `Property` + `PropertyOption`/`PropertyAttribute` (typisierte Custom-Felder, `applicable_to` via `entityId`) | Custom-Felder mit Typen/Optionen | anpassen — Deal-Custom-Felder „Anlagen-Typ"/„Wärmebedarf kW"/„Bestandsanlage" (3.1.14, Block H). Entweder über EntityBuilder koppeln (`applicable_to=deal`) oder eigene schlanke Deal-Custom-Field-Tabelle | | `prisma/schema/entityBuilder.prisma` — `RowTag`/`EntityTag`, `RowTask`, `RowComment` | Tags / Aufgaben-Link / Notizen an Rows | als-vorlage — Deal-Tags (3.1.13), Deal↔Task-Link (M26/3.9.1), Notizen | | `packages/db/src/rows.server.ts` — `getNextRowMutationNumber()` / `Row.folio` (`aggregate _max.folio + 1`, tenant+entity-scoped) | Fortlaufende Nummer pro Tenant/Entity | als-vorlage — Sequenz-Mechanik für `HiveNumberSeq` / `deal_number`. **Lücke:** kein Prefix-/Format-Layer (`D-2026-0042`), keine konfigurierbare Reset-Strategie — neu zu bauen (M060) | | `prisma/schema/marketingLeads.prisma` — `Lead` + `LeadEvent` (Timeline, `convertedToTenantId`) | Lead-Modell + Event-Timeline (operator-scoped) | als-vorlage — Lead→Deal-Promotion-Wiring (3.7.2, Block H/M1). Achtung: dies ist das **Marketing-Lead**; M03 `lead_id` zeigt vermutlich auf das M01/M02-Lead-Konstrukt — Mapping mit M01/M02-Team klären | | `prisma/schema/helpDesk.prisma` — `Feedback`/`SupportTicket` (`archived`-/`status`-Muster) & `prisma/schema/entityBuilder.prisma` — `Row.deletedAt`/`ExportJob` (Soft-Archiv) | Soft-Archive-Muster (`archived_at` statt Hard-Delete) | als-vorlage — Deal/Pipeline/Stage/LostReason-Archivierung (3.2.3/3.3.4/3.8) | | `apps/api/src/routes/entity-row-routes.ts` + `route-access-inventory.ts` | REST-CRUD + Auth-Klassen-Matrix | als-vorlage — falls Deals über Public-API exponiert werden (INTEGRATION §3 `api/v1`) | | `apps/web/app/utils/services/.server/*` + `application/dtos/*` Muster | Service-/DTO-/View-Model-Schichtung (SaasRock-Stil) | als-vorlage — Struktur für `app/domain/sales/*`, `view-models/sales/*.vm.ts` | --- ## Vorhandene Daten-Modelle (konkret, mit Pfad) Direkt für M03 **wiederverwendbar/anbindbar** (kein Deal-Modell darunter): | Modell | Pfad | Rolle für M03 | | --- | --- | --- | | `Tenant`, `User`, `TenantUser` | `prisma/schema/accounts.prisma` | Tenant-Scope-Anker; `assigned_to_user_id`, `created_by_user_id`, Vertriebler-Pflicht [N6] | | `Role`, `Permission`, `RolePermission`, `UserRole`, `Group` | `prisma/schema/permissions.prisma` | RBAC-Fundament für `deals.*`-Bundles (Block I) — neue Permission-Keys einseeden | | `AuditEvent` | `prisma/schema/core.prisma:55` | Audit-Trail Stage-Wechsel (Hash-Kette, AV #6) | | `IdempotencyKey` | `prisma/schema/core.prisma:84` | Idempotente Deal-Anlage aus Quellen (3.7) | | `FileObject` / `FileUploadProgress` / `FileChunk` | `prisma/schema/core.prisma` | Verknüpfte Files am Deal (Block E, Won-Handoff-Files) | | `NotificationDelivery`, `UserNotificationPreference` | `prisma/schema/notifications.prisma` | `deal.won`/`deal.stuck`-Notifications | | `OutboxEvent` | `prisma/schema/outbox.prisma` | Atomic Side-Effects (Stage-Change → Activity/Notify/Automation) | | `FeatureFlag` (+ Filter/Audit) | `prisma/schema/featureFlags.prisma` | Modul-Kill-Switch | | `Form`, `FormSubmission` | `prisma/schema/formWidget.prisma` | Quelle „Deal aus Form" (3.7.3) + `DealForm`-Verknüpfung (Block A) | | `Lead`, `LeadEvent` | `prisma/schema/marketingLeads.prisma` | Lead-Origin-Bezug (`lead_id`), Promotion-Pattern (3.7.2) | | `Entity`/`EntityView`/`Property`/`Row`/`RowTag`/`RowTask`/`RowComment`/`RowPermission` | `prisma/schema/entityBuilder.prisma` | NUR als Pattern/optionale Custom-Feld-Kopplung — nicht als Deal-Kernmodell | | `ExportJob` (+ Enum) | `prisma/schema/queue.prisma` | CSV-Export-Job-Tracking | **Ablageort für die neuen HiveGrid-Modelle:** `prisma/schema/app.prisma` ist der vorgesehene leere Platzhalter (`// custom database models`) — dort gehören `Pipeline`, `PipelineStage`, `Deal`, `DealActivity`/`Activity`, `DealForm`, `LostReason`/`WinReason`, `HiveNumberSeq` hinein (bzw. eigene `sales.prisma`). --- ## Lücken / komplett neu zu bauen **Datenmodell (komplett neu, kein Boilerplate-Äquivalent):** - `Pipeline` (Multi-Pipeline ab Tag 1, `is_default`, `position`, `archived_at`) — 3.2, M059 - `PipelineStage` (`stage_kind open|won|lost`, `win_probability`, `auto_archive_after_days`, `color`, `position`) + Validierung „mind. 1 won + 1 lost" — 3.2.5/3.2.6, M059 - `Deal` (alle Pflicht-FKs: `contact_id` Pflicht, `company_id` optional, `lead_id`, `lost_reason_id`, `won_handoff_project_id`, `volume numeric(12,2)`, `expected/actual_close_date`, `deal_number`) — 3.1, M060 - `LostReason` **und Gewinn-Gründe** (WinReason) — Tenant-pflegbar, archivierbar, Pflicht/Optional-Toggle pro Liste [N8] — 3.3, M062 (in Boilerplate gar nichts) - `HiveNumberSeq` mit `prefix`/`format` (`D-2026-0042`) + Reset-Strategie — 3.1.1, M060 (Boilerplate hat nur `folio`-Counter ohne Format-Layer) - **Zentrale `Activity`/`DealActivity`** mit Typen (`deal_stage_changed` inkl. `from/to_stage_id` + `duration_in_previous_stage_seconds`, `deal_won`/`deal_lost`, …) — Block A/M045. **Vorbedingung M045 prüfen.** **Domänen-Logik (neu):** - Stage-Wechsel-Engine inkl. Vorwärts/Rückwärts (Klartext-Hinweis), Won/Lost-Confirm-Workflow, **24h-Reverse-Window** (Soft-Revert vs. neue Stage-Activity — Offener-Punkt der Spec), `change_stage`-Gate — 3.5 - **Won-Handoff zu M4** (Projekt-Anlage, Feld-Mapping Deal→Projekt, Ziel-Pipeline-/Start-Stage-Wahl, `won_handoff_project_id`, Mehrfach-Projekte aus einem Deal, Option A vs. B [N7], Wartung/Service kein Projekt [N9]) — 3.6, M063. Hängt an M065 (Auftragspipeline) — noch nicht vorhanden. - **Setter-Closer-Termin-Anlage** mit konfigurierbarem Feld-Mapping Deal→Termin [N17] — 3.9.5, M063. Hängt an M119/M25 (Calendar-Sync) — nicht vorhanden. - **Forecast-Berechnung** (`volume × win_probability/100`, Zeitraum-Split, realisierter Umsatz), Vertriebler-KPIs, Stage-Conversion-Rates, Lost-Reason-Verteilung + Aggregat-/Forecast-Cache — 3.10, M064. Kein generischer KPI-Builder in Boilerplate für diese Sales-Metriken vorhanden. - **Field-Level-Volumen-Permission-Redaction** (`read_volume_own/all`, `read_aggregates`) — Volumen „—" je Rolle in Kanban-Karte/Detail/Liste/Aggregat — 3.11.2–3.11.4, Block I. Boilerplate kennt nur Object-Level + Row-Level ACL (`RowPermission`), **kein** Field-Level-Redaction-Pattern → neu. - **Stuck-Detection-Logik** + Stage-Verweildauer-Berechnung aus Stage-Change-Activities — 3.8, M064. **UI (neu, auf Boilerplate-Primitiven aufbauend):** - Kanban-Board-Komponente mit @dnd-kit (Spalten=Stages, Aggregat pro Spalte, Karten-Redaction, Live-SSE-Update, „Mehr laden" pro Spalte ab 100+) — M061. (EntityBuilder-`board`-View ist nicht der HiveGrid-Kanban.) - Pipeline-Switcher + „Nur meine Deals"-Quickfilter + Filter-Bar (Multi-Select) — M061 - Deal-Detail mit Stage-Pipeline-Komponente, Inline-Edit, Tab-Navigation, Klartext-Bannern (Won/Lost/Stuck/ Kontakt-archiviert) — Block E - Pipeline-Editor (Stage-Liste D&D, Won/Lost-Validation-Anzeige) + Lost-/Win-Reason-Editor — M059/M062 - `packages/ui-hivegrid/` selbst existiert in der Boilerplate **nicht** (nur leerer `ui-subframe`-Stub + Adapter-Metadaten in `@toolctrl/ui`) — der Adapter-Layer + Sidebar-/Breadcrumb-Config muss als HiveGrid- Infrastruktur erst angelegt werden (Querschnitt M013–M017, nicht M03-spezifisch). **Querschnitt-Wiring, das M03 voraussetzt, aber in Boilerplate fehlt:** - `@hivegrid/activity` (`logActivity`, M045) — kein Äquivalent - `packages/db/src/search/indexed-entities.ts` (M056) — existiert nicht (nur statische `search/schemas/*`) - `packages/ui-hivegrid/src/app-shell/sidebar.config.ts` / `breadcrumbs/` / `mobile/tab-bar.config.ts` / `customer-portal/portal-shell.config.ts` (INTEGRATION §2/§4/§13/§14) — alle neu - `packages/entitlements/src/permissions.ts`-Keys `sales.*`/`deals.*` (INTEGRATION §10) — neu zu definieren **Integrationen mit anderen Modulen (out of M03-scope, aber harte Abhängigkeiten):** - M4/M065 Auftragspipeline (Won-Handoff-Ziel) · M045 Activity · M042/M043 CRM-Kontakt/Firma · M048 Lead-Routing (Default-Vertriebler) · M25/M119 Kalender (Setter-Closer) · M147 Dashboard (KPI-Widgets) · M5/M9/M12/M17 (Deal-Quellen) — keines davon in der Boilerplate fertig; M03 baut die **Hooks/Producer**, die Gegenseite separat. --- ## Empfohlenes Vorgehen (Reihenfolge) 1. **Fundament aktivieren (vor M03):** Boilerplate-Code als HiveGrid-Codebase übernehmen (AGENTS Pre-Flight), Querschnitt-Pakete (`foundation`, `view-models`, `feature-flags`, `i18n`, `db`, `queue`, `realtime`, `exports`, `search`, `logger`) 1:1 nutzen. Sicherstellen, dass die HiveGrid-Querschnitt-Milestones (M001 Audit, M004 Permissions, M013–M017 UI/VM/Adapter/Hot-Swap, M045 Activity, M056/M057 Search) vorhanden sind — M03 setzt sie laut DoD/INTEGRATION-CONTRACTS voraus. 2. **M059 — Daten + Pipeline-Konfig (neu, mit Vorlagen):** `Pipeline`/`PipelineStage` in `app.prisma` (bzw. `sales.prisma`) neu modellieren. Stage-Reorder-UI via **@dnd-kit** (Vorlage: formWidget `SortableField`/`Canvas`). Won/Lost-Validation als `CatalogError` (foundation/errors). SHK-Seed als Konfig-Datei (Bauprinzip A.3) im Seed-Pfad (`prisma/seed.ts`-Muster). Soft-Archive-Pattern übernehmen. `user-fk-map.ts` für neue User-FKs ergänzen (CI-Gate). 3. **M060 — Verkaufsfall-CRUD (neu):** `Deal` + `DealForm` modellieren; `HiveNumberSeq` neu (Sequenz-Mechanik als-Vorlage aus `rows.server.ts:getNextRowMutationNumber`, Prefix/Format-Layer neu). Deal-Anlage-Quellen über `withIdempotency` + Outbox. Pflicht-Vertriebler [N6] über `withOwnerCheck`/Default aus Routing. Stage-Wechsel + 24h-Reverse transaktional (`runDbTransaction` + `publishOutboxEvent`). View-Model-Layer (`view-models/sales/*.vm.ts`) + Smoke-Test + Hot-Swap-Drill (DoD). 4. **M061 — Kanban/Listen-UI (neu auf Primitiven):** Kanban mit @dnd-kit; Listen-View mit `TableNew`/ `ColumnSelector`/`TablePagination` (1:1). Live-Updates über `@toolctrl/realtime` (**SSE**, neue Deal-Events). Server-side Filter (`getReadDbClient`). CSV-Export via `@toolctrl/exports`. **Field-Level-Volumen-Redaction im VM-Builder** (neu) — Volumen „—" je Permission. Search-Index `deals` registrieren. 5. **M062 — Verlust/Gewinn-Gründe (neu, klein):** `LostReason`/`WinReason` (Soft-Archive, Pflicht/Optional-Toggle pro Liste [N8]) + 5+5 SHK-Seeds + Aggregations-Auswertung (gehört konzeptionell zu M064-Reporting). 6. **M063 — Won-Handoff + Setter-Closer (neu, abhängig):** Erst nach M065 (Auftragspipeline) und M119/M25 (Kalender). Won-Handoff-Modal + Feld-Mapping Deal→Projekt + Option A/B [N7] + Wartung/Service-kein-Projekt [N9]; Setter-Closer-Termin mit konfigurierbarem Mapping [N17]. Automation-Trigger über Outbox-Prefix `deal.`. 7. **M064 — Reporting + Jobs (neu):** Forecast/KPIs/Conversion/Lost-Verteilung + Aggregat-/Forecast-Cache; Daily-Cron (Stuck-Detection, Auto-Archiv Won 30d/Lost 90d) nach BullMQ-Cron-Pattern (Worker-Vorlage). Optionaler KWP-Sync (Wartung ausgenommen [N9]) — externe Adapter-Schicht. **Querschnitt-Entscheidungen, die die Spec offen lässt und durch Boilerplate-Realität präjudiziert sind:** - Real-Time-Kanban: **SSE** (`@toolctrl/realtime`), **kein** WebSocket (in Boilerplate nicht vorhanden). - Cache-Invalidierung Aggregate: über **Outbox/Pub-Sub** (`shared-store` DB-Index 2) bei Stage-Wechsel. - Custom-Felder: Kopplung an EntityBuilder-`Property` (`applicable_to=deal`) prüfen vs. schlanke eigene Tabelle — Entscheidung mit M044-Team (LP-4: kein Über-Engineering).