7.2 KiB
R-P1c · P1 Hot-Swap-Maschine + Walking-Skeleton + PWA
| Typ | Dev (Code) |
| Owner | Raffael (NEU — übernommen von Akeshan; ex-AK-P1c, Umverteilung 16.06.) |
| Phase | P1 — Fundament & Walking-Skeleton |
| Cycle/Fenster | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| Status | geplant |
Abhängigkeiten & Parallelität
- Blocked by:
R-P1a(URL-Schemata/Contracts),R-P1b(Service-Kerne +tenantHasModule()-Muster) — abweichend vom AK-P1c-Snapshot („blocked-by: —"), da R-P1c das Konnektor-Gate + die VM-Konvention erst andocken kann, wenn R-P1a/b stehen; P1 läuft Raffael sequentiell. - Blocks: alle Screen-Andock-Tickets, Gate W1 (Walking-Skeleton = grüner Smoke-Test-Anker)
- Läuft parallel zu:
D-D0a/D-D0b(David Archetypen-Baseline, gleiche W1) — baut direkt darauf auf;AK-INFRA1/2(Ops). - Konflikt-Risiko: keines — Konvention/Adapter/Beispielroute, kein Fach-Schema. db push auf Branch (AD-21).
Was wir bauen
Die Hot-Swap-Maschine (VM-Konvention + Action-Callback-Contract + Subframe-Adapter, damit Davids Subframe-Designs ohne Logik-Bruch in die App geswapt werden können), das Visual-Regression-Gate + den Hot-Swap-Drill (grüner Smoke-Test gegen packages/ui-mock) und die Walking-Skeleton-Route: eine in der Sidebar registrierte Beispielroute, die das View-Model-im-Loader-Muster + das Konnektor-Gating (tenantHasModule()) exemplarisch zeigt. Dazu das PWA-Manifest (PWA-only v1, AD-17/Cut #14 — kein Expo/native).
Benötigte Screens (Backend bedient — Design liefert D-D0a/D-D0b)
| Screen [Route] | Kern-Inhalt | Liefert (Design) |
|---|---|---|
| App-Shell-Andock [global] | Sidebar mit Konnektor-Gating-Zustand (aktiv/ausgeblendet/gesperrt je tenantHasModule()), Topbar, Status-Banner-System |
D-D0a (A1) |
| Walking-Skeleton-Route [Beispiel-Modul-Route] | minimal aus A2 komponiert; Loader gibt View-Model zurück, Konnektor-Gate exemplarisch, grüner Smoke-Test | D-D0b (A2 minimal) |
Definition of Done
- VM-Konvention (View-Model im Loader) + Action-Callback-Contract + Subframe-Adapter stehen
packages/ui-mock+ Visual-Regression-Gate + Hot-Swap-Drill (grün)- Walking-Skeleton-Route in Sidebar registriert, Konnektor-Gate
tenantHasModule()exemplarisch angewandt - PWA-Manifest (installierbar; PWA-only v1, AD-17 — kein native/Store)
- Smoke-Test grün gegen
ui-mock
Technische Bausteine
- Keine Fach-Entities — nutzt das
tenantHasModule()-Muster aus R-P1b und die Contracts aus R-P1a. - Subframe-Adapter = Brücke Davids Subframe-Output → App-Komponenten (Hot-Swap ohne Logik-Umschrieb); VM-Konvention macht Loader testbar gegen
ui-mock. - Sidebar-Registrierung demonstriert die drei Konnektor-Zustände (aktiv/ausgeblendet/gesperrt).
- PWA-Manifest minimal (Installierbarkeit) — voller PWA-Ausbau (Service-Worker/Offline/Push) → v2 (
VA-P27a/b).
Quellen (granular)
ROADMAP.md→ Phase 1 ·PHASE-SOURCES.md→ Phase 1, MilestonesM013-view-model-konvention,M014-action-callback-contract,M015-subframe-adapter-layer,M016-visual-regression-gate,M017-hot-swap-drillREQUIREMENTS.md→REQ-integration-view-model-pflicht,REQ-integration-sidebar,REQ-integration-smoke-testsdesigner-briefs/P01-fundament-walking-skeleton.md(Walking-Skeleton + App-Shell-Andock)DESIGNER-FIRST-PLAYBOOK.md→ §1 Fundamente (Hot-Swap-Prinzip)docs/ARCHITECTURE-DECISIONS.md→ AD-17 (PWA-only)
Dev-Nachzug (nach Davids D-D0a/D-D0b-Delta)
- Subframe-Adapter/Skeleton an Davids App-Shell- + Archetypen-Output angepasst
- REQUIREMENTS/PHASE-SOURCES nachgezogen
- Plane-Ticket
R-P1caktualisiert (Owner→Raffael bestätigt)
Umsetzungsstand (Claude, 2026-06-17 — noch nicht final abgenommen)
Branch
p1-fundament-rp1abc. Den finalen DoD-Abhaken/Done macht Raffael. Designer-first: die finale Optik folgt DavidsD-D0a/D-D0b-Delta (Dev-Nachzug oben); R-P1c liefert das Muster (dünne Ende-zu-Ende-Scheibe), nicht das polierte UI.
Ausgangslage: Hot-Swap-Maschine + ui-mock + Visual-Regression-Gate lagen schon vor und sind grün
(pnpm run test:hot-swap → „UI hot-swap drill verified", pnpm run verify:ui-visual → 7 passed).
VM-/Action-Callback-/Subframe-Adapter-Typen existieren in @toolctrl/view-models + defineAdapter in @toolctrl/ui-app.
Neu gebaut:
- VM-Konvention exemplarisch (M013):
packages/view-models/src/walking-skeleton/walking-skeleton.vm.ts— reinebuildWalkingSkeletonVM(),*.vm.ts,VMState, nur i18n-Keys (kein Klartext). + Tests. - Konnektor→Sidebar-3-Zustände:
apps/web/app/utils/connector/connectorNavState.ts(resolveConnectorNavState→active/locked/hidden) + Tests für alle drei. - Walking-Skeleton-Route:
apps/web/app/routes/app.$tenant/walking-skeleton.tsx— Loader baut das VM im Loader und wendet das Konnektor-Pflicht-GatetenantHasModule()(aus R-P1b) exemplarisch an; Component rendert minimal je Zustand (data-ui-id="ui.walkingSkeleton.page",data-connector-state). + Loader-/Component-Tests. - Sidebar-Registrierung:
AppSidebar.tsx-Eintrag, gegated überresolveConnectorNavStateauf Basis der productAccess-Entscheidung;appData.tswertet das Demo-Modulwalking-skeletonmit aus. Für reale Tenantsblueprint-disabled→ Zustand hidden (kein Clutter), bis das Modul bewusst einem Blueprint zugeordnet wird. - PWA-Manifest:
apps/web/public/manifest.webmanifestvon „Toolctrl Boilerplate" auf HiveGrid umgebrandet (lang: de), installierbar (PWA-only v1, AD-17). - Smoke gegen ui-mock:
apps/web/app/modules/walkingSkeleton/walkingSkeleton.hot-swap.test.ts(VM als ui-mock-Drop-in viagenerateMockArtifacts— beweist Hot-Swap-Tauglichkeit). + e2e-Smoketests/e2e/walking-skeleton.spec.ts(Login→Route→Seite, skippt ohne E2E-Creds; läuft im CI/Staging-e2e-Job, lokal kein Playwright-Server). - i18n:
walkingSkeleton.*-Keys inde+en(Parität,verify:i18ngrün).
Nebenbei gefixt — Test-Isolations-Flake (Suite verlässlich grün): Die zusätzlichen Test-Dateien
kippten die Parallelität über eine Schwelle, die einen latenten Race exponierte:
verify-email-marketing- und verify-kb-widgets-workflow-marketing-decision-report.test.mjs
mutierten die geteilte docs/feature-manifests/plugin-candidates.json in-place (von Geschwister-
Verifiern gelesen → cross-file Race). Beide auf das bereits bewährte Temp-Fixture-Muster von
verify-portals-sites-decision-report.test.mjs umgestellt (Verifier-Root via process.argv[2],
Mutation nur in node_modules/.tmp). Der neue isolierte Test deckte zudem auf, dass ein früher
abgebrochener Lauf die echte plugin-candidates.json dirty hinterlassen hatte → aus git
wiederhergestellt. Danach 2× grün + Datei bleibt sauber.
Proof: view-models + web Typecheck grün · test:hot-swap + verify:ui-visual grün · verify:i18n grün · ESLint grün · neue Tests grün · volle Suite 3698 grün (Flake behoben, s.o.) · Commit c2a31a2b nach main, auf Staging deployt (Deploy-Run, revision live + healthcheck 200). Finaler P1-Stand inkl. Spalten-Drop = fe428e1b (Deploy-Details siehe R-P1a.md §Staging-Deploy).