Update hivegrid-cloud reference to latest main

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 16:15:37 +02:00
1 parent e98d38e716
commit 7b21524c86
3781 files changed
+373484 -225607

No files matched your search

@@ -0,0 +1,50 @@
# 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.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
- [x] `OnboardingService` ohne `getAllEntities`/`~/utils/db/entities`-Import; `entities`-Metadata aus `getMetadata()` + `OnboardingFilterMetadataDto` entfernt.
- [x] `OnboardingFiltersService` ohne `RowsApi`; die `entity.hasCreated`/`hasNotCreated`-Filter-Cases entfernt (statt Count-Vorschau).
- [x] `OnboardingFiltersService.test.ts` + die onboarding-Modul-Tests grün (35 Tests); `verify-onboarding-flow.mjs` grün.
- [x] Public `/onboarding/$id` + `admin/onboarding/**` bleiben konsistent (entity-InputSelector in `filters.tsx` + `OnboardingFilterUtils`-Parse-Zweig entfernt; `appOrAdminData.entities` nicht mehr referenziert).
- [x] 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.