feat(ui): preserve platform setup canonical routes

This commit is contained in:
master
2026-03-08 11:12:42 +02:00
parent d0f2cc3b2c
commit 6870649abf
19 changed files with 478 additions and 42 deletions

View File

@@ -9,6 +9,8 @@
The Console presents operator dashboards for scans, policies, VEX evidence, runtime posture, and admin workflows.
## Latest updates (2026-03-08)
- Preserved canonical `Ops > Platform Setup` leaf URLs so `regions-environments`, `promotion-paths`, `workflows-gates`, and `gate-profiles` no longer rewrite into `Setup > Topology` on direct entry or quick-link navigation.
- Added checked-feature verification for canonical platform-setup route preservation at `../../features/checked/web/platform-setup-canonical-route-preservation-ui.md`.
- Shipped the `Mission Control`, `Security`, and `Ops > Operations` security-leaves cutover, including canonical surfacing for alerts, activity, unknowns, and notifications plus repaired `/analyze/unknowns*` and `/notify` ownership.
- Added checked-feature verification for the security operations leaves cutover at `../../features/checked/web/security-operations-leaves-ui.md`.
- Shipped the canonical `Setup > Topology` and `Setup > Trust & Signing` cutover, including repaired legacy trust bookmarks, fixed `Platform Setup` handoffs, and expanded topology shell exposure.
@@ -86,6 +88,7 @@ The Console presents operator dashboards for scans, policies, VEX evidence, runt
- ./execution-operations/README.md
- ./topology-trust-administration/README.md
- ./security-operations-leaves/README.md
- ./platform-setup-canonical-route-preservation/README.md
- ./triage-explainability-workspace/README.md
- ./workflow-visualization-replay/README.md
- ./contextual-actions-patterns/README.md

View File

@@ -108,6 +108,9 @@
- [DONE] FE-SOL-002 Surface the leaves from the live shells
- [DONE] FE-SOL-003 Repair leaf-local workflow links and actions
- [DONE] FE-SOL-004 Verify cutover, sync docs, and archive
- [DONE] FE-PLATFORMSETUP-001 Reproduce and bound the canonical rewrite defect
- [DONE] FE-PLATFORMSETUP-002 Preserve canonical platform-setup URLs in the Web router
- [DONE] FE-PLATFORMSETUP-003 Add focused regression coverage and retest
- [DONE] FE-PO-001 Freeze Operations overview taxonomy and submenu structure
- [DONE] FE-PO-002 Overview page regrouping and blocking-card contract
- [DONE] FE-PO-003 Legacy widget absorption matrix for Platform Ops

View File

@@ -33,6 +33,7 @@ Provide a living plan for UI deliverables, dependencies, and evidence.
- `docs/features/checked/web/execution-operations-ui.md` - shipped verification note for canonical execution routes, repaired jobengine and scheduler aliases, completed dead-letter actions, and usable scanner-support workflows.
- `docs/features/checked/web/topology-trust-administration-ui.md` - shipped verification note for canonical topology and trust setup shells, repaired settings/admin/platform aliases, and platform-setup handoffs.
- `docs/features/checked/web/security-operations-leaves-ui.md` - shipped verification note for mission alerts/activity surfacing, unknowns route repair, notifications ownership, and legacy security alias cutover.
- `docs/features/checked/web/platform-setup-canonical-route-preservation-ui.md` - shipped verification note for preserved `/ops/platform-setup/*` URLs during the shared setup/topology cutover.
- `docs/modules/ui/reachability-witnessing/README.md` - detailed witness and proof UX dossier plus cross-shell deep-link contract.
- `docs/modules/ui/platform-ops-consolidation/README.md` - detailed Operations overview taxonomy and legacy absorption plan.
- `docs/modules/ui/offline-operations/README.md` - detailed owner-shell contract for Offline Kit, Feeds & Airgap, Evidence handoffs, and stale alias policy.
@@ -40,6 +41,7 @@ Provide a living plan for UI deliverables, dependencies, and evidence.
- `docs/modules/ui/execution-operations/README.md` - canonical execution owner-shell contract for JobEngine, Scheduler, Dead-Letter, and companion Scanner Ops workflows.
- `docs/modules/ui/topology-trust-administration/README.md` - canonical setup owner contract for topology inventory, trust administration, legacy trust redirects, and platform-setup handoffs.
- `docs/modules/ui/security-operations-leaves/README.md` - canonical owner contract for mission alerts/activity, security unknowns, notifications, and stale `/analyze`/`/notify` handoffs.
- `docs/modules/ui/platform-setup-canonical-route-preservation/README.md` - preserved route contract for canonical `/ops/platform-setup/*` leaves during the shared setup/topology cutover.
- `docs/modules/ui/triage-explainability-workspace/README.md` - detailed artifact workspace and audit-bundle UX dossier.
- `docs/modules/ui/workflow-visualization-replay/README.md` - detailed run-detail graph, timeline, replay, and evidence UX dossier.
- `docs/modules/ui/contextual-actions-patterns/README.md` - shared placement contract for stray actions, pages, drawers, and tabs.

