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-LEADSbleibt 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-P28bsowie die abhängigen TicketsVA-P28cbisVA-P28iin 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-FunktionenR-LEADS(nativeAdminLead-/Activity-/Source-Datenbasis). - Blocks:
VA-P28c,VA-P28d,VA-P28e,VA-P28f,VA-P28g,VA-P28h,VA-P28iundVR-P28a-RBACfür den rollenbasierten Own-/All-Scope des bestehenden CRM Core. - Läuft parallel zu:
VR-P28anur 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, keinetenantIdauf Sales-Tabellen, kein BYPASSRLS. - Owner-Auswirkung:
R-LEADS,VR-P28aundVA-P28cbisVA-P28ibehalten ihre Verträge; es gibt keinen Cross-Owner-Handoff mehr. Der R-LEADS-Cutover bleibt operativ separat.
Implementierungsstart 2026-07-24:
blocked-byundblockswurden in Plane und in den Ticket-Docs beider Richtungen geprüft.VR-P28asteht 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-01Eigene Pipeline-Stufen definieren.PIP-02Deals per Drag-and-drop verschieben.PIP-03Deal-Wert erfassen.PIP-04Erwartetes Abschlussdatum setzen.PIP-05Abschlusswahrscheinlichkeit je Stufe hinterlegen.PIP-06Verlustgrund beim Verlieren erfassen.PIP-07Warnung bei zu langer Verweildauer in einer Stufe.PIP-08Definierten nächsten Schritt je Deal anzeigen.PIP-09Pflichtfelder je Stufe erzwingen.PIP-10Stufen-Historie eines Deals anzeigen.PIP-11Mehrere Ansprechpartner als Buying-Center am Deal führen.
Lead-Management auf R-LEADS
LEAD-02Lead in einen Deal umwandeln.LEAD-03Leads nach Regeln wie Region oder Quelle automatisch zuweisen.LEAD-04Leads per Round-Robin verteilen.LEAD-05Dubletten bei Anlage erkennen.LEAD-06Zwei Datensätze kontrolliert zusammenführen.LEAD-07Leads nach konfigurierbaren Kriterien bewerten.LEAD-09Firmendaten automatisch ergänzen.LEAD-10Bei Lead-Zuweisung benachrichtigen.
LEAD-01 und LEAD-08 bleiben in R-LEADS.
Aufgaben und Aktivitäten
ACT-01Aufgabe an Deal oder Kontakt erstellen.ACT-02Fälligkeit und Priorität setzen.ACT-03An fällige Aufgaben erinnern.ACT-04Heute-Liste offener Aufgaben anzeigen.ACT-05Aus einer Mail oder einem Anruf direkt eine Aufgabe erzeugen.ACT-06Wiederkehrende Aufgaben anlegen.ACT-07Chronologische Aktivitäts-Timeline je Kontakt anzeigen.
Daten und Verwaltung
DATA-01Eigene Felder an Kontakten und Deals anlegen.DATA-02Kontakte taggen.DATA-03Mehrere Datensätze gleichzeitig bearbeiten.DATA-04Kontakte per CSV importieren.DATA-05Daten als CSV exportieren.DATA-06Notizen 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 > Defaultund Audit. - Ein typisierter Admin-Sales-Kern für
AdminCompany,AdminContact,AdminDealund Relationen zuAdminLeadaus 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..07undLEAD-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
Tenantverknüpft werden; Sales-Daten bleiben dabei Admin-Daten. - Alle Mutationen sind permission-gegatet, auditieren mit
actorType=admin/tenantId=nullund schreiben die gemeinsameAdminActivity. - 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-LEADSund 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,
FeatureFlagAuditund zentralem Hash-Chain-Audit atomar. AdminFeatureFlagOverrideist 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 testmit 1.032 Dateien / 7.385 Tests grün; Feature-Flag-/VM-/Route-/RLS-Tests grün; Prisma Validate + isoliertesdb 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,AdminDealund Buying-Center liegen typisiert in der eigenen ModuldateiadminSales.prisma. Company, Contact und Deal referenzieren den bestehendenAdminLeadaus R-LEADS; es gibt keine zweite Lead-Tabelle und keinetenantId-Spalte.AdminActivityverbindet 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,
AdminActivityund 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-nachzugbleibt offen. - Proof:
pnpm typecheck,pnpm lintund 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/leadsist mitadmin_sales.crm.assigngegatet 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, isoliertesdb 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
AdminTaskundAdminTaskRecurrencesind 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 lintund 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,
AdminActivityund 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/contactsund/sales/data-jobs/:id/downloadsind ü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 lintund 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,
AdminActivitysowie 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-P28gvorbehalten. - 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.writegegatet; 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 lintsowie 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:i18nmit 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 buildund 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 typecheckgrü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 zuAdminLeadausprisma/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
- Bestehendes M033/M040b-Inventar und Contract-Tests.
- Company/Contact/Deal-Datenkern.
- Pipeline/Stages/Historie/Promotion.
- Advanced Lead Management auf R-LEADS.
- Tasks/Timeline.
- Custom Fields/Tags/Bulk.
- Import/Export/Merge.
- Bestätigter Won-Deal-/Tenant-Link.
- Gemeinsamer Permission-/Audit-/Activity-Vertrag.
- 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.mdaufmain— M040a-Vertrag.planning/ticket-docs/VR-P28a.md,AK-P19.md,VD-P28.md.planning/ENTITY-MODEL.md— Domäne 11docs/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.