Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P6C.md
T
2026-07-08 16:15:37 +02:00

4.7 KiB

R-P6C · CRM-Querschnitt-Nachzüge (projektweite Verdrahtung)

Typ Dev (Code)
Owner Raffael (+ Agent) — nur wir, kein Akeshan
Phase P6 — CRM-Kern (Zwischenticket R-P6 → R-P6B)
Status geplant

Warum dieses Ticket

R-P6 hat die typisierten CRM-Modelle eingeführt und ist querschnittlich zu ~80 % verdrahtet (Audit 2026-06-29). Drei projektweite Cross-Cutting-Stellen sind aber noch offen — sie gehören NICHT in die große Entity-Builder-Ablösung (R-P6B, durch AK-P14 blockiert), sondern sind kleine, nicht-blockierte CRM-Nachzüge, die wir selbst bündeln. Auslöser war u.a. der TENANT_SCOPED_MODELS-CI-Bruch (ein Symptom der projektweiten Registry-Pflicht).

Abgrenzung: Dies ist KEIN Entity-Builder-Abbau (das ist R-P6B-β). Hier wird nur die fehlende Querschnitt-Verdrahtung der NEUEN typisierten CRM-Entitäten ergänzt.

Was bereits erledigt ist (R-P6, nur zur Abgrenzung)

✅ TENANT_SCOPED_MODELS, Tenant-Snapshot, Audit (auditCrmEvent), Activity-Stream (contact/company + contact_*), Notifications-fähig, Sidebar + Permission-Gate, Command-Registry, Such-Schema (crm-contacts in ALL_SEARCH_INDEXES).

Definition of Done

  • Such-Index Registry verdrahtet (AGENTS DoD 16, Teilerfüllung): contact in packages/search/src/indexed-entities.ts registriert (Tabelle Kontakt, Index crm-contacts, permission-gated crm.read_all; EIN Eintrag deckt Privatperson + Organisation ab, da Kontakt Oberbegriff ist — kein separater Company-Index). Befund: Die funktionale Indexierung der typisierten Kontakte ist NICHT trivial isolierbar — der crm-contacts-Index wird aktuell noch vom Entity-Builder-Row-Feeder (rowSearchOutbox + Row-createCrmContactsPager) befüllt, nicht vom typisierten Kontakt-Modell. Den Feeder auf typisiert umzustellen löst den Row-Feeder ab → gehört zu R-P6B-β (siehe unten). Die Registry-Zeile ist vorbereitend + harmlos (gated nur, triggert keine kollidierende Indexierung).
  • DSGVO-Verdrahtung entschieden + umgesetzt: Konsistenter, dokumentierter Verzicht (Option 1) — Kontakt.createdByUserId/zustaendigerUserId sind bare Scalars (kein @relation), wie tasks/hr repo-weit; KEIN user-fk-map-Eintrag (Sonderweg vermieden). Entscheidung sichtbar im Kopfkommentar von packages/db/src/dsgvo/user-fk-map.ts dokumentiert; projektweite Pseudonymisierung bare-scalar-User-FKs als separates Querschnitt-Härtungs-Thema (wenn DSGVO-Lösch-Flow live geht) geparkt.
  • Footgun-Prävention: scripts/verify-cross-cutting-models-complete.mjs (+ .test.mjs + verify:cross-cutting-models npm-Script + ci.yml „Quality Static Verify 2/2"). Erzwingt: jedes tenantId-Prisma-Modell ist in TENANT_SCOPED_MODELS — klare Fehlermeldung statt kryptischem packages/cli-Test. Aktuell 104/104 models, 0 missing.
  • Lokal grün inkl. vollem CI-Test-Scope (typecheck + lint + test:foundation + test:packages + test:mobile + test + verify:i18n + verify:cross-cutting-models) — alle exit 0; PR mit grüner CI nach main.

Out of Scope (→ R-P6B-β + dessen Migrationskette)

Die Entity-Builder-Ablösung ist verbindlich (AD-2): kein „optional", und ab sofort keine neuen Konsumenten — siehe AGENTS.md + R-P6B.md §Rückwirkungs-Audit.

  • Entity-Builder-Abbau (modules/rows, utils/db/entities, entityBuilder.prisma, EntitiesSingleton).
  • Die Migrationskette davor (EmailMarketing/Workflows/API/Worker weg von Entity-Builder-contact → typisiert; Ownership in Klärung, siehe R-P6B.md §Migrationskette & Ownership).
  • Funktionale typisierte-Kontakt-Indexierung (incremental emit in crmService + Kontakt-Bulk-Pager + DE→EN-Feld-Projektion, Ablösung des Row-Feeders auf crm-contacts) — gehört zur Entity-Builder-Ablösung, da es den Row-Feeder ersetzt. → R-P6B-β (z.B. zusammen mit β2).
  • Mobile-Tab-Bar / Customer-Portal-Sichtbarkeit für CRM (separat, falls überhaupt Phase-1-relevant).

Quellen

  • Cross-Cutting-Audit der R-P6-CRM-Modelle (2026-06-29) — siehe Konversation/Plane #21.
  • AGENTS.md DoD B (Reachability) + C (Querschnitt-Wiring), insb. DoD 16 (Search-Index).
  • Memory feedback-ci-test-scope-gap (TENANT_SCOPED_MODELS-Footgun).

Umsetzung

  • 2026-06-29: Ticket angelegt nach Cross-Cutting-Audit. Scope-Entscheidung (Raffael): nur wir zwei, ein Zwischenticket, kein Akeshan.
  • 2026-06-29: Umgesetzt. DSGVO-Entscheidung (konsistenter Verzicht, dokumentiert) + Footgun-Verify-Check (verify:cross-cutting-models, in ci.yml) + Such-Index-Registry-Eintrag. Such-Index-Erkenntnis: die funktionale typisierte-Kontakt-Indexierung ist an die Entity-Builder-Row-Feeder-Ablösung gekoppelt (R-P6B-β) — Registry-Zeile ist vorbereitend gesetzt, Indexierung dort geflaggt. Voller CI-Test-Scope lokal grün.