Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -49,7 +49,7 @@ Screen-Bau lesen**.
|
||||
```
|
||||
apps/web/app/components/screens/<domain>/<Screen>Page.tsx
|
||||
└─ export function <Screen>Page({ vm, actions }: { vm: <Screen>VM; actions: <Screen>Actions }) { … }
|
||||
komponiert ~/ui-Components + DefaultPageLayout, rendert vm.data, ruft actions.onX
|
||||
komponiert ~/ui-Components als app-chrome-freien Content, rendert vm.data, ruft actions.onX
|
||||
```
|
||||
|
||||
Die Route bleibt beim etablierten Muster und rendert nur:
|
||||
@@ -65,6 +65,55 @@ export default function XRoute() {
|
||||
Das ist genau das AGENTS.md-Zielmuster `<XPage vm={} actions={} />` — die Interim-UI füllt die heute
|
||||
fehlende „mittlere Komposition" zwischen VM und `~/ui`-Primitives.
|
||||
|
||||
### App-Shell-Grenze: keine rekursive Subframe-Sidebar
|
||||
|
||||
Die HiveGrid-App-Routes laufen bereits innerhalb der echten App-Shell mit Sidebar, Tenant-Layout und
|
||||
Navigation. Deshalb dürfen Screen-Komponenten unter `apps/web/app/components/screens/**` **keine**
|
||||
generierten Subframe-Page-Layouts rendern, die selbst App-Chrome enthalten, insbesondere nicht
|
||||
`~/ui/layouts/DefaultPageLayout`. Dieses Layout bringt eine eigene Beispiel-Sidebar inklusive Logo/Nav mit
|
||||
und erzeugt sonst eine doppelte Sidebar in der App. Erlaubt sind app-chrome-freie Content-Shells aus `div`/
|
||||
`section` plus `~/ui`-Komponenten. `DialogLayout` und `DrawerLayout` bleiben für echte Modale/Drawer erlaubt,
|
||||
wenn sie nicht zusätzlich App-Navigation rendern.
|
||||
|
||||
### Scroll-Verhalten: Dokumentfluss statt Subframe-Inner-Scroll
|
||||
|
||||
Subframe-Page-Exporte kommen mit einem eigenen Scroll-Gerüst: Screen-Root
|
||||
`h-full min-h-[0px] … overflow-hidden` plus Inhaltsbereich `grow shrink-0 basis-0 … overflow-y-auto`.
|
||||
Das funktioniert nur, wenn der Screen eine definite Höhe vom Parent erbt. Die `SubframeAppShell` rendert
|
||||
Screens aber in ein block-level `<main class="flex-1 overflow-auto">` — dort kollabiert der
|
||||
`basis-0`-Bereich auf **0px** und der komplette Inhalt ist unsichtbar (im DOM vorhanden, Höhe 0; so
|
||||
geschehen bei WF-P16 S00/S02 und den Automations-Übersichten, 2026-07-10). Beim Integrieren deshalb
|
||||
**beide Klassen-Sets entfernen** und den Screen im normalen Dokumentfluss rendern — das Scrollen
|
||||
übernimmt die `<main>` der Shell (wie bei allen anderen App-Screens). Der Guard-Test
|
||||
`apps/web/app/components/screens/subframe-layout-boundary.test.ts` schlägt bei dem Muster statisch fehl.
|
||||
|
||||
### Lokales UI-Kit ≠ Cloud-Export: bekannte Prop-Abweichungen
|
||||
|
||||
Der Subframe-Cloud-Export nutzt teils andere Prop-APIs als das lokale Kit unter `apps/web/app/ui`.
|
||||
Bei Unsicherheit die Komponente lesen. Real getroffen (Stand 2026-07-13):
|
||||
- `SearchInput`: flache Props (`value`/`onChange`/`placeholder` direkt), KEIN `<SearchInput.Input>`-Child.
|
||||
- `Table.Cell`: kennt nur `align-left`/`align-center`; rechtsbündig = Default + `justify-end`-Div.
|
||||
- `BadgeFeedback`: Farb-Prop heißt `farbe`.
|
||||
- `BadgeShortcut`: Props heißen `icon`/`iconRight` (Default-Icon ⌘), NICHT `iconLeft1`/`iconLeft2` aus dem Export; ⇧-Kombos als Text-Children (z. B. `⇧Z`).
|
||||
- `HelpCircle`: hat KEIN `tooltipText` — Tooltip via `SubframeCore.Tooltip.Root/Trigger/Portal/Content asChild` + `~/ui`-`Tooltip` als Content (Muster: `select-tenant.component.tsx`).
|
||||
- Radix `SubframeCore.ContextMenu.Content`: akzeptiert KEIN `side`/`align` (Kontextmenüs positionieren am Pointer) — die Props aus dem Export entfernen, nur `asChild` behalten.
|
||||
|
||||
### Component-Sync: nie blind `sync --all` übernehmen (real getroffen 2026-07-18)
|
||||
|
||||
`pnpm subframe:sync` (`@subframe/cli sync --all`) schreibt den **kompletten** Cloud-Stand nach
|
||||
`apps/web/app/ui` — inklusive **Löschungen**: lokale Komponenten ohne Cloud-Pendant
|
||||
(`ConfirmDialog`, `ResultDialog`, `layers.ts`, …) und sogar colocated **Testdateien**
|
||||
(`Dialog.layering.test.tsx`) flogen raus; parallel kamen umbenannte Duplikate (`DialogFullscreen`
|
||||
neben `FullscreenDialog`) rein. Vorgehen:
|
||||
1. Sync laufen lassen, dann `git status` sichten und **nur die für das Ticket nötigen Komponenten
|
||||
behalten** (Rest per `git stash`/`checkout` zurück — der volle Stand bleibt im Stash als Referenz).
|
||||
2. Synchronisierte Komponenten auf **Breaking-API** prüfen (2026-07-18: `KanbanCard` wechselte von
|
||||
`name`/`price`/`topRow` auf Slot-Props `tagsSlot`/`titleSlot`/`valueSlot`/`footer*Slot`) und ALLE
|
||||
Konsumenten im selben PR migrieren — auch fremde Module (LeadBoard), Abhängige müssen grün bleiben.
|
||||
3. Wrapper wie `SortableKanbanBoard` forwarden neue Props **nicht** automatisch — Interface + Forwarding
|
||||
nachziehen, sonst greifen neue Defaults still (2026-07-18: `showSum=false` zeigte überall
|
||||
„Summe gesperrt" statt der Spaltensumme).
|
||||
|
||||
### Layer-Regeln bleiben unangetastet
|
||||
Die drei Anti-Patterns (AGENTS.md) gelten weiter:
|
||||
- kein `@prisma/client`/`~/db` in `packages/ui-app/**`;
|
||||
@@ -137,6 +186,8 @@ Done setzen weiterhin nur **mit expliziter Freigabe** und nach dem Abschluss-Aud
|
||||
|
||||
- [ ] Interim-`<XPage>` in `apps/web/app/components/screens/<domain>/` aus `~/ui` + Layout, VM als Prop.
|
||||
- [ ] Route rendert `<XPage vm={} actions={} />`; kein handgeschriebenes Tailwind.
|
||||
- [ ] Keine rekursive App-Shell: Screen-Komponenten importieren nicht `~/ui/layouts/DefaultPageLayout` und rendern keine zusätzliche Sidebar/Header-Navigation.
|
||||
- [ ] Kein Subframe-Inner-Scroll: `h-full`/`overflow-hidden`-Root und `basis-0`/`overflow-y-auto`-Inhaltsbereich aus dem Page-Export entfernt — Screen läuft im Dokumentfluss, die Shell-`<main>` scrollt (siehe §„Scroll-Verhalten").
|
||||
- [ ] **Davids Design-Standards befolgt** (`.planning/INTERIM-UI-DESIGN-STANDARDS.md`): Spacing/Padding/
|
||||
Dialog-Struktur/Control-Höhen/States aus `~/ui`-Defaults; Screen-IDs/Naming an Davids Tracker angelehnt.
|
||||
- [ ] Reachability B 6–10 verdrahtet (Sidebar/Permission/Route/Breadcrumb/i18n).
|
||||
@@ -164,3 +215,102 @@ Refactor-Nachzug offen: finale Subframe-Optik aus `D-<XXX>` (Plane-Label `design
|
||||
umgekehrt. Divergiert Plane vom Doc, gewinnt das Doc.
|
||||
- Es gibt **kein** Skript, das Plane-Kommentare postet. Kommentar/Status weiter manuell via API
|
||||
(`POST /issues/{iid}/comments/`, Identität vorab `GET users/me`); Done nur mit Freigabe.
|
||||
|
||||
## Footgun: FK-Constraints auf Tabellen unter `FORCE ROW LEVEL SECURITY`
|
||||
|
||||
**Symptom.** Eine Migration, die eine Foreign Key Constraint anlegt, bricht ab mit
|
||||
`ERROR: query would be affected by row-level security policy for table "<X>"` —
|
||||
obwohl der Migrator der Tabellen-Owner ist.
|
||||
|
||||
**Ursache.** Seit dem App-weiten RLS-Cutover tragen die Tabellen `FORCE ROW LEVEL
|
||||
SECURITY`, und `FORCE` gilt **auch für den Owner**. Postgres validiert eine neue
|
||||
FK-Constraint mit einem internen `SELECT` über die betroffenen Tabellen, und
|
||||
genau dieses `SELECT` wird von der Policy abgelehnt. Es trifft **beide** Seiten:
|
||||
die Tabelle, die die Constraint bekommt, **und** die referenzierte Tabelle.
|
||||
|
||||
**Fix.** `FORCE` für die Dauer der Constraint-Erzeugung abschalten und sofort
|
||||
wieder setzen. Die Policy selbst bleibt die ganze Zeit **aktiviert**, und im
|
||||
Fenster steht kein DML — es ist also kein Sicherheitsloch:
|
||||
|
||||
```sql
|
||||
ALTER TABLE "Pipeline" NO FORCE ROW LEVEL SECURITY;
|
||||
ALTER TABLE "Pipeline" ADD CONSTRAINT "…_fkey" FOREIGN KEY (…) REFERENCES "Pipeline"("id") …;
|
||||
ALTER TABLE "PipelineFieldGroup" ADD CONSTRAINT "…_fkey" FOREIGN KEY (…) REFERENCES "Pipeline"("id") …;
|
||||
ALTER TABLE "Pipeline" FORCE ROW LEVEL SECURITY;
|
||||
```
|
||||
|
||||
**Merke.** Mehrere FKs auf dieselbe Zieltabelle in **ein** Fenster packen, statt
|
||||
`FORCE` mehrfach zu togglen. Neu angelegte Tabellen sind nicht betroffen,
|
||||
solange ihre Policies erst am Ende der Migration gesetzt werden — das ist ein
|
||||
weiterer Grund, den RLS-Block ans Ende des Migrationsfiles zu stellen.
|
||||
|
||||
**Gefunden:** 2026-07-28, WF-P8-Baseline (`20260728120000_wf_p8_subframe_baseline`).
|
||||
Der Fehler erscheint erst bei `verify:migrations-parity` bzw. beim Replay gegen
|
||||
eine leere DB, **nicht** beim lokalen `prisma db push` — der Feature-Branch-Pfad
|
||||
verschleiert ihn also.
|
||||
|
||||
## Footgun: eine neue Relation kann die Policy-Form einer bestehenden Tabelle kippen
|
||||
|
||||
**Symptom.** `verify:rls-live` meldet gegen die frische Migrationskette
|
||||
`rls_expected_policy_mismatch` **und** `rls_unexpected_policy`, obwohl
|
||||
`verify:tenant-policy-contract --check` grün ist und die Migration für jede neue
|
||||
Tabelle brav eine Policy anlegt.
|
||||
|
||||
**Ursache.** Der Generator entscheidet die **Form** der Policies aus dem Modell:
|
||||
eine Tabelle mit direktem `tenantId` bekommt **eine** `FOR ALL`-Policy
|
||||
(`hg_<T>_all`), eine Tabelle mit abgeleiteter Ownership bekommt **vier**
|
||||
Per-Command-Policies (`_select`/`_insert`/`_update`/`_delete`). Fügt man einer
|
||||
**bestehenden** Tabelle eine Relation hinzu, kann sie dadurch zum
|
||||
Derived-Ownership-Modell werden und ihre Policy-Form wechseln. Bei WF-P8 hat
|
||||
genau das die Selbstrelation `Pipeline.nachfolgePipelineId` ausgelöst:
|
||||
`hg_Pipeline_all` → vier Policies.
|
||||
|
||||
**Fix.** Die Policy-DDL **nie von Hand schreiben**, sondern wörtlich aus
|
||||
`prisma/rls/tenant-policy-contract-isolation.sql` in die Migration kopieren —
|
||||
inklusive der Tabellen, die man gar nicht angefasst zu haben glaubt. Die alte
|
||||
Policy muss dabei explizit gedroppt werden:
|
||||
|
||||
```sql
|
||||
DROP POLICY IF EXISTS "hg_Pipeline_all" ON "Pipeline";
|
||||
-- danach die vier generierten Per-Command-Policies
|
||||
```
|
||||
|
||||
**Merke.** Postgres verknüpft permissive Policies mit **ODER**. Eine
|
||||
stehengebliebene alte Policy hebt die neue also nicht auf, sondern hält den
|
||||
schwächeren Ausdruck daneben am Leben — ein stiller Sicherheitsverlust, den
|
||||
kein Test bemerkt, der nur „Zeile sichtbar?" prüft. Ein `git diff` gegen
|
||||
`packages/db/src/rls-runtime-contract.generated.ts` zeigt nach jeder
|
||||
Schema-Änderung sofort, welche Tabellen ihre Policy-Form gewechselt haben.
|
||||
|
||||
**Gefunden:** 2026-07-28, WF-P8-Baseline. Sichtbar nur in `verify:rls-live`,
|
||||
`Database Checks` und `Docker Smoke` — lokal auf `RLS_RUNTIME_MODE=off` nicht.
|
||||
|
||||
## Footgun: `~/ui`-Felder in einer umbrechenden Flex-Zeile
|
||||
|
||||
**Symptom.** Mehrere Eingabefelder nebeneinander rendern kaputt: jedes Feld
|
||||
steht auf einer eigenen, sehr hohen Zeile, das Label klebt weit über dem Input
|
||||
und kollidiert mit dem nächsten Feld. Im DOM ist die Reihenfolge korrekt — es
|
||||
ist rein Layout.
|
||||
|
||||
**Ursache.** Die Roots von `~/ui`-`TextInput`/`Select` tragen selbst
|
||||
`h-full w-full … justify-center`. Als Flex-Kind beansprucht ein solches Feld
|
||||
damit die **ganze** Zeile (eine `flex-wrap`-Zeile bricht also nach jedem Feld
|
||||
um) und dehnt sich zusätzlich auf die Zeilenhöhe, wobei `justify-center` den
|
||||
Input in der Mitte dieser Höhe parkt.
|
||||
|
||||
**Fix.** Die Zeile als **Grid** auslegen, dann füllt jedes Feld seine Spur:
|
||||
|
||||
```tsx
|
||||
<div className="grid w-full items-end gap-3 sm:grid-cols-2">
|
||||
<TextInput className="w-full" … />
|
||||
<TextInput className="w-full" … />
|
||||
</div>
|
||||
```
|
||||
|
||||
**Merke.** `className="grow"` hilft **nicht** — es überschreibt das `w-full` des
|
||||
Feldes nicht. Eine nicht umbrechende `flex`-Zeile ist dagegen unkritisch, weil
|
||||
die Felder dort schlicht schrumpfen. Guard:
|
||||
`apps/web/app/components/screens/subframe-layout-boundary.test.ts`.
|
||||
|
||||
**Gefunden:** 2026-07-29, WF-P8 „Termin erstellen" (S02-T) und S05
|
||||
„Neue Feldgruppe". Nur im Browser sichtbar, nicht im Unit-Test.
|
||||
Reference in new issue
Block a user