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

4.8 KiB
Raw Blame History

R-P14F · onboarding vom Entity-Builder entkoppeln

Typ Dev (Code)
Owner Raffael (+ Agent)
Phase P6 / P14 (Entity-Builder-Ablösung, AD-2) — Teil 2
Plane kein eigenes Ticket — getrackt über R-P14C (HIVEGRID-169) · Child von R-P14C-T2 (Audit 2026-07-19)
Größe S–M (peripher; nur 2 Touchpoints)
Status ENTSCHIEDEN (Raffael 2026-06-30): entity-basierte Filter-Bedingungen entfernen (kein Rebuild). Baubar.

Entscheidung 2026-06-30: Die EB-Kopplung ist die Onboarding-Filter-Bedingung „Nutzer hat (k)eine Reihe einer generischen Entität angelegt" (entity.hasCreated/entity.hasNotCreated in OnboardingFiltersService + die entities-Liste in OnboardingService.getMetadata). Ohne Entity-Builder ist das bedeutungslos → diese Bedingungen + die entities-Metadata entfernen, der Rest von onboarding (Flows, andere Filter: user/tenant/role/subscription/apiKeyLogs) bleibt unverändert. Falls später „Nutzer hat Kontakt angelegt" als Bedingung gewünscht ist → neuer typisierter Filter über die Registry (eigenes Mini-Ticket).

Abhängigkeiten & Parallelität

  • blocked-by: ggf. R-P14C-T2 Quer-Entscheidung — nur, falls onboarding weiter „Entities" auflisten/zählen können soll (dann braucht es das adressierbare Modell-Set). Falls die Touchpoints schlicht entfernt/ersetzt werden können, früh + parallel baubar.
  • blocks: R-P6B-β (mit-blockierend, solange getAllEntities/RowsApi im Modul).
  • Slug onboarding ist in disabledPluginRouteSlugs (nav-versteckt); admin/onboarding/** + public /onboarding/$id existieren.

Was wir bauen

Nur zwei periphere Entity-Builder-Stellen entkoppeln:

  1. OnboardingService.ts:3,225 — getAllEntities({ tenantId: null }) füllt ein entities-Feld der Onboarding-Config (Liste der verfügbaren Entities, vermutlich für Step-/Filter-Auswahl).
  2. OnboardingFiltersService.ts — RowsApi.count({...}) zählt generische Reihen für die Filter-Vorschau.

Beide hängen am generischen Entity-Begriff. Optionen je Stelle: durch die typisierte Modell-Registry ersetzen (adressierbare Modelle/Counts) oder entfernen, falls onboarding den Entity-Bezug in v1 gar nicht braucht.

Definition of Done

  • OnboardingService ohne getAllEntities/~/utils/db/entities-Import; entities-Metadata aus getMetadata() + OnboardingFilterMetadataDto entfernt.
  • OnboardingFiltersService ohne RowsApi; die entity.hasCreated/hasNotCreated-Filter-Cases entfernt (statt Count-Vorschau).
  • OnboardingFiltersService.test.ts + die onboarding-Modul-Tests grün (35 Tests); verify-onboarding-flow.mjs grün.
  • Public /onboarding/$id + admin/onboarding/** bleiben konsistent (entity-InputSelector in filters.tsx + OnboardingFilterUtils-Parse-Zweig entfernt; appOrAdminData.entities nicht mehr referenziert).
  • Voller CI-Scope grün; AD-2: 0 Entity-Builder-Importe im Modul.

Umsetzung

  • 2026-06-30 (autonomer Lauf, Branch feat/R-P14C-teil2): Slice A2 umgesetzt, 5/5 DoD = 100 %. Die zwei Filter-Typen tenant.user.entity.hasCreated/hasNotCreated (Enum OnboardingFilterTypes), der RowsApi.count-Case (OnboardingFiltersService), das entities-Metadata-Feld (OnboardingService.getMetadata + OnboardingFilterMetadataDto), der Parse-Zweig (OnboardingFilterUtils) und der entity-InputSelector (onboardings.$id/filters.tsx) entfernt; Filter-Beschreibung in translations.json (de+en) nachgezogen. Restliche onboarding-Filter (user/tenant/role/subscription/apiKeyLogs) unverändert. Test-Mocks für RowsApi/getAllEntities aus den zwei Suites entfernt. Proof: 35 onboarding-Tests grün, verify:onboarding-flow EXIT 0, voller CI-Scope grün.
  • (Hinweis: Falls „Nutzer hat Kontakt angelegt" später als Onboarding-Bedingung gewünscht ist → neuer typisierter Filter über die Modell-Registry, eigenes Mini-Ticket.)

Technische Bausteine

  • Modell-Registry (T2) für „verfügbare Modelle/Counts", falls onboarding diese Auswahl behält.
  • Tenant-Scope: RowsApi.count trug Tenant-Kontext → typisierter Count via withTenantScope()/RLS.
  • Querschnitt M001/M002/M004 wie üblich.

Offene Entscheidungen (vor Bau klären)

  1. Braucht onboarding den Entity-Bezug überhaupt? Wenn die Onboarding-Flows in v1 keine generischen Entities mehr referenzieren (typisierte Modelle reichen / Bezug war Boilerplate), → beide Stellen entfernen (kleinster Pfad). Sonst über Registry typisieren.
  2. Modell-Set = Quer-Entscheidung T2 (nur relevant bei Option „typisieren").

Quellen

  • R-P14C-T2.md (Übersicht + Registry).
  • OnboardingService.ts:3,225, OnboardingFiltersService.ts (Bestand).
  • R-P6B.md §Rückwirkungs-Audit (onboarding low-prio).
  • docs/ARCHITECTURE-DECISIONS.md AD-2.