stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
e4779a430fea066ba068e0bc7d2d49a50a6d8cff
git.stella-ops.org/docs/modules/ui/release-promotions-cutover/README.md
master e4779a430f feat(ui): ship release promotions cutover
2026-03-08 11:54:57 +02:00

2.4 KiB
Raw Blame History

Release Promotions Cutover

Purpose

  • Make Releases own the promotion workflow instead of splitting it across stale queue aliases, orphaned promotion routes, and approval-only entry points.
  • Keep approvals as the adjudication surface, but move promotion list, create, and detail flows under one canonical subtree.

Canonical Routes

  • /releases/promotions
  • /releases/promotions/create
  • /releases/promotions/:promotionId

Alias Policy

  • Preserve legacy /release-control/promotions, /release-control/promotions/create, and /release-control/promotions/:promotionId bookmarks.
  • Preserve stale /releases/promotion-queue, /releases/promotion-queue/create, and /releases/promotion-queue/:promotionId bookmarks.
  • Redirect aliases into the canonical /releases/promotions* subtree while preserving query params and fragments.

Shell Surfacing

  • Releases sidebar now exposes separate Approvals and Promotions entries.
  • Releases > Overview links to canonical Promotions.
  • The active release workbench launches the promotion wizard directly instead of trapping the operator in a non-executable promote tab.

Release-Context Handoff

  • The release workbench opens /releases/promotions/create with:
    • releaseId
    • returnTo
  • The promotion wizard treats this as a first-class release-context launch:
    • preloads environments for the supplied release
    • advances directly to target selection once release identity is known
    • keeps a return path back to the originating release or run context
    • deep-links into Decisioning Studio with a return path back to the canonical promotion wizard

Merge Notes From Dropped Surfaces

  • The dormant PromotionRequestComponent was not revived as a second page.
  • Its worthwhile behavior was merged into the canonical wizard:
    • contextual return-to handling
    • decisioning preview handoff
    • release-context launch semantics

Verification

  • Angular tests cover:
    • canonical promotions route ownership
    • legacy alias redirects
    • promotion wizard release-context hydration
    • release workbench handoff into the canonical wizard
  • Playwright covers:
    • overview surfacing of the canonical promotions page
    • legacy create alias redirect plus end-to-end promotion request submission

Related

  • docs/features/checked/web/release-promotions-cutover-ui.md
  • docs/modules/ui/component-preservation-map/RESTORATION_PRIORITIES.md