4.7 KiB
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 | neu · Child von R-P14C-T2 |
| 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.hasNotCreatedinOnboardingFiltersService+ dieentities-Liste inOnboardingService.getMetadata). Ohne Entity-Builder ist das bedeutungslos → diese Bedingungen + dieentities-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-T2Quer-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, solangegetAllEntities/RowsApiim Modul). - Slug
onboardingist indisabledPluginRouteSlugs(nav-versteckt);admin/onboarding/**+ public/onboarding/$idexistieren.
Was wir bauen
Nur zwei periphere Entity-Builder-Stellen entkoppeln:
OnboardingService.ts:3,225—getAllEntities({ tenantId: null })füllt einentities-Feld der Onboarding-Config (Liste der verfügbaren Entities, vermutlich für Step-/Filter-Auswahl).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
OnboardingServiceohnegetAllEntities/~/utils/db/entities-Import;entities-Metadata ausgetMetadata()+OnboardingFilterMetadataDtoentfernt.OnboardingFiltersServiceohneRowsApi; dieentity.hasCreated/hasNotCreated-Filter-Cases entfernt (statt Count-Vorschau).OnboardingFiltersService.test.ts+ die onboarding-Modul-Tests grün (35 Tests);verify-onboarding-flow.mjsgrün.- Public
/onboarding/$id+admin/onboarding/**bleiben konsistent (entity-InputSelector infilters.tsx+OnboardingFilterUtils-Parse-Zweig entfernt;appOrAdminData.entitiesnicht 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-Typentenant.user.entity.hasCreated/hasNotCreated(EnumOnboardingFilterTypes), derRowsApi.count-Case (OnboardingFiltersService), dasentities-Metadata-Feld (OnboardingService.getMetadata+OnboardingFilterMetadataDto), der Parse-Zweig (OnboardingFilterUtils) und der entity-InputSelector (onboardings.$id/filters.tsx) entfernt; Filter-Beschreibung intranslations.json(de+en) nachgezogen. Restliche onboarding-Filter (user/tenant/role/subscription/apiKeyLogs) unverändert. Test-Mocks fürRowsApi/getAllEntitiesaus den zwei Suites entfernt. Proof: 35 onboarding-Tests grün,verify:onboarding-flowEXIT 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.counttrug Tenant-Kontext → typisierter Count viawithTenantScope()/RLS. - Querschnitt M001/M002/M004 wie üblich.
Offene Entscheidungen (vor Bau klären)
- 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.
- 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.mdAD-2.