# VA-P28b · Admin Sales CRM Core + Flag-Massen-Statistik | | | |---|---| | **Plane** | `HIVEGRID-124` · Coverage-Parent `HIVEGRID-190` | | **Typ** | Dev (Code) | | **Owner** | Raffael | | **Phase** | P28 — Plattform-Admin-Tiefe / Admin Sales Workspace | | **Cycle/Fenster** | M033/M040b ursprünglich v2-W3 bis 2026-07-31; Sales-Erweiterung noch nicht terminiert | | **Status** | Ready for Review | > 🎨 **design-nachzug: offen** — Der M033-Rollout-Screen und alle folgenden Sales-Screens werden > als geprüfte AD-28-Interim-UI abgeschlossen; Davids finale Subframe-Optik bleibt ein getrackter Nachzug. > > ♻️ **Scope-Erweiterung 2026-07-24:** Der bestehende M033-/M040b-Scope bleibt vollständig erhalten. > Zusätzlich wird dieses Ticket zum gemeinsamen CRM Core für HiveGrids eigenen Vertrieb. `R-LEADS` bleibt > alleiniger Owner von M040a, Plattform-Lead-Inbox, Ingestion und UTM-Attribution. Hier entsteht keine zweite > Lead-Inbox und kein zweiter Intake-Pfad. > > **Delivery-Owner-Update 2026-07-24:** Raffael übernimmt `VA-P28b` sowie die abhängigen Tickets > `VA-P28c` bis `VA-P28i` in einer sequenziellen Delivery-Session. Der CRM-Core-Vertrag sowie Scope > und Abhängigkeiten bleiben unverändert. Das Ticket wechselt vom Akeshan- ins Raffael-Dev-Modul. ## Abhängigkeiten & Parallelität - **Blocked by:** `VR-P28a` (AdminUser/RBAC) und für alle Lead-/Deal-Funktionen `R-LEADS` (native `AdminLead`-/Activity-/Source-Datenbasis). - **Blocks:** `VA-P28c`, `VA-P28d`, `VA-P28e`, `VA-P28f`, `VA-P28g`, `VA-P28h`, `VA-P28i` und `VR-P28a-RBAC` für den rollenbasierten Own-/All-Scope des bestehenden CRM Core. - **Läuft parallel zu:** `VR-P28a` nur im bestehenden M033-Anteil. Sales-Slices beginnen erst nach stabilen Admin-RBAC- und R-LEADS-Verträgen. - **Auswirkung:** Die ursprüngliche Zielsetzung 2026-07-31 bleibt nur der historische M033-/M040b-Slot. Die neue Sales-Erweiterung bekommt erst nach gemeinsamer Block-Review belastbare Termine. - **Hardgrenze:** ausschließlich `admin.hivegrid.de`, keine `tenantId` auf Sales-Tabellen, kein BYPASSRLS. - **Owner-Auswirkung:** `R-LEADS`, `VR-P28a` und `VA-P28c` bis `VA-P28i` behalten ihre Verträge; es gibt keinen Cross-Owner-Handoff mehr. Der R-LEADS-Cutover bleibt operativ separat. > **Implementierungsstart 2026-07-24:** `blocked-by` und `blocks` wurden in Plane und > in den Ticket-Docs beider Richtungen geprüft. `VR-P28a` steht mit 6/6 DoD auf > Ready for Review. Der gemergte R-LEADS-Codevertrag ist für diesen Block freigegeben; > dessen operative Staging-/Produktions-, Backfill- und Drain-Gates bleiben separat > bei 6/10 DoD und werden durch VA-P28b nicht verändert. ## Was wir bauen Einen gemeinsamen Admin-Sales-Datenkern für HiveGrids eigene Firmen, Kontakte, Leads, Deals, Pipeline, Aufgaben und Aktivitäten. M033 liefert weiterhin Feature-Flag-Massenstatistik, Live-Filter und Bulk-Override. M040b sowie die neue Sales-Erweiterung bauen auf `AdminLead` aus `R-LEADS` auf. ## Story-Ownership — 32/117 ### Pipeline und Deals - `PIP-01` Eigene Pipeline-Stufen definieren. - `PIP-02` Deals per Drag-and-drop verschieben. - `PIP-03` Deal-Wert erfassen. - `PIP-04` Erwartetes Abschlussdatum setzen. - `PIP-05` Abschlusswahrscheinlichkeit je Stufe hinterlegen. - `PIP-06` Verlustgrund beim Verlieren erfassen. - `PIP-07` Warnung bei zu langer Verweildauer in einer Stufe. - `PIP-08` Definierten nächsten Schritt je Deal anzeigen. - `PIP-09` Pflichtfelder je Stufe erzwingen. - `PIP-10` Stufen-Historie eines Deals anzeigen. - `PIP-11` Mehrere Ansprechpartner als Buying-Center am Deal führen. ### Lead-Management auf R-LEADS - `LEAD-02` Lead in einen Deal umwandeln. - `LEAD-03` Leads nach Regeln wie Region oder Quelle automatisch zuweisen. - `LEAD-04` Leads per Round-Robin verteilen. - `LEAD-05` Dubletten bei Anlage erkennen. - `LEAD-06` Zwei Datensätze kontrolliert zusammenführen. - `LEAD-07` Leads nach konfigurierbaren Kriterien bewerten. - `LEAD-09` Firmendaten automatisch ergänzen. - `LEAD-10` Bei Lead-Zuweisung benachrichtigen. `LEAD-01` und `LEAD-08` bleiben in `R-LEADS`. ### Aufgaben und Aktivitäten - `ACT-01` Aufgabe an Deal oder Kontakt erstellen. - `ACT-02` Fälligkeit und Priorität setzen. - `ACT-03` An fällige Aufgaben erinnern. - `ACT-04` Heute-Liste offener Aufgaben anzeigen. - `ACT-05` Aus einer Mail oder einem Anruf direkt eine Aufgabe erzeugen. - `ACT-06` Wiederkehrende Aufgaben anlegen. - `ACT-07` Chronologische Aktivitäts-Timeline je Kontakt anzeigen. ### Daten und Verwaltung - `DATA-01` Eigene Felder an Kontakten und Deals anlegen. - `DATA-02` Kontakte taggen. - `DATA-03` Mehrere Datensätze gleichzeitig bearbeiten. - `DATA-04` Kontakte per CSV importieren. - `DATA-05` Daten als CSV exportieren. - `DATA-06` Notizen am Kontakt festhalten. ## Benötigte Screens | Screen [Admin-Host-Route] | Kern-Inhalt | |---|---| | Feature-Flag-Statistik [`/feature-flags`] | M033 Effektiv-Auswertung und Live-Filter | | Bulk-Override [`/feature-flags/:key/bulk`] | bestätigte, auditierte Massenänderung | | Lead-Inbox [`/leads`] | bestehende R-LEADS-Inbox plus Score, Assignment, Duplicate-Hinweise | | Kontakte/Firmen [`/sales/contacts`, `/sales/companies`] | Listen, Bulk, Tags, Import/Export | | Kontakt-/Firmen-Detail [`/sales/contacts/:id`, `/sales/companies/:id`] | Stammdaten, Notizen, Timeline, Aufgaben | | Deal-Pipeline [`/sales/deals`] | Kanban, Stage-Aging, Forecast-Basis | | Deal-Detail [`/sales/deals/:id`] | Buying-Center, Wert, Abschlussdatum, nächster Schritt, Historie | | Heute [`/sales/tasks/today`] | fällige und überfällige Aufgaben | | Sales-Einstellungen [`/sales/settings/pipelines`, `/sales/settings/fields-tags`] | Stufen, Pflichtfelder, Wahrscheinlichkeiten, Custom Fields, Tags | | Import/Export [`/sales/import-export`] | Mapping-Vorschau, Jobstatus, Fehlerdatei | ## Definition of Done - [x] M033: Flag-Massen-Statistik, Live-Filter-Vorschau und Bulk-Override mit deterministischer Auswertung `Override > Filter > Default` und Audit. - [x] Ein typisierter Admin-Sales-Kern für `AdminCompany`, `AdminContact`, `AdminDeal` und Relationen zu `AdminLead` aus R-LEADS; keine zweite Lead-Tabelle oder Intake-Implementierung. - [x] Pipeline-Stufen, DnD, Wert, Abschlussdatum, Wahrscheinlichkeit, Verlustgrund, Aging, nächster Schritt, Pflichtfelder, Historie und Buying-Center erfüllen `PIP-01..11`. - [x] Conversion, regelbasierte Zuweisung, Round-Robin, Duplicate-Hinweis, Merge, Scoring, Enrichment und Assignment-Notification erfüllen `LEAD-02..07` und `LEAD-09..10`. - [x] Aufgaben, Reminder, Heute-Liste, Wiederholung und gemeinsame Kontakt-Timeline erfüllen `ACT-01..07`; Mail-/Call-Aktionen docken später über stabile Commands an. - [x] Custom Fields, Tags, Bulk Edit, CSV-Import/-Export und Kontaktnotizen erfüllen `DATA-01..06`. - [x] Gewonnene Deals können mit expliziter Bestätigung und Audit an einen bestehenden oder neuen `Tenant` verknüpft werden; Sales-Daten bleiben dabei Admin-Daten. - [x] Alle Mutationen sind permission-gegatet, auditieren mit `actorType=admin`/`tenantId=null` und schreiben die gemeinsame `AdminActivity`. - [x] Loader/View-Models/Action-Callbacks, Sidebar, Breadcrumbs, i18n sowie Klartext-Empty-/Loading-/404-States entsprechen AGENTS.md; Interim-UI nach AD-28 ist zulässig. - [x] Unit-, DB-/RLS-, Integrations-, Smoke-, Hot-Swap- und Visual-Tests sind grün; `R-LEADS` und alle neuen Konsumenten bleiben contract-kompatibel. **Fortschritt:** **10/10 DoD = 100 % done**. Erfüllt sind der vollständige M033-Vertrag, der tenant-lose Admin-Sales-Datenkern, die vollständige Deal-Pipeline, das Advanced Lead Management sowie Aufgaben, gemeinsame Timeline, Datenverwaltung und der explizite Won-Deal-/Tenant-Link; zusätzlich stehen die vollständigen Permission-, Audit- und Activity-Verträge sowie die Gesamt-Reachability und alle VA-P28b-Qualitätsgates. Davids finale Optik bleibt als `design-nachzug` offen und blockiert nach AD-28 den Ticketabschluss nicht. ### Umsetzungs-Notiz 2026-07-24 · M033-Slice - Effektive Auswertung ist als Prisma-freie Pure Function umgesetzt: expliziter Override, danach aktiver Filter nach Priorität/Alter/ID, danach Default. Abgelaufene Overrides werden ignoriert. - Die Admin-Route zeigt Massenstatistik und Live-Filter-Ergebnis je Tenant und schreibt bestätigte Bulk-Overrides mit kleinster Permission, CSRF, `FeatureFlagAudit` und zentralem Hash-Chain-Audit atomar. - `AdminFeatureFlagOverride` ist eine operator-geschützte Plattformtabelle. Der RLS-Proof bestätigt Zugriff nur für gebundene aktive Admins, sofortigen Entzug bei Sperrung und kein Runtime-Delete. - Proof: `pnpm typecheck`, `pnpm lint`, `pnpm test` mit 1.032 Dateien / 7.385 Tests grün; Feature-Flag-/VM-/Route-/RLS-Tests grün; Prisma Validate + isoliertes `db push`; 307/307 RLS-Verträge; 305/305 Modellklassifikationen; Visual-Snapshot und WCAG 2 A/AA grün. ### Umsetzungs-Notiz 2026-07-24 · Admin-Sales-Datenkern - `AdminCompany`, `AdminContact`, `AdminContactChannel`, `AdminPipeline`, `AdminPipelineStage`, `AdminDeal` und Buying-Center liegen typisiert in der eigenen Moduldatei `adminSales.prisma`. Company, Contact und Deal referenzieren den bestehenden `AdminLead` aus R-LEADS; es gibt keine zweite Lead-Tabelle und keine `tenantId`-Spalte. - `AdminActivity` verbindet Lead, Firma, Kontakt und Deal als gemeinsame append-only Timeline. Inserts sind auf den gebundenen aktiven Admin beschränkt; Update und Delete sind im RLS-Vertrag nicht freigegeben. - Die Core-Services prüfen `admin_sales.crm.write`, normalisieren PII und schreiben Datensatz, fachliche Activity und zentralen Audit-Hash-Chain-Eintrag in derselben Transaktion. - Proof: Prisma Validate + isoliertes `db push`; 318/318 RLS-Verträge; 316/316 Modellklassifikationen; Core-Service-/Repository-Tests 5/5 und dedizierter RLS-Proof 2/2 grün. ### Umsetzungs-Notiz 2026-07-24 · Deal-Pipeline und Buying-Center - Die feste SaaS-Pipeline und administrierbare weitere Pipelines bilden Stufen, Wahrscheinlichkeiten, Aging-Schwellen, Pflichtfelder und Verlustgründe serverseitig ab. Deal-Moves validieren alle Stage-Verträge, aktualisieren den Deal atomar und schreiben Stage-Historie, `AdminActivity` und Audit. - Das permission-gegatete Interim-Kanban unterstützt Drag-and-drop sowie eine tastaturbedienbare Move-Alternative. Deal-Details verdrahten Wert, Abschlussdatum, nächsten Schritt, Verluststatus, Buying-Center, Stufenhistorie und gemeinsame Timeline über reine View-Models und Action-Callbacks. - Sales, Leads, Deals und Pipeline-Einstellungen sind über die Admin-Sidebar und registrierte Routen erreichbar. Der AD-28-Interim-Screen besitzt eigene Visual-, A11y- und Hot-Swap-Proofs; der `design-nachzug` bleibt offen. - Proof: `pnpm typecheck`, `pnpm lint` und vollständiger Testlauf mit 1.035 Dateien und 7.390 Tests grün; Pipeline-Domain/-DB/-VM/-Route-Tests grün; `verify:i18n`, `verify:sidebar-routes`, `verify:phase-c-boundaries`, 318/318 RLS-Verträge, 316/316 Modellklassifikationen, Hot-Swap, 130 Visual-Checks und 44 A11y-Tests grün. ### Umsetzungs-Notiz 2026-07-24 · Advanced Lead Management - Typisierte, priorisierte Zuweisungsregeln unterstützen feste Zuständigkeit und serialisiertes Round-Robin ohne Zufall. Die Admin-Einstellung unter `/sales/settings/leads` ist mit `admin_sales.crm.assign` gegatet und vollständig über Sidebar und Route erreichbar. - Versionierte Scoring-Regeln erzeugen einen erklärbaren Qualification-Snapshot. Providerneutrale Enrichment-Ergebnisse werden schema-begrenzt am Lead gespeichert; jede Zuweisung erzeugt die zentrale Plattform-Notification sowie Audit und gemeinsame `AdminActivity`. - Die Dublettenprüfung normalisiert E-Mail und Telefon, öffnet eine sichtbare Entscheidungsqueue und führt niemals still zusammen. Merge akzeptiert ausschließlich das exakt passende offene Candidate-Paar, sperrt beide Leads, archiviert den Verlierer und schreibt einen append-only `AdminMergeRecord`; der Browser folgt anschließend dem serverseitig bestätigten Survivor. - Qualifizierte Leads werden idempotent und in einer Transaktion in Firma, Kontakt und Deal der ersten Pipeline-Stufe überführt. Es entsteht weder eine zweite Lead-Tabelle noch ein Tenant. - Der bestehende R-LEADS-DTO wurde additiv um Qualification, Duplicate Candidates und Conversion-IDs erweitert. Die operative R-LEADS-Cutover-DoD bleibt unverändert bei 6/10; der Consumer-Vertrag ist durch Route-, VM-, Visual- und RLS-Regressionstests abgesichert. - Proof: `pnpm typecheck`, `pnpm lint`, Prisma Validate, isoliertes `db push`, **323/323** RLS-Verträge und **321/321** Modellklassifikationen grün; dedizierte RLS-Integration **3/3**, Lead-Domain/VM/Route/Visual/A11y **35/35**, RLS-/Baseline-Nachzug **47/47**, i18n, Sidebar/Routes, Phase-C-Grenzen, Hot-Swap, Visual und A11y grün. Der vollständige Repository-Regressionstest ist mit **1.038 Testdateien / 7.398 Tests bestanden** dokumentiert; 10 Dateien / 55 environmentbedingt übersprungen. ### Umsetzungs-Notiz 2026-07-24 · Aufgaben und gemeinsame Timeline - `AdminTask` und `AdminTaskRecurrence` sind tenant-lose, an aktive AdminUser gebundene Plattformmodelle. Aufgaben lassen sich im Kontakt- oder Deal-Kontext mit Fälligkeit, Priorität und Zeitzone anlegen; Mail- und Call-Activities besitzen idempotente Commands für spätere P28c-/P28d-Konsumenten. - Die wiederkehrende Berechnung behandelt Sommerzeitwechsel und Monatsenden deterministisch. Der Worker reserviert fällige Reminder mit Lease, erzeugt zentrale In-App-Notifications und Outbox-Einträge atomar und bleibt bei Wiederholung idempotent. - `/sales/tasks/today`, Kontakt- und Deal-Detail sind permission-gegatet über Sidebar, Breadcrumbs und Action-Callbacks erreichbar. Heute-Liste und Timeline besitzen Klartextzustände, Tastaturbedienung, i18n, Interim-Visuals und Hot-Swap-Adapter; Screens importieren weder Prisma noch Route-Daten. - Proof: `pnpm typecheck`, `pnpm lint` und vollständiger Testlauf mit **1.041 Testdateien / 7.406 Tests** grün; dedizierter App-/Worker-RLS-Proof **2/2**, Task-Domain-/Worker-/Route-/VM-Tests, `verify:i18n`, Sidebar/Routes, Phase-C-Grenzen, **325/325** RLS-Verträge, **323/323** Modellklassifikationen, Hot-Swap, Visual und A11y grün. ### Umsetzungs-Notiz 2026-07-24 · Datenverwaltung - Kontakte und Deals erhalten typisierte Custom-Field-Definitionen und -Werte statt eines unvalidierten JSON-Blobs. Tags, Kontaktnotizen und Bulk-Änderungen prüfen die kleinste Admin-Sales-Permission und schreiben Fachdaten, `AdminActivity` und Audit atomar. - Der CSV-Import nutzt eine bestätigungspflichtige Mapping-Vorschau, normalisierte Dublettenprüfung, Zeilenfehlerdatei und feste Grenzen von 5 MB beziehungsweise 5.000 Zeilen. Uploads laufen fail-closed über den zentralen ClamAV-/EU-Storage-Pfad. Der Worker verarbeitet Import und Export idempotent; Exporte sind formelsicher, verschlüsselt und verfallen nach sieben Tagen. - `/sales/contacts` und `/sales/data-jobs/:id/download` sind über den permission-gegateten Sidebar-Einstieg erreichbar. Die Interim-UI verdrahtet Suche, Bulk-Aktionen, Tags, Custom Fields, Importvorschau, Export, Jobstatus, Fehler-Downloads und Kontaktnotizen über reine View-Models und Action-Callbacks. - Der App-Runtime-Vertrag bleibt enger als der Worker-Vertrag: Der Worker darf validierte Importzeilen anlegen und Exportdaten lesen, aber keine bestehenden CRM-Zeilen verändern oder löschen. Download-Links werden erst nach erneuter Owner-, Status-, Ablauf- und Storage-Prüfung kurzzeitig signiert. - Proof: `pnpm typecheck`, `pnpm lint` und vollständiger Testlauf mit **1.045 Testdateien / 7.418 Tests** grün; dedizierter Live-DB-RLS-Proof **3/3**, Fokuslauf **389/389**, `verify:i18n`, Sidebar/Routes, Phase-C-Grenzen, **333/333** RLS-Verträge, **331/331** Modellklassifikationen, Hot-Swap, **130** Visual-Checks und **44** A11y-Tests grün. ### Umsetzungs-Notiz 2026-07-24 · Bestätigter Won-Deal-/Tenant-Link - Ausschließlich gewonnene Deals können über eine explizite Bestätigung samt Begründung an einen aktiven Bestands-Tenant oder einen neuen Tenant verknüpft werden. Die Transaktion sperrt den Deal, verhindert widersprüchliche Wiederholungen und schreibt Link, `AdminActivity` sowie unveränderlichen Admin-Audit atomar. - Neue Tenants verwenden eine deterministische Reservierungs-ID, bleiben bis zur Owner-Annahme inaktiv und erhalten eine Owner-Einladung im bestehenden Tenant-Bootstrap-Vertrag. Der AdminUser wird dabei weder Tenant-User noch Tenant-Mitglied; Billing bleibt ausdrücklich `VA-P28g` vorbehalten. - Deal-Detail und reine View-Models zeigen den Linkzustand und einen barrierearmen Bestätigungsdialog für Bestands- oder Neuanlage. Route und Actions bleiben mit `admin_sales.crm.write` gegatet; unbestätigte Requests erreichen keinen Tenant-Service. - Proof: Paket- und Web-Typechecks, `pnpm lint`, Prisma Validate, `verify:i18n`, Phase-C-Grenzen, **333/333** RLS-Verträge und **331/331** Modellklassifikationen grün; Route-/Service-/VM-/Visual-/A11y-Fokuslauf **25/25** sowie dedizierter Live-DB-RLS-Proof **4/4** grün. Der vollständige Repository-Regressionstest ist mit **1.047 Testdateien / 7.426 Tests** bestanden; 10 Dateien / 55 environmentbedingt übersprungen. ### Umsetzungs-Notiz 2026-07-24 · Gemeinsamer Mutationsvertrag - Eine ausführbare Permission-Matrix ruft jede öffentliche Core-, Pipeline-, Lead-, Task- und Datenoperation auf und belegt die kleinste Berechtigung: Lesen, Schreiben, Zuweisen, Zusammenführen oder Exportieren. Reine Route-Level-Adminchecks genügen damit nicht als Proof. - Konfigurationsänderungen, Dublettenentscheidungen, Import-/Exportanforderungen und Warteschlangenübergänge schreiben jetzt ebenfalls eine typisierte gemeinsame `AdminActivity`. Bestehende fachliche Mutationen behalten ihre entitätsgebundene Activity; Worker-interne Statuspflege wird nicht fälschlich als Adminhandlung ausgegeben. - Der zentrale Audit-Writer ist als tenant-loser Hash-Chain-Vertrag geprüft: `actorType=admin`, `tenantId=null`, gebundene Admin-ID/-E-Mail und dokumentierter Grund. Activity, Fachmutation und Audit verbleiben jeweils in derselben Transaktion. - Proof: Package- und Workspace-Typechecks, `pnpm lint` sowie der vollständige Repository-Lauf mit **1.047 Testdateien / 7.426 Tests** grün; Permission-/Repository-Fokus **31/31** und einzeln ausgeführte Live-DB-RLS-Suites **9/9** grün. `verify:i18n`, Sidebar/Routes, Phase-C-Grenzen, **333/333** RLS-Verträge, **331/331** Modellklassifikationen, Hot-Swap, **130** Visual-Checks und A11y-Coverage sind grün. ### Umsetzungs-Notiz 2026-07-24 · Gesamt-Reachability und Zustände - Der permission-gegatete Sales-Bereich besitzt nun eigenständige Sidebar-Einstiege für Leads, Deals, Kontakte, Firmen, Heute, Lead-/Pipeline-Einstellungen, Felder und Tags sowie Import und Export. Alle Ziele werden vom Route-Inventar nachgewiesen; die kleinste Berechtigung bleibt je Einstieg sichtbar. - Firmen ohne Kontakt sind in der Liste sichtbar. Die Firmen-Detailroute lädt ein reines View-Model mit Buying-Center, Deals und gemeinsamer Activity, verlinkt Kontakt-/Deal-Kontexte und liefert für unbekannte IDs echte 404-Semantik. Der Live-DB-Proof belegt: ungebundene App-Sessions sehen keine Firma, ein gebundener aktiver Admin schon. - Kontakte, Firmen, Deals und Einstellungsdetails besitzen Breadcrumbs. Der gemeinsame Sales-Routenrahmen liefert Klartext-Loading und Error Boundary; Permission-Denied bleibt 404. Kontakte, Felder/Tags und Import/Export nutzen fokussierte Interim-Ansichten mit denselben serverseitigen Actions statt paralleler Fachlogik. - Proof: DB-/VM-/Route-/Visual-Fokus **29/29**, vollständige Sales-Visual-/A11y-Familie **13/13** und Live-DB-RLS **3/3** grün; DB-, View-Model- und Web-Typechecks, `pnpm lint`, `verify:i18n` mit **13.849** Keys, Sidebar/Routes **40/40**, Phase-C-Grenzen, Hot-Swap, **130** statische Visual-Checks und A11y-Coverage grün. ### Umsetzungs-Notiz 2026-07-24 · Qualitäts- und Golden-Path-Abschluss - Der Browser-Smoke meldet sich mit dem kanonischen lokalen Plattform-Admin an, legt bei leerer Datenbank die SaaS-Pipeline über die echte Action an und erreicht Deal-Pipeline, Kontakte, Firmen, Heute, Pipeline-Einstellungen, Felder/Tags und Import/Export über produktive Routen. Die Kontaktansicht erfüllt dabei WCAG 2 A/AA auch im echten Browser; die Interim-Visual-Baseline wurde ausschließlich für die korrigierten Kontrast-Tokens aktualisiert. - Das UI-Inventar führt alle VA-P28b-Sidebar-Ziele mit stabilen IDs. Die Import-/Export-Jobs sind zusätzlich im zentralen Queue-Retry-Metrikvertrag registriert; Hot-Swap, Visual-, A11y-, Boundary-, i18n-, Sidebar- und Modellverträge bleiben grün. - Proof: `pnpm typecheck`, `pnpm lint`, `pnpm build` und der vollständige Repository-Test mit **1.049 Testdateien / 7.433 Tests** grün; alle **36** Package-Testgruppen, Browser-Smoke **1/1**, Fokuslauf **21/21**, VA-P28b-/M033-Live-RLS **11/11**, RLS-Vertrag **333/333**, Cross-Cutting-Modelle **331/331**, Hot-Swap, **130** Visual-Checks und **44** A11y-Tests grün. - Der bereits gemergte `R-LEADS`-Codevertrag bleibt konsistent. Sein separat akzeptierter operativer Cutover steht weiterhin bei **6/10 DoD**; die dort noch ausstehende Migration, Backfill-/Drain- und Staging-Verifikation wird hier weder verändert noch als VA-P28b-Proof beansprucht. - Die branchweite Migrations-Parität folgt nach explizitem P28-Vertrag erst mit der gemeinsamen Forward-only-Merge-Migration nach Abschluss aller Admin-Sales-Schemas. Es wurde in diesem Ticket deshalb kein konkurrierendes Migrationsartefakt erzeugt. ### Umsetzungs-Notiz 2026-07-29 · Pool-sicherer Feature-Flag-Rollout-Preview - Der vollständige deterministische Rollout-Preview bleibt erhalten, hydratisiert die tenant-spezifischen RLS-Daten aber nur noch mit vier parallelen Tenant-Workern. Da pro Tenant zwei Abfragen parallel laufen, beansprucht der Preview bei der Standard-Poolgröße 10 höchstens acht gleichzeitige DB-Abfragen statt eines unbeschränkten Fanouts. - Der fokussierte Test hält sechs Tenant-Abfragen gezielt zurück und belegt die Obergrenze von vier gleichzeitig aktiven RLS-Kontexten, den lückenlosen Start aller Tenants sowie stabile Tenant-/Preview-Reihenfolge und unveränderte Filter-, Override- und Default-Ergebnisse bei absichtlich abweichender Abschlussreihenfolge. - Proof: Feature-Flag-Rollout-Service **4/4 Tests** grün, fokussierter ESLint-Lauf ohne Warnungen und `pnpm --filter @hivegrid/web typecheck` grün. **Slice-Stand:** **10/10 DoD = 100 % done**. Kein selbst machbarer DoD-Punkt und kein externer DoD-Blocker bleiben in VA-P28b offen; ausschließlich der nicht blockierende Design-Nachzug ist weiterhin getrackt. ## Technische Bausteine - **Schema:** eigene Admin-Sales-Moduldatei, keine neuen Fachmodelle in `core.prisma`/`accounts.prisma`; Relation zu `AdminLead` aus `prisma/schema/adminLeads.prisma`. - **Modelle:** `AdminCompany`, `AdminContact`, `AdminContactChannel`, `AdminPipeline`, `AdminPipelineStage`, `AdminStageRequiredField`, `AdminDeal`, `AdminDealContact`, `AdminDealStageHistory`, `AdminDealLossReason`, `AdminLeadAssignmentRule`, `AdminLeadScoreRule`, `AdminTask`, `AdminTaskRecurrence`, `AdminActivity`, `AdminTag`, `AdminCustomFieldDefinition`, `AdminCustomFieldValue`, `AdminImportJob`, `AdminExportJob`, `AdminDuplicateCandidate`, `AdminMergeRecord`. - **Assignment:** deterministischer Resolver mit manueller Übersteuerung und auditierter Round-Robin-Position. - **Merge:** Vorschau, Feldkonflikte, atomare Referenzumschreibung und unveränderliche Merge-Historie. - **Jobs:** Import, Export, Enrichment und Reminder über zentrale Queue/Idempotenz; keine synchronen Großläufe. - **RLS:** Admin-Policy an die getrennte AdminUser-Identität binden; kein Tenant-GUC als Sales-Scope. ## Interne Slices und Rollback 1. Bestehendes M033/M040b-Inventar und Contract-Tests. 2. Company/Contact/Deal-Datenkern. 3. Pipeline/Stages/Historie/Promotion. 4. Advanced Lead Management auf R-LEADS. 5. Tasks/Timeline. 6. Custom Fields/Tags/Bulk. 7. Import/Export/Merge. 8. Bestätigter Won-Deal-/Tenant-Link. 9. Gemeinsamer Permission-/Audit-/Activity-Vertrag. 10. Gesamt-Reachability, Firmenansichten und Klartextzustände. Jeder Slice bleibt per Feature-Flag ausblendbar. Neue Tabellen werden forward-only migriert; Rollback schaltet Reads/Writes auf den vorherigen stabilen Slice zurück und löscht keine Sales-Daten. ## Quellen - `.planning/ticket-docs/R-LEADS.md` auf `main` — M040a-Vertrag - `.planning/ticket-docs/VR-P28a.md`, `AK-P19.md`, `VD-P28.md` - `.planning/ENTITY-MODEL.md` — Domäne 11 - `docs/ARCHITECTURE-DECISIONS.md` — AD-21, AD-28, AD-31 ## Dev-Nachzug - [ ] Formale Change-Request-Dokumentation für den Sales-Workspace nach gemeinsamer Block-Review finalisieren. - [ ] Termine/Cycle nach Schätzung der sieben Sales-Slices festlegen. - [ ] Plane-Beschreibung und beide Richtungen aller Abhängigkeiten aktuell halten. - [ ] Davids `VD-P28`-Delta übernehmen und Visual-Baselines neu ziehen. ## Abhängigkeitsnachzug · CR-007 · 2026-07-27 Der Admin-Sales-Kern und `/sales/settings/leads` sind nicht mehr vom globalen `platform_admin_leads`-Flag abhängig. Alle bestehenden Permission- und RLS-Scope-Verträge bleiben unverändert.