Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -6,7 +6,7 @@
| **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 |
| **Status** | Done |
## 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.*
@@ -37,7 +37,7 @@ Die **Hot-Swap-Maschine** (VM-Konvention + Action-Callback-Contract + Subframe-A
- 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, Milestones `M013-view-model-konvention`, `M014-action-callback-contract`, `M015-subframe-adapter-layer`, `M016-visual-regression-gate`, `M017-hot-swap-drill`
- `ROADMAP.md` → Phase 1 · Milestones:, Milestones `M013-view-model-konvention`, `M014-action-callback-contract`, `M015-subframe-adapter-layer`, `M016-visual-regression-gate`, `M017-hot-swap-drill`
- `REQUIREMENTS.md` → `REQ-integration-view-model-pflicht`, `REQ-integration-sidebar`, `REQ-integration-smoke-tests`
- `designer-briefs/P01-fundament-walking-skeleton.md` (Walking-Skeleton + App-Shell-Andock)
- `DESIGNER-FIRST-PLAYBOOK.md` → §1 Fundamente (Hot-Swap-Prinzip)
@@ -45,8 +45,8 @@ Die **Hot-Swap-Maschine** (VM-Konvention + Action-Callback-Contract + Subframe-A
## 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-P1c` aktualisiert (Owner→Raffael bestätigt)
- [ ] REQUIREMENTS/ROADMAP nachgezogen
- [x] Plane-Ticket `R-P1c` aktualisiert (Owner→Raffael bestätigt)
## Umsetzungsstand (Claude, 2026-06-17 — noch nicht final abgenommen)
@@ -67,14 +67,48 @@ VM-/Action-Callback-/Subframe-Adapter-Typen existieren in `@hivegrid/view-models
- **Smoke gegen ui-mock:** `apps/web/app/modules/walkingSkeleton/walkingSkeleton.hot-swap.test.ts` (VM als ui-mock-Drop-in via `generateMockArtifacts` — beweist Hot-Swap-Tauglichkeit). + e2e-Smoke `tests/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 in `de` + `en` (Parität, `verify:i18n` grü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.
**Nebenbei gefixt:** Ein damaliger Test-Isolations-Flake in den inzwischen entfernten
Boilerplate-Feature-Decision-Verifiern wurde behoben; die volle Suite lief danach stabil grün.
**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).
## Abschluss-Notiz (2026-07-09, Raffael)
**DoD-Stand:** 5/5 DoD = 100 % done.
**Proof:** Hot-Swap, UI-Mock, Visual-Gate, PWA-Manifest und Walking-Skeleton sind laut Umsetzungsnotiz gebaut, getestet und auf Staging verifiziert. Dieses Ticket ist screen-frei; spätere Subframe-Verfeinerung ist kein Done-Blocker.
**Plane:** Ticket `HIVEGRID-32` auf `Done` verschoben.
## Bugfix-Notiz (2026-07-22, lokales Quick-Fix-Paket)
Die Browser-Favicons hatten zwar einen RGBA-Kanal, waren aber vollständig opak und enthielten einen
weißen Hintergrund. Die Größen 16, 32 und 96 Pixel sowie `favicon.ico` wurden deshalb direkt aus dem
kanonischen HiveGrid-SVG neu mit echtem transparentem Hintergrund gerendert. Core und Kundenportal
referenzieren die transparenten Browser-Favicons mit einem neuen Cache-Key; der konfigurierbare
`brandingFavicon`-Override bleibt unverändert erhalten. Android-/Apple-/PWA-Installationsicons wurden
bewusst nicht verändert.
**Proof:** Eckpixel aller drei PNGs haben Alpha `0`; `favicon.ico` enthält drei RGBA-PNG-Einträge.
Fokussierte Tests 17/17 grün (`public-icons`, Portal-Boundary, Portal-Asset-Staging,
Web-Build-Surfaces), ESLint grün, `@hivegrid/web`-Typecheck grün.
**%-Done-Stand:** R-P1c bleibt bei **5/5 DoD = 100 % done**; dieser lokale Regression-Fix ändert den
abgenommenen Ticket-Scope nicht.
## Bugfix-Notiz (2026-07-22, lokales Quick-Fix-Paket 2: Seitentitel)
Core, Admin, öffentliche Routen und Kundenportal verwenden jetzt denselben zentralen Document-Title-
Vertrag. Vorhandene Route-Metadaten werden auf genau einen Titel normalisiert; Routen ohne eigenen
`meta`-Export verwenden ihren bereits vorhandenen Loader-Titel statt still den Eltern-Titel zu
übernehmen. Bekannte alte bzw. konfigurierte Produkt-Suffixe werden durch `HiveGrid` ersetzt, ohne
Pipes innerhalb dynamischer Seiten- oder Entitätsnamen abzuschneiden. Der Portal-Fallback lautet
explizit `Kundenportal | HiveGrid`; titelose Legacy-Routen erben weiterhin den nächstgelegenen
sinnvollen Seiten-/Bereichstitel, statt einen Slug als Klartext anzuzeigen.
**Proof:** fokussierte Title-Unit- und Router-Navigationstests 20/20 grün; vollständige Core-Suite
999 Testdateien grün (7138 Tests, 10 Dateien/55 Tests erwartungsgemäß übersprungen);
`@hivegrid/web`-Typecheck grün; fokussiertes ESLint grün.
**%-Done-Stand:** R-P1c bleibt bei **5/5 DoD = 100 % done**; der zentrale Head-Vertrag ist ein lokaler
Branding-Regressionsfix und öffnet das abgenommene Fundament-Ticket nicht erneut.