03 Quellen und Referenzen/HiveGrid Cloud UI Handover 2026-07-10.md

@@ -0,0 +1,156 @@
+---
+kind: handover
+project: HiveGrid Screen Project
+area: Cloud UI / Subframe Nachzug
+recipient: David
+status: Info / Dev-Stand
+stand: 2026-07-10
+source_repo: HiveGrid-Cloud
+source_branch: origin/main + fix branch akeshan/fix-subframe-nested-sidebar
+source_commit: c6f96f2be + sidebar fix dab70bcf6
+---
+
+# HiveGrid Cloud UI Handover 2026-07-10
+
+Kurzfassung: Der Subframe-UI-Nachzug aus dem letzten Dev-PR ist jetzt in `origin/main` von HiveGrid-Cloud gemerged. Der Code nutzt weiterhin die bestehenden Loader, Actions und View-Models; getauscht wurde vor allem die mittlere Screen-Komposition auf `~/ui`-/Subframe-nahe Page-Komponenten. Für David wichtig: D-FORM ist im Vault bereits ein echter Subframe-Review-Draft, P8/P9/P12 sind validierte Screen-Pakete mit Canvas, aber noch ohne Subframe-Links.
+
+Update 2026-07-10: In den neuen Dev-Pages war die generierte Subframe-App-Shell teilweise rekursiv eingebunden. Dadurch erschien die HiveGrid-Sidebar doppelt. Der Fix liegt in HiveGrid-Cloud auf `akeshan/fix-subframe-nested-sidebar`, Commit `dab70bcf6`: `FormsAdminPage` und `AutomationPages` rendern nur noch app-chrome-freien Content und importieren nicht mehr `~/ui/layouts/DefaultPageLayout`.
+
+## 1. Code-Stand HiveGrid-Cloud
+
+Quelle:
+
+- Branch: `origin/main`
+- Merge-Commit: `c6f96f2be` - `Integrate Subframe UI follow-ups`
+- Enthaltene Commits:
+  - `8f0ca8a10` - `Integrate Subframe UI follow-ups`
+  - `31d1c8cba` - `Fix forms admin i18n test source`
+
+### Neu integrierte UI-Flächen
+
+| Bereich | Route | Code-Komponente | Stand |
+|---|---|---|---|
+| Formulare verwalten | `/forms` | `apps/web/app/components/screens/forms/FormsAdminPage.tsx` | Subframe-nahe Umsetzung nach D-FORM `S00 Formulare verwalten` |
+| Automationen Liste | `/automations` | `apps/web/app/components/screens/automation/AutomationPages.tsx` / `AutomationListPage` | Subframe-nahe Management-Fläche |
+| Automations-Läufe | `/automations/:id/executions` | `AutomationExecutionsPage` | Subframe-nahe Lauf-Liste |
+| Automations-Laufdetail | `/automations/:id/executions/:executionId` | `AutomationExecutionDetailPage` | Subframe-nahe Timeline-/Detail-Fläche |
+| Automations-Vorlagen | `/automations/templates` | `AutomationTemplatesPage` | Subframe-nahe Vorlagen-Katalog-Fläche |
+
+### Sidebar-Bugfix / App-Shell-Grenze
+
+- Ursache: `~/ui/layouts/DefaultPageLayout` ist ein generiertes Subframe-Page-Layout mit eigener Beispiel-Sidebar, Header-Navigation und App-Chrome.
+- Fehlerbild: Diese Layout-Shell wurde innerhalb der echten HiveGrid-App-Shell gerendert, dadurch doppelte Sidebar mit HiveGrid-Logo/Nav.
+- Fix: `FormsAdminPage` und `AutomationPages` verwenden keine `DefaultPageLayout`-Wrapper mehr, sondern nur noch Content-Flächen innerhalb der bestehenden Route-Shell.
+- Regression: In HiveGrid-Cloud gibt es dafür den Test `apps/web/app/components/screens/subframe-layout-boundary.test.ts`.
+- Lesson für weitere Designs: Subframe-Page-Layouts mit Sidebar/Header nicht direkt in `apps/web/app/components/screens/**` übernehmen. Nur app-chrome-freien Page-Content übernehmen; Dialog-/Drawer-Layouts bleiben für echte Modale/Drawer ok.
+
+### Was im Code bewusst unverändert blieb
+
+- Loader, Actions, Permissions, Owner-Filter und bestehende View-Models bleiben in den Routes/Services.
+- Forms-Create, SHK-Template-Seeding, Toggle/Delete und Embed-Snippet bleiben funktional gleich.
+- Automations-VMs aus `automation.server.ts` bleiben gleich; die Route rendert nur neue Page-Komponenten.
+- Der echte Graph-/Node-Editor unter `/automations/:id/edit` ist noch nicht ersetzt. Das bleibt D-FLOW-Nachzug.
+
+### Validierung
+
+- `pnpm --filter @hivegrid/web typecheck` war grün.
+- `pnpm lint` war grün.
+- `pnpm run verify:i18n` war grün.
+- Nach dem PR-Fail wurde der Test `apps/web/app/routes/app.$tenant/forms.$id.i18n.test.ts` angepasst und gezielt grün ausgeführt.
+- Für den Sidebar-Fix kam `apps/web/app/components/screens/subframe-layout-boundary.test.ts` dazu.
+
+## 2. Dev-Docs und Ticket-Status
+
+### AK-P16c / D-FORM
+
+- Ticket-Doc markiert: `subframe-ui: teilweise integriert`.
+- Integriert ist nur die Forms-Verwaltung `/forms`, angelehnt an D-FORM `S00`.
+- Noch offen für späteren vollständigen D-FORM-Nachzug:
+  - `S01` Formularart auswählen.
+  - `S02` einfacher Fragen-Editor.
+  - `S02L` Lead-Feldzuweisung.
+  - `E05` Lead-Zuweisung prüfen.
+  - `S03` Design.
+  - `S04` Public Form.
+  - `V01` bis `V03` Public States.
+  - `S05` Antworten-Tabelle.
+  - Advanced-/Referenzframes, falls David sie später als echte Power-User-Fläche will.
+
+### R-P12a / D-P12
+
+- Ticket-Doc markiert: `subframe-ui: teilweise integriert`.
+- Integriert sind:
+  - Automation-Liste.
+  - Lauf-Liste.
+  - Lauf-Detail mit Timeline-Rahmen.
+  - Vorlagen-Katalog.
+- Noch offen:
+  - Loop-/Rate-Warnmodal-Feinschnitt.
+  - Vollständige visuelle Endabnahme gegen D-P12.
+
+### R-P12b / D-FLOW
+
+- Ticket-Doc markiert: `subframe-ui: teilweise integriert`.
+- Integriert sind nur Template-Katalog und Execution-Detail-Rahmen, soweit sie P12-Verwaltungsflächen betreffen.
+- Noch offen und blockierend für echte Flow-Builder-UX:
+  - `/automations/:id/edit`
+  - Graph-Canvas.
+  - Node-Katalog links.
+  - Konfig-Panel rechts.
+  - Dry-Run-Modal.
+  - Schleifen-/Raten-Warnmodal.
+  - Start-Auswahl-Modal.
+
+## 3. Wireframes-Repo Stand
+
+### D-FORM
+
+Status: `Review / Subframe Draft`
+
+- Paket: `02 Wireframes/D-FORM Formulare/WF-D-FORM Form Builder/`
+- Handoff: `Tickets/Fertige Tickets/D-FORM Form Builder.md`
+- Subframe Flow: `WF-D-FORM Form Builder`
+- Hauptentscheidung: `S02 Einfacher Fragen Editor` ist die empfohlene Google-Forms-nahe Hauptvariante für Handwerksbetriebe.
+- Advanced-Canvas und `D07` bis `D09` bleiben Referenz, nicht Hauptfluss.
+- Lead-Zuweisung ist nach Davids Feedback ergänzt: `S02L` plus `E05`.
+
+### P8 Pipelines
+
+Status: `Validiert`, Subframe noch offen.
+
+- Paket: `02 Wireframes/P8 Pipelines/WF-P8 Pipelines/`
+- Kern: Kanban-Boards sind Views auf Projekte.
+- Wichtige Entscheidung: Edit-Mode betrifft nur die Projekt-Detailansicht, nicht das Kartenlayout.
+- Davids Delta: Gewonnen-Moment regelbasiert über Spaltenregel, ohne Regel mit Board-Wechsel-Dialog.
+
+### P9 Auftrag
+
+Status: `Validiert`, Subframe noch offen.
+
+- Projekt-Akte: Auftrags-Reiter, Mobil-Modus, Rechnung anlegen, Abnahme-/Projekt-Vorlagen.
+- Plantafel: Desktop-Raster, Monteur-Modus, Konflikt-Dialog, Einsatz-Dialog.
+- Abnahme: mehrstufiger Mobile-Workflow Prüfungen -> Mängel -> Zusammenfassung/Unterschriften, danach immutable.
+
+### P12 Automationen
+
+Status: `Validiert`, Subframe noch offen.
+
+- `WF-P12 Verwaltung`: Liste, Lauf-Liste, Lauf-Detail, Vorlagen-Katalog, Baustein-Konfig-Panels.
+- `WF-P12 Flow-Editor`: schwerste UI, Langläufer, Katalog links / Canvas Mitte / Konfig rechts.
+- Wichtig für Dev: Die aktuell im Code integrierten P12-Flächen decken Verwaltung ab, nicht den echten Flow-Editor.
+
+## 4. Was David sich konkret ansehen sollte
+
+1. D-FORM `S00 Formulare verwalten` gegen die aktuelle `/forms`-Umsetzung prüfen.
+2. D-FORM `S02`, `S02L`, `E05`, `S04`, `S05` priorisieren, wenn der vollständige Forms-Nachzug weitergehen soll.
+3. P12 Verwaltung prüfen, weil die Dev-UI dafür schon teilweise nachgezogen ist.
+4. D-FLOW separat als großes Designpaket behandeln. Der Code hat hier noch keinen echten Subframe-Swap.
+5. P8/P9 weiterhin als validierte Planung betrachten; dort fehlen noch Subframe-Designs.
+
+## 5. Kurztext zum Mitschicken
+
+Hey David, kurzer UI-Stand aus HiveGrid-Cloud: Der Subframe-UI-Nachzug ist in `origin/main` gemerged. Neu im Code sind `/forms` als `FormsAdminPage` nach D-FORM `S00` sowie die P12-Verwaltungsflächen `/automations`, Läufe, Laufdetail und Templates über `AutomationPages`. Die bestehenden Loader/Actions/VMs wurden nicht umgebaut, es ist primär ein Screen-Kompositionsswap auf `~/ui`/Subframe-nahe Komponenten.
+
+Für dich wichtig: D-FORM ist im Wireframes-Repo jetzt als Review-Draft mit echten Subframe-Links vorhanden. Im Code ist davon bisher nur `S00 Formulare verwalten` übernommen. Der komplette Builder, Public Form, Public States und Antworten-Tabelle sind noch offen. P12 Verwaltung ist im Code teilweise nachgezogen, aber D-FLOW, also der echte Flow-/Node-Editor, bleibt offen und sollte separat behandelt werden. P8/P9/P12 sind im Vault validiert und mit Canvas geplant, aber bis auf D-FORM noch ohne Subframe-Links.
+
+Nachtrag: Wir haben direkt danach einen kritischen Layout-Bug gefunden. Bitte bei Subframe-Handoffs beachten: `DefaultPageLayout` aus Subframe darf nicht als kompletter Wrapper in HiveGrid-App-Routes landen, weil HiveGrid bereits eine eigene Sidebar/App-Shell hat. Der Dev-Fix entfernt diese rekursive Shell aus `/forms` und den P12-Verwaltungsseiten. Für künftige Übergaben bitte nur den app-chrome-freien Content bzw. echte Dialog-/Drawer-Flächen übernehmen.

03 Quellen und Referenzen/README.md

@@ -10,6 +10,7 @@ Hier liegt Kontext, der fuer Wireframe- und UX-Planung gelesen werden kann, aber
 |---|---|
 | `hivegrid-cloud/` | mitgepushte HiveGrid-Cloud-Referenz inklusive Planning, Ticket-Docs und Code-Kontext |
 | [[Repo Notizen]] | Hinweise zum Aktualisieren und Nutzen der HiveGrid-Cloud-Referenz |
+| [[HiveGrid Cloud UI Handover 2026-07-10]] | aktueller Dev-/UI-Nachzug aus HiveGrid-Cloud fuer David |
 
 ## Regel