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

397 lines
25 KiB
Markdown

# 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.