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

3.6 KiB

R-P14G · codeGenerator-Disposition (Entity-Builder-Werkzeug)

Typ Dev (Code) — Disposition/Entscheidung
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 (bei Cut) / L (bei Rebuild — nicht empfohlen)
Status ENTSCHIEDEN: CUT mit β (Raffael 2026-06-30) — Option 1; codeGenerator wird mit dem Entity-Builder in R-P6B-β entfernt, kein eigener Bau.

⚠️ Sonderfall: „typisiert neu bauen" passt hier nicht 1:1

codeGenerator ist kein Runtime-Konsument, sondern ein Meta-Werkzeug: es generiert Quellcode (Prisma-Schema, DTOs, API, Routes, Views) aus Entity-Builder-Definitionen (EntityWithDetails/PropertyWithDetails als Template-Input — 27 von 29 Dateien sind Templates). Erreichbar nur über die Entity-Builder-Admin-UI (admin/entities/code-generator/**), die R-P6B-β löscht.

Konsequenz: Wenn der Entity-Builder stirbt, hat der Generator keinen Input mehr (es gibt keine generischen Entity-Definitionen, aus denen er generiert). „Typisiert neu bauen" hieße, ein Werkzeug zu bauen, das typisierten Code aus typisiertem Code generiert — das ergibt keinen Produktnutzen. Deshalb ist die realistische Entscheidung Cut, nicht Rebuild.

Disposition-Optionen

  1. Cut mit β (empfohlen): modules/codeGenerator + admin/entities/code-generator/**-Routen werden zusammen mit dem Entity-Builder in R-P6B-β entfernt. Hier kein eigener Bau — nur als „gehört zu β" markieren. Kein separater Teil-2-Aufwand.
  2. Jetzt schon entfernen: Falls nachweislich 0 produktive Nutzung (interne Boilerplate-Devtool), kann es vorgezogen gelöscht werden (grep-Beweis 0 externe Konsumenten nötig, analog R-P14C S6). Spart β etwas Arbeit.
  3. Rebuild (nicht empfohlen): Nur falls eine neue, explizit freigegebene Produktanforderung „Code-Gen aus typisierten Modellen" entsteht; im aktuellen Scope gibt es sie nicht.

Definition of Done (bei Option 1 — Cut mit β) ✅ GEWÄHLT & ERLEDIGT

  • In R-P6B-β-Scope aufgenommen: modules/codeGenerator (29 Dateien) + admin/entities/code-generator/** (Teil des gelöschten admin/entities/**-Baums) mit dem Entity-Builder entfernt.
  • Keine eigene Migration nötig; in R-P14C-T2-Übersicht als „→ β" vermerkt.

Umsetzung

  • 2026-06-30 (autonomer Lauf, Branch feat/R-P6B-beta): CUT mit β umgesetzt. modules/codeGenerator (29 Dateien) gelöscht; die admin/entities/code-generator/**-Routen fielen mit dem admin/entities/**-Baum. Ohne Entity-Builder-Definitionen hat das Meta-Werkzeug keinen Input mehr. Cross-Refs nachgezogen. Teil von R-P6B-β; voller CI-Scope grün.

Definition of Done (bei Option 2 — jetzt entfernen)

  • grep-Beweis: 0 Konsumenten von modules/codeGenerator außerhalb der EB-Admin-Routen.
  • modules/codeGenerator + admin/entities/code-generator/** gelöscht; rows-entities-runtime.json (listet codeGenerator) + code-generator-i18n.test.ts + Cross-Refs nachgezogen.
  • Voller CI-Scope grün.

Offene Entscheidungen (vor Bau klären)

  1. Cut (β oder jetzt) vs. Rebuild — Produktentscheidung Raffael. Empfehlung: Cut mit β (Option 1) — geringster Aufwand, kein Datenrisiko, passt zum Wegfall des Entity-Builders.
  2. Bei Option 2: ist codeGenerator wirklich rein intern (kein Kunden-Feature)?

Quellen

  • R-P14C-T2.md (Übersicht).
  • CodeGeneratorService.ts:1 (EntityWithDetails als Template-Input).
  • R-P6B.md §Inventar (modules/rows/EB-Kern → löschen) · AD-2.