feat(ui): preserve platform setup canonical routes
This commit is contained in:
master
@@ -0,0 +1,55 @@
|
||||
# Platform Setup Canonical Route Preservation UI
|
||||
|
||||
## Module
|
||||
Web
|
||||
|
||||
## Status
|
||||
VERIFIED
|
||||
|
||||
## Description
|
||||
Shipped the `Ops > Platform Setup` follow-up that preserves canonical `/ops/platform-setup/*` URLs for the platform setup leaf pages. The shared setup/topology cutover remains intact, but direct entry and in-product navigation no longer rewrite those canonical ops URLs into `/setup/topology/*`.
|
||||
|
||||
## Implementation Details
|
||||
- **Feature directories**:
|
||||
- `src/Web/StellaOps.Web/src/app/features/platform/setup/`
|
||||
- `src/Web.StellaOps.Web/src/app/routes/`
|
||||
- **Primary components**:
|
||||
- `platform-setup-home` (`src/Web.StellaOps.Web/src/app/features/platform/setup/platform-setup-home.component.ts`)
|
||||
- `platform-setup-regions-environments-page` (`src/Web.StellaOps.Web/src/app/features/platform/setup/platform-setup-regions-environments-page.component.ts`)
|
||||
- `platform-setup-promotion-paths-page` (`src/Web.StellaOps.Web/src/app/features/platform/setup/platform-setup-promotion-paths-page.component.ts`)
|
||||
- `platform-setup-workflows-gates-page` (`src/Web.StellaOps.Web/src/app/features/platform/setup/platform-setup-workflows-gates-page.component.ts`)
|
||||
- `platform-setup-gate-profiles-page` (`src/Web.StellaOps.Web/src/app/features/platform/setup/platform-setup-gate-profiles-page.component.ts`)
|
||||
- **Preserved canonical routes**:
|
||||
- `/ops/platform-setup`
|
||||
- `/ops/platform-setup/regions-environments`
|
||||
- `/ops/platform-setup/promotion-paths`
|
||||
- `/ops/platform-setup/workflows-gates`
|
||||
- `/ops/platform-setup/gate-profiles`
|
||||
- **Shared setup routes still used for explicit drill-ins**:
|
||||
- `/setup/topology/environments`
|
||||
- `/setup/topology/promotion-graph`
|
||||
- `/setup/topology/workflows`
|
||||
- `/setup/trust-signing`
|
||||
|
||||
## E2E Test Plan
|
||||
- **Setup**:
|
||||
- [x] Start the local Angular test server with `npm run serve:test`.
|
||||
- [x] Use a test session with setup and ops scopes.
|
||||
- **Core verification**:
|
||||
- [x] Open `/ops/platform-setup`, click the `Regions & Environments` quick link, and verify the browser stays on `/ops/platform-setup/regions-environments`.
|
||||
- [x] Open `/ops/platform-setup/promotion-paths`, `/workflows-gates`, and `/gate-profiles` directly and verify each page keeps its canonical ops URL.
|
||||
- [x] Re-run the topology/trust cutover browser flow and verify the platform-setup handoff uses the preserved canonical leaf instead of rewriting into setup/topology.
|
||||
|
||||
## Verification
|
||||
- Run:
|
||||
- `npm run test -- --watch=false --include src/tests/platform/platform-setup-routes.spec.ts --include src/tests/platform/platform-setup-canonical-links.spec.ts --include src/tests/setup/setup-topology-trust-cutover.spec.ts --include src/tests/topology/topology-routes.spec.ts`
|
||||
- `npx playwright test --config playwright.config.ts tests/e2e/platform-setup-canonical-route-preservation.spec.ts tests/e2e/topology-trust-admin-cutover.spec.ts --workers=1`
|
||||
- `npm run build`
|
||||
- Tier 0 (source): pass
|
||||
- Tier 1 (build/tests): pass
|
||||
- Tier 2 (behavior): pass
|
||||
- Notes:
|
||||
- Angular targeted tests passed: `4` files, `19` tests.
|
||||
- Playwright passed: `2` canonical platform-setup scenarios.
|
||||
- Production build passed; existing bundle-budget warnings remain unchanged from the baseline.
|
||||
- Verified on (UTC): 2026-03-08T09:07:27Z
|
||||
@@ -9,6 +9,8 @@ VERIFIED
|
||||
## Description
|
||||
Shipped the canonical `Setup > Topology` and `Setup > Trust & Signing` cutover so operators land on mounted setup shells instead of stale `settings`, `administration`, `admin`, or `platform/setup` routes. The topology shell now exposes the preserved setup pages directly, and the trust workspace replaces the live placeholder settings page.
|
||||
|
||||
Follow-up note: canonical `Ops > Platform Setup` leaf URLs are preserved by `docs/features/checked/web/platform-setup-canonical-route-preservation-ui.md`; the shared setup cutover no longer rewrites those canonical ops URLs into `setup/topology/*`.
|
||||
|
||||
## Implementation Details
|
||||
- **Feature directories**:
|
||||
- `src/Web/StellaOps.Web/src/app/features/topology/`
|
||||
@@ -49,7 +51,7 @@ Shipped the canonical `Setup > Topology` and `Setup > Trust & Signing` cutover s
|
||||
- [x] Open `/settings/trust` and verify redirect into the canonical trust shell.
|
||||
- [x] Open the `Trusted Issuers` tab and verify issuer data renders.
|
||||
- [x] Open `/admin/trust` and verify bookmark compatibility into the same trust shell.
|
||||
- [x] Open `/ops/platform-setup`, use the setup quick-link handoff, and verify navigation into canonical topology routes.
|
||||
- [x] Open `/ops/platform-setup`, use the setup quick-link handoff, and verify the preserved canonical platform-setup leaf renders.
|
||||
|
||||
## Verification
|
||||
- Run:
|
||||
|
||||
@@ -1,78 +0,0 @@
|
||||
# Sprint 20260308-007 - FE Platform Setup Canonical Route Preservation
|
||||
|
||||
## Topic & Scope
|
||||
- Preserve the canonical `ops/platform-setup/*` route family while the setup/topology cutover continues, so bookmarked and linked operator flows do not silently rewrite into `setup/topology/*`.
|
||||
- Keep the work limited to Web route ownership, canonical alias preservation, and Playwright/Angular verification for the affected platform-setup and setup-topology surfaces.
|
||||
- Use the old broad Web QA loop only as upstream evidence; do not continue to treat that generic loop as the active place for setup/topology route work.
|
||||
- Working directory: `src/Web/StellaOps.Web`.
|
||||
- Expected evidence: focused Angular route tests, Playwright canonical-route retest slices, and sprint execution log updates.
|
||||
|
||||
## Dependencies & Concurrency
|
||||
- Upstream evidence came from [SPRINT_20260306_003_FE_playwright_setup_reset_iteration_loop.md](C:/dev/New%20folder/git.stella-ops.org/docs-archived/implplan/SPRINT_20260306_003_FE_playwright_setup_reset_iteration_loop.md), which closed after handing off this remaining non-search defect.
|
||||
- Overlapping active ownership exists in `platform-setup.routes.ts`, `platform-setup-home.component.ts`, `topology-shell.component.ts`, and related route specs; changes must stay tightly scoped to canonical route preservation.
|
||||
- Safe parallelism:
|
||||
- Playwright triage and route-spec updates can proceed without touching component markup.
|
||||
- URL-preservation fixes should prefer route-tree aliasing over broad topology-shell rewrites.
|
||||
|
||||
## Documentation Prerequisites
|
||||
- `docs/qa/feature-checks/FLOW.md`
|
||||
- `docs/code-of-conduct/TESTING_PRACTICES.md`
|
||||
- `docs/code-of-conduct/CODE_OF_CONDUCT.md`
|
||||
- `docs/modules/ui/architecture.md`
|
||||
- `src/Web/StellaOps.Web/AGENTS.md`
|
||||
|
||||
## Delivery Tracker
|
||||
|
||||
### FE-PLATFORMSETUP-001 - Reproduce and bound the canonical rewrite defect
|
||||
Status: TODO
|
||||
Dependency: none
|
||||
Owners: QA, Developer (FE)
|
||||
Task description:
|
||||
- Reproduce the currently failing `ops/platform-setup` canonical routes in Playwright and map exactly which leaves rewrite to `setup/topology/*` or other non-canonical locations.
|
||||
- Keep the evidence concrete: original URL, landed URL, expected canonical URL preservation, and the route/component boundary responsible.
|
||||
|
||||
Completion criteria:
|
||||
- [ ] A bounded list exists for the affected `ops/platform-setup/*` canonical routes.
|
||||
- [ ] Each affected route includes real Playwright evidence showing the original and landed URLs.
|
||||
- [ ] The owning route tree and overlapping files are documented before any fix is applied.
|
||||
|
||||
### FE-PLATFORMSETUP-002 - Preserve canonical platform-setup URLs in the Web router
|
||||
Status: TODO
|
||||
Dependency: FE-PLATFORMSETUP-001
|
||||
Owners: Developer (FE)
|
||||
Task description:
|
||||
- Repair the affected platform-setup routes so canonical `ops/platform-setup/*` URLs keep rendering the intended platform-setup/topology surfaces without rewriting the browser address to `setup/topology/*`.
|
||||
- Prefer route aliasing or shared leaf mounting that keeps operator bookmarks stable and does not fork the actual feature behavior.
|
||||
|
||||
Completion criteria:
|
||||
- [ ] `ops/platform-setup/*` leaves remain on their requested canonical URLs.
|
||||
- [ ] The rendered content matches the intended platform-setup/topology surface for each repaired leaf.
|
||||
- [ ] The fix does not regress the existing `setup/topology/*` routes.
|
||||
|
||||
### FE-PLATFORMSETUP-003 - Add focused regression coverage and retest
|
||||
Status: TODO
|
||||
Dependency: FE-PLATFORMSETUP-002
|
||||
Owners: Test Automation, QA
|
||||
Task description:
|
||||
- Add or update Angular route coverage and Playwright canonical-route coverage for the repaired platform-setup leaves.
|
||||
- Re-run the affected slice of `prealpha-canonical-full-sweep.spec.ts` and record the exact passing commands.
|
||||
|
||||
Completion criteria:
|
||||
- [ ] Focused Angular route tests cover the preserved canonical aliases.
|
||||
- [ ] Focused Playwright coverage passes for the repaired `ops/platform-setup/*` routes.
|
||||
- [ ] The sprint log records the exact retest commands and outcomes.
|
||||
|
||||
## Execution Log
|
||||
| Date (UTC) | Update | Owner |
|
||||
| --- | --- | --- |
|
||||
| 2026-03-08 | Sprint created after the refreshed broad Playwright canonical sweep proved the remaining open defect was no longer search/policy related: `ops/platform-setup/regions-environments` rewrote to `setup/topology/regions`, leaving canonical URL preservation broken during the setup/topology cutover. | Developer |
|
||||
|
||||
## Decisions & Risks
|
||||
- Decision: treat this as a dedicated setup/topology canonical-route sprint, not a continuation of the search-adjacent QA loop.
|
||||
- Decision: canonical URLs must stay stable for operator bookmarks and routed entry points even when the rendered feature surface is shared with setup/topology.
|
||||
- Risk: overlapping ownership already exists in active setup/topology files.
|
||||
- Mitigation: keep fixes narrowly focused on route preservation, add targeted route tests, and avoid broad shell/navigation churn.
|
||||
|
||||
## Next Checkpoints
|
||||
- 2026-03-08: reproduce the full `ops/platform-setup/*` drift set with Playwright and bound the affected leaves.
|
||||
- 2026-03-08: land the first route-preservation fix with focused Angular + Playwright evidence.
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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`
|
||||
@@ -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`
|
||||
|
||||
Reference in New Issue
Block a user