diff --git a/03 Quellen und Referenzen/HiveGrid Cloud UI Handover 2026-07-10.md b/03 Quellen und Referenzen/HiveGrid Cloud UI Handover 2026-07-10.md new file mode 100644 index 00000000..b22cff72 --- /dev/null +++ b/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. diff --git a/03 Quellen und Referenzen/README.md b/03 Quellen und Referenzen/README.md index 8b0f76db..91422ff3 100644 --- a/03 Quellen und Referenzen/README.md +++ b/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