52 lines
2.4 KiB
Markdown
52 lines
2.4 KiB
Markdown
# 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`
|