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

8.6 KiB

kind, project, area, recipient, status, stand, source_repo, source_branch, source_commit
kind project area recipient status stand source_repo source_branch source_commit
handover HiveGrid Screen Project Cloud UI / Subframe Nachzug David Info / Dev-Stand 2026-07-10 HiveGrid-Cloud origin/main + fix branch akeshan/fix-subframe-nested-sidebar 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.