397 lines
25 KiB
Markdown
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.
|