Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -6,7 +6,7 @@
| **Owner** | Raffael |
| **Phase** | P6 — CRM-Kern (Folge von R-P6) |
| **Plane** | #166 · blocked-by `R-P6` (✅ erledigt 2026-06-29) |
| **Status** | geplant — **Scope-Klärung offen** (siehe §Blocker) |
| **Status** | **Done** — 7/7 DoD = 100 % done |
## Was wir bauen
Die **vollständige Entfernung des generischen Entity-Builders** aus HiveGrid (AD-2). R-P6 (Variante A) hat den CRM-Teil bereits typisiert und den CRM-Entity-Builder-**Pfad** abgelöst. R-P6B (Variante B) entfernt den **generischen Rest**: `apps/web/app/modules/rows/**`, `apps/web/app/utils/db/entities/**`, die Entity-Builder-Settings/Admin-Routes, die autogenerierten `$entity.__autogenerated`-Routen, Row-Collab (Hocuspocus/`api.collab.token`) und schließlich das `prisma/schema/entityBuilder.prisma`-Schema.
@@ -74,7 +74,7 @@ Der generische Entity-Builder wird **nicht nur von CRM** genutzt. Vor der Entfer
- [x] `EntitiesSingleton` entfernt: die 8 Builder-Kern-Konsumenten starben mit `modules/rows`; die bleibenden (`useAppData`/`useAdminData`/`useAppOrAdminData`) verloren das `entities`/`entityGroups`-Feld; WorkflowEngine läuft über die typisierte Modell-Registry.
- [x] `modules/rows`, `utils/db/entities`, `admin/entities` (inkl. der Layout-Route `admin/entities.tsx`), `settings/entities`, `$entity.__autogenerated`, `g.$group`, Entity-API-Layer (`utils/api/.server/{Entities,Rows,Properties,Row*}Api`), `components/entities`, `modules/formulas`, `modules/codeGenerator` + die EB-Helper entfernt; `apps/api` `/v1/entities` + `/v1/relationships` + `packages/db/src/{entities,rows,relationships,settings}.server.ts` entfernt; Worker-Formular-`entity-row`-Pfad entfernt; Such-Indizes `rows`/`entities` entfernt; CRM-Such-Reindexer auf die typisierte `Kontakt`-Tabelle umgestellt.
- [x] Row-Collab: `api.collab.token` generischer `row`-Resource-Type entfernt (kb-article-Collab bleibt, alles andere fail-closed); Collab-Editor/hocuspocus bleiben. (CR: s.u.)
- [~] `entityBuilder.prisma` gelöscht + `prisma db push` (AD-21: kein Migrations-File am Branch); `TENANT_SCOPED_MODELS` (8 EB-Modelle raus) + `PLATFORM_CATALOG_GLOBALS` (Entity/EntityGroup/Formula/RowComment raus) + Cross-Schema-Relationen (accounts/core/permissions) nachgezogen. **Offen: forward-only DROP-Migration beim Merge** (s. §Umsetzung).
- [x] `entityBuilder.prisma` gelöscht + forward-only DROP-Migration `prisma/migrations/20260630120000_drop_entity_builder/migration.sql` mit Inverse-SQL-Kommentar vorhanden; `TENANT_SCOPED_MODELS` (8 EB-Modelle raus) + `PLATFORM_CATALOG_GLOBALS` (Entity/EntityGroup/Formula/RowComment raus) + Cross-Schema-Relationen (accounts/core/permissions) nachgezogen.
- [x] Tenant-Daten-Strategie dokumentiert: **keine echten Tenants** (Prod 0 echte Tenants) → Tabellen droppen, **kein Export/keine Daten-Migration** (Entscheidung Raffael 2026-06-30).
- [x] typecheck (web/worker/api/db) + lint + i18n + voller CI-Test-Scope grün; alle EB-bezogenen Tests angepasst/entfernt.
@@ -88,11 +88,8 @@ Der generische Entity-Builder wird **nicht nur von CRM** genutzt. Vor der Entfer
- 2026-06-29: Scope-Entscheidung (Raffael): **R-P6B-α jetzt** (nur nachweislich verwaiste Teile), struktureller Rest (β) nach AK-P14. **α umgesetzt** (Branch `feat/R-P6B-alpha`, **PR #15**): die konsumentenlosen Entity-Builder-Reader aus dem R-P6-Legacy-`CrmService` entfernt (550→185 Zeilen, grep-belegt 0 externe Konsumenten, kein Datenverlust). Voller CI-Test-Scope grün. EmailMarketing-Reader (validate/getContact/getContactsInRowIds) bleiben.
- **β bleibt blockiert** (AK-P14/workflows/formulas + Tenant-Daten-Entscheidung) — kein destruktives Löschen des Kerns ohne Vorab-Migrationen + Go.
- **2026-06-30: β ENTSPERRT.** Teil 1 (EmailMarketing, R-P14C) fertig; Teil 2 (workflows/onboarding) entschieden + formulas/codeGenerator = Cut mit β. **Tenant-Daten-Entscheidung gefallen:** keine echten Tenants (Prod hat 0 echte Tenants) → β = Tabellen droppen, forward-only Migration, **kein Export**. Ausführungsreifer Gesamtplan + alle gesetzten Entscheidungen: **`R-P14C-T2.md` §Ebene-1 Mega-Plan**. β läuft als 3. gestapelter PR (`feat/R-P6B-beta` auf `feat/R-P14C-teil2`).
- **2026-06-30: β UMGESETZT** (autonomer Lauf, Branch `feat/R-P6B-beta`). Der generische Entity-Builder ist **vollständig entfernt**. Proof: ~370+ Dateien gelöscht; `EntitiesSingleton`/`RowsApi`/`entityBuilder.prisma` weg (grep 0 in Quell-Code, nur noch Doku-Kommentare in `services/typed-model-registry/`); `entityLinks.prisma` (typisierte polymorphe Links) bewusst behalten. **Voller CI-Scope lokal grün:** typecheck (web/worker/api/db), lint, test:foundation/packages/mobile, Core-Test (3500 grün), verify:i18n, verify:cross-cutting-models (104/104 tenantId-Modelle, 8 EB-Modelle raus), verify:workflow-outbox-native (282), verify:onboarding-flow, verify:sidebar-routes, verify:feature-manifest-baseline, verify:removed-modules, verify:source-health, verify:ci-baseline. *(Advisory `verify:route-inventory` ist NICHT im CI-Gate und war schon vor β über Budget — β hat tenant-Routen von ~125 auf 83 reduziert, weiterer Abbau = Folge-Arbeit.)*
- **2026-06-30: β UMGESETZT** (autonomer Lauf, Branch `feat/R-P6B-beta`). Der generische Entity-Builder ist **vollständig entfernt**. Proof: ~370+ Dateien gelöscht; `EntitiesSingleton`/`RowsApi`/`entityBuilder.prisma` weg (grep 0 in Quell-Code, nur noch Doku-Kommentare in `services/typed-model-registry/`); `entityLinks.prisma` (typisierte polymorphe Links) bewusst behalten. **Voller damaliger CI-Scope lokal grün:** typecheck (web/worker/api/db), lint, Tests, i18n, Cross-Cutting-Modelle, Workflow-Outbox, Onboarding, Sidebar, Removed-Modules, Source-Health und CI-Baseline. *(Advisory `verify:route-inventory` war schon vor β über Budget — β hat tenant-Routen von ~125 auf 83 reduziert, weiterer Abbau = Folge-Arbeit.)*
- **2026-06-30: Remote-CI grün gezogen** (3 Fix-Commits auf `feat/R-P6B-beta`, nachdem die Gitea-Actions-CI Folgefehler der EB-Entfernung zeigte, die der lokale Scope nicht abdeckte). Behoben: (a) **OpenAPI-Spec + generierter API-Client** (`apps/api/src/openapi.ts`, `packages/api-client-ts/*`) ohne die 5 `/v1/entities`+`/v1/relationships`-Pfade; **Security-Inventare** `route-access-inventory.*` + `csrf-inventory` + generierter `tenant-isolation-report` nachgezogen; EB-Contract-Tests entfernt (`permission-matrix.test` gelöscht, `openapi.test`/`app.test`/`csrf-inventory.test`/`openapi-guard.test` bereinigt). (b) **Coverage** der kritischen apps/api-Module wiederhergestellt (neuer `auth/scope.test.ts` + Fixture-Branch — die gelöschten EB-Tests deckten auch behaltene Funktionen ab; auth 99.7 %, isolation 100 %). (c) **Production-Seed** `permissions-seed.server`: `entityId:null` aus `permission.createMany` raus (mit `Permission.entityId` weg; loser Client-Typ ließ es durch den Typecheck, brach erst zur Laufzeit im Docker-Smoke). (d) **Docker-Runtime-Smokes** prüfen nicht mehr hart auf den Entity-Pfad. Zwei CI-Ausfälle waren reine Flakes/Transient (Plugin-Sandbox-Test auf T1; paralleler Docker-Build) → per Re-Run grün. Endstand: **T1, R-P14C-teil2, R-P6B-beta alle grün** in Gitea-Actions.
- **Migration (AD-21):** Am Branch nur `prisma db push` (kein Migrations-File). Die **forward-only DROP-Migration** entsteht **beim Merge nach `main`** — sie muss alle `entityBuilder.prisma`-Tabellen droppen (DO $$ IF EXISTS $$-Guards) **und** die mit-entfernten Spalten/Relationen: `Log.rowId`/`Log.commentId` (+ FKs `Log.row`/`Log.comment`), `Permission.entityId` (+ FK), `ApiKey↔ApiKeyEntity`, sowie die Rück-Relationen auf User/Tenant/Role/Group. Inverse-SQL als Kommentar (DoD 28), reproduzierbar gegen leere DB (CI `migrate deploy`).
- **Offene CR-Flags (M176-Doc fehlt noch → hier vermerkt):**
1. **Collab generischer `row`-Resource-Type entfernt** (`api.collab.token`): Echtzeit-Collab für generische Rows weg; kb-article bleibt. Falls Collab auf typisierten Datensätzen gewünscht → typisierter resource-type-Zweig (neues Ticket).
2. **Formular-Eingang `entity-row`-Ziel entfernt** (Worker): `generic` (nur speichern) + `crm-contact` bleiben als Ziele. `packages/form-widget` `SubmissionTargetType` listet `entity-row` noch (Worker lehnt es ab) → Follow-up: aus dem Enum entfernen.
3. **REGRESSION (Pre-Launch unkritisch): Formular-Ziel `crm-contact` im Worker nicht mehr verdrahtet** (MISSING_CRM_ADAPTER). Der bisherige CRM-Creator war EB-basiert; es gibt keinen typisierten Kontakt-Creator in einem worker-erreichbaren Paket. Handler-Zweig existiert, ist aber unverdrahtet → crm-contact-Submissions schlügen zur Laufzeit fehl, bis ein typisierter Kontakt-Creator (packages/db oder shared) ergänzt wird.
4. **Workflow `rowGet`-Block = No-op** (`workflow-trigger-native-executor`): liefert `{row:null}`; rowGet bleibt unterstützter Block-Typ (Guard-Test grün), row-getriggerte Workflows bekommen aber null bis ein typisierter Ersatz verdrahtet ist.
- **Migration abgeschlossen:** Die forward-only DROP-Migration `20260630120000_drop_entity_builder` ist im Repo und enthält Guards + Inverse-SQL-Kommentar. Sie droppt die Entity-Builder-Tabellen und die entfernten FK-Spalten (`Log.rowId`, `Log.commentId`, `Permission.entityId`, `OutboundEmail.contactRowId`) reproduzierbar.
- **2026-07-09 Abschluss-Check:** R-P6B auf 7/7 DoD = 100 % done nachgezogen. Proof: `rg` auf alte Builder-Symbole (`entity-row`, `RowsApi`, `EntitiesSingleton`, `/v1/entities`, `/v1/relationships`, `modules/rows`, `utils/db/entities`, `settings/entities`, `admin/entities`, `$entity.__autogenerated`) im Source-Scope leer; `crm-contact`-Formularpfad ist im Worker-Bootstrap typisiert über `prisma.kontakt.create` / Form-Actions verdrahtet; nativer Workflow-`rowGet` liest jetzt tenant-scoped aus der typisierten `Kontakt`-Tabelle statt `{ row: null }`; alte Entity-Builder-Docs-Links aus der Docs-Sidebar entfernt.
Verifikation: `pnpm exec vitest run apps/worker/src/jobs/workflow-trigger-native-executor.test.ts -t "rowGet"` grün; `pnpm exec vitest run apps/worker/src/jobs/form-submission-route.test.ts apps/worker/src/jobs/form-submission-route-bootstrap.test.ts apps/worker/src/jobs/workflow-trigger-native-executor.test.ts -t "rowGet|CRM contact|crm-contact|FORM_SUBMISSION_ROUTE_QUEUE|bootstrap"` grün; `pnpm exec vitest run packages/form-widget/src/routing.extra.test.ts apps/web/app/routes.test.ts apps/worker/src/jobs/workflow-trigger-native-executor.test.ts -t "unknown-target|removed fake|rowGet"` grün; `pnpm exec vitest run apps/api/src/app.test.ts apps/api/src/openapi.test.ts apps/api/src/plugin-hook-publisher.test.ts apps/api/src/middleware/body-limit.test.ts apps/api/src/idempotency/store.test.ts` grün; `pnpm --filter @hivegrid/web typecheck`, `pnpm --filter @hivegrid/api typecheck`, `pnpm --filter @hivegrid/worker typecheck` grün.