Files
git.stella-ops.org/docs/features/checked/web/platform-setup-canonical-route-preservation-ui.md

3.2 KiB

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:
    • Start the local Angular test server with npm run serve:test.
    • Use a test session with setup and ops scopes.
  • Core verification:
    • Open /ops/platform-setup, click the Regions & Environments quick link, and verify the browser stays on /ops/platform-setup/regions-environments.
    • Open /ops/platform-setup/promotion-paths, /workflows-gates, and /gate-profiles directly and verify each page keeps its canonical ops URL.
    • 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