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

25 KiB

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

  • M033: Flag-Massen-Statistik, Live-Filter-Vorschau und Bulk-Override mit deterministischer Auswertung Override > Filter > Default und Audit.
  • Ein typisierter Admin-Sales-Kern für AdminCompany, AdminContact, AdminDeal und Relationen zu AdminLead aus R-LEADS; keine zweite Lead-Tabelle oder Intake-Implementierung.
  • Pipeline-Stufen, DnD, Wert, Abschlussdatum, Wahrscheinlichkeit, Verlustgrund, Aging, nächster Schritt, Pflichtfelder, Historie und Buying-Center erfüllen PIP-01..11.
  • Conversion, regelbasierte Zuweisung, Round-Robin, Duplicate-Hinweis, Merge, Scoring, Enrichment und Assignment-Notification erfüllen LEAD-02..07 und LEAD-09..10.
  • Aufgaben, Reminder, Heute-Liste, Wiederholung und gemeinsame Kontakt-Timeline erfüllen ACT-01..07; Mail-/Call-Aktionen docken später über stabile Commands an.
  • Custom Fields, Tags, Bulk Edit, CSV-Import/-Export und Kontaktnotizen erfüllen DATA-01..06.
  • 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.
  • Alle Mutationen sind permission-gegatet, auditieren mit actorType=admin/tenantId=null und schreiben die gemeinsame AdminActivity.
  • 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.
  • 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.
  • 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.