View File

@@ -0,0 +1,46 @@
# Platform Setup Canonical Route Preservation
## Purpose
- Keep `/ops/platform-setup/*` as a stable canonical route family while the shared setup/topology cutover continues.
- Preserve bookmarked operator entry points without forking the actual setup behavior into a second product shell.
## Canonical Owner
- Owner shell:
- `Ops > Platform Setup`
- Preserved canonical leaf routes:
- `/ops/platform-setup`
- `/ops/platform-setup/regions-environments`
- `/ops/platform-setup/promotion-paths`
- `/ops/platform-setup/workflows-gates`
- `/ops/platform-setup/gate-profiles`
- `/ops/platform-setup/release-templates`
- `/ops/platform-setup/policy-bindings`
- `/ops/platform-setup/defaults-guardrails`
- Shared setup/trust destinations still owned elsewhere:
- `/setup/topology/*`
- `/setup/trust-signing`
## Route Contract
- `ops/platform-setup/*` must render their intended platform-setup pages without rewriting the browser URL to `setup/topology/*`.
- Explicit drill-ins into the broader topology product may still link to `/setup/topology/*` when the destination has no canonical `ops/platform-setup` equivalent.
- `trust-signing` stays a redirect into `Setup > Trust & Signing`; it is not owned by `Platform Setup`.
## Preserved Value
- Keep:
- stable operator bookmarks for legacy platform-setup leaves
- the lighter platform-setup summaries for regions, promotion paths, workflows, and gate profiles
- a clear distinction between the `Ops > Platform Setup` handoff shell and the broader `Setup > Topology` workspace
- Why:
- these leaves are still referenced from live setup and ops surfaces
- the defect was URL drift, not missing product value
## Shipped In This Cut
- Replaced redirect-only platform-setup topology leaves with mounted canonical pages.
- Updated Platform Setup home quick links to stay on `/ops/platform-setup/*`.
- Repaired stale page-local `/platform/setup/*` and `/topology/*` links to either canonical platform-setup leaves or valid setup/topology drill-ins.
- Added focused Angular and Playwright regression coverage for preserved canonical URLs.
## Related Docs
- `docs/features/checked/web/platform-setup-canonical-route-preservation-ui.md`
- `docs/features/checked/web/topology-trust-administration-ui.md`
- `docs/modules/ui/topology-trust-administration/README.md`

View File

@@ -75,11 +75,13 @@
- Canonical setup alias helpers for trust and platform-setup handoffs.
- Top-level `/admin/*` compatibility redirects for trust and notification bookmarks.
- Expanded `Topology` shell tabs so preserved mounted pages are reachable from the live setup shell.
- Fixed `Platform Setup` quick links so they hand off into canonical `Setup` routes.
- Preserved canonical `/ops/platform-setup/*` leaf URLs while keeping explicit topology drill-ins under `Setup > Topology`.
- Retired live trust-placeholder ownership in favor of the real `Trust Management` shell.
## Related Docs
- `docs/features/checked/web/topology-trust-administration-ui.md`
- `docs/features/checked/web/platform-setup-canonical-route-preservation-ui.md`
- `docs/modules/ui/watchlist-operations/README.md`
- `docs/modules/ui/platform-ops-consolidation/README.md`
- `docs/modules/ui/platform-setup-canonical-route-preservation/README.md`
- `docs/modules/ui/component-preservation-map/RESTORATION_PRIORITIES.md`