Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P14E.md
T
2026-07-08 16:15:37 +02:00

5.1 KiB
Raw Blame History

R-P14E · formulas vom Entity-Builder typisiert ablösen

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 M (Audit-Schätzung ~3–4 Wochen; Risiko: 0 Unit-Tests im Modul)
Status ENTSCHIEDEN: CUT mit β (Raffael 2026-06-30) — kein typisierter Rebuild; formulas wird mit dem Entity-Builder in R-P6B-β entfernt.

Abhängigkeiten & Parallelität

  • blocked-by: R-P14C-T2 Quer-Entscheidung + typisierte Modell-Registry (geteilt mit R-P14D).
  • blocks: R-P6B-β.
  • eng gekoppelt an: die Entity-Builder-UI — formulas wird heute aus admin/entities/** + app.$tenant/settings/entities/** gerendert (Property-Config einer Entity). Diese Routen löscht β. ⇒ Klärungsbedarf: Bleiben Formeln als Feature der typisierten Modelle (berechnete Felder auf Kontakt/Projekt) erhalten, oder sterben sie mit der Entity-Builder-UI? (siehe §Offene Entscheidungen).

Was wir bauen

FormulaService evaluiert heute Formeln über die generische Entity-Struktur: lädt getAllEntities(), iteriert EntityWithDetails/PropertyWithDetails, liest Werte aus RowWithDetails via RowHelper.getPropertyValue(...). FormulaRowService zieht Komponenten-Inputs ebenso. FormulaVariableValueDto typt die Variablen auf EntityWithDetails/RowWithDetails.

Ziel (sofern Formeln v1-Feature bleiben, §Offene Entscheidungen): Evaluation auf typisierte Modelle umstellen — Formel-Variablen referenzieren typisierte Felder (über die Modell-Registry-fieldSchema), Werte werden direkt aus typisierten Prisma-Records gelesen statt aus RowValue-Zeilen.

Benötigte Screens

Abhängig von der Disposition: Wenn Formeln als „berechnete Felder" auf typisierten Modellen bleiben, braucht es eine Stelle, sie zu konfigurieren (heute Teil der EB-Property-UI, die β entfernt). Davids Delta klären — evtl. eigener kleiner Formel-Editor je Modell, oder Cut.

Definition of Done

Disposition CUT mit β (Raffael 2026-06-30): Kein typisierter Rebuild. Die typisierten DoD-Punkte unten sind damit gegenstandslos (n/a) — relevant ist nur der Cut-Punkt.

  • [n/a] FormulaService + FormulaRowService auf typisierte Modelle/Registry — Cut, kein Rebuild.
  • [n/a] FormulaVariableValueDto auf typisierte Feld-Referenzen — Cut.
  • [n/a] Unit-Tests neu für die Evaluation — Cut.
  • [n/a] Klartext-Fehler bei unbekanntem Feld/Modell — Cut.
  • [n/a] Formel-Route-Tests angepasst — Routen mit β gelöscht.
  • AD-2: keine Entity-Builder-Importe im Modul — Modul ist entfernt.
  • CUT: apps/web/app/modules/formulas/** + die zugehörigen admin/entities/formulas*-Routen (Teil des gelöschten admin/entities/**-Baums) sauber entfernt; Permissions admin.formulas.* aus allen 4 Registries + i18n nachgezogen; Konsumenten/Tests grün. Voller CI-Scope grün.

Umsetzung

  • 2026-06-30 (autonomer Lauf, Branch feat/R-P6B-beta): CUT mit β umgesetzt. modules/formulas (14 Dateien) gelöscht; die admin/entities/formulas*-Routen fielen mit dem admin/entities/**-Baum; Formula/FormulaComponent/FormulaLog-Modelle mit entityBuilder.prisma entfernt; admin.formulas.*-Default-Permissions aus DefaultPermissions.ts + roleDisplay.ts + permissions-seed.server.ts + translations.json (de+en) entfernt. Kein typisierter Rebuild (Formeln sind keine v1-Entität im ENTITY-MODEL; reine Entity-Builder-Funktion). Falls „berechnete Felder" auf typisierten Modellen später gewünscht sind → neues Ticket. Teil von R-P6B-β; voller CI-Scope grün.

Technische Bausteine

  • Modell-Registry fieldSchema (aus T2) liefert typisierte Feld-Metadaten je Modell — ersetzt PropertyWithDetails + RowHelper.getPropertyValue.
  • Wert-Zugriff: statt RowHelper.getPropertyValue({entity,item,property}) → direkter typisierter Feldzugriff (record[field]) mit Typ-Coercion über das fieldSchema.
  • FormulaLog (falls vorhanden, prisma/schema): prüfen, ob an Row/Property gebunden; ggf. auf typisierte Referenzen umstellen oder belassen.
  • Querschnitt: M001-Audit, M002-Klartext, M004-Tenant-Scope.

Offene Entscheidungen (vor Bau klären)

  1. Bleiben Formeln v1? Formeln sind heute eine Entity-Builder-Funktion (berechnete Properties auf generischen Entities). Wenn der Entity-Builder stirbt (β) und es keine „berechneten Felder" auf typisierten Modellen geben soll → Cut (mit β löschen), kein Rebuild. Wenn doch → Rebuild als berechnete Felder auf adressierbaren Modellen. Das ist die Kern-Produktfrage dieses Tickets.
  2. Welche Modelle dürfen berechnete Felder haben (= Quer-Entscheidung T2).
  3. Persistenz: Werden Formel-Ergebnisse gespeichert (heute FormulaLog/RowValue) oder on-read berechnet?

Quellen

  • R-P14C-T2.md (Übersicht + Quer-Entscheidung + Registry).
  • FormulaService.ts, FormulaRowService.ts, FormulaVariableValueDto.ts (Bestand).
  • R-P6B.md §Rückwirkungs-Audit (formulas kritisch).
  • docs/ARCHITECTURE-DECISIONS.md AD-2 · .planning/ENTITY-MODEL.md.