DevOps / GitOps — UI surfaces¶
Target
This page describes intended behaviour or structure. No implementation is claimed unless a section is explicitly marked Current implementation or Evidence.
The platform's screens live in the Studio's Software Factory work area (delivery of generated products) with the approval step surfacing in Workspace like every other approval.
Screens¶
| Screen | Reads | Acts | Roles |
|---|---|---|---|
| Change proposals | ListChangeProposals, GetChangeProposal |
open the pull request in the system of record; see provenance (run, change set, agent) | Requester, Reviewer, Operator, Observer |
| Pipeline runs | ListPipelineRuns, GetPipelineRun |
open typed results and their artifacts; reconcile (Operator) | Requester, Reviewer, Operator, Observer |
| Releases | ListProductReleases, GetProductRelease |
create from a succeeded run; withdraw with reason; download SBOM and attestations | Operator, Workspace admin, Observer |
| Promotions | ListPromotions, GetPromotion, GetCurrentRelease |
request a promotion (strategy, environment); roll back | Operator, Workspace admin, Reviewer (approval), Observer |
| Environment board | GetCurrentRelease per environment of the project |
compare releases across environment classes | everyone in the project |
States the screens must show¶
- Proposal: Proposed, BranchCreated, PullRequestOpen, ChangesRequested, Approved, Merged, Abandoned, each with the system-of-record link.
- Pipeline run: Queued, Running, Succeeded, Failed, Cancelled, PartiallySucceeded; results per kind with pass or fail and a link to the artifact.
- Release: Assembling, Candidate (with the unpublished components named), Released, Superseded, Withdrawn.
- Promotion: Requested, GatesEvaluating (gate by gate), AwaitingApproval (with the approval card: exact release, environment, expiry; FUX-02), Approved, Deploying, Verifying (window countdown), Completed, Failed, RolledBack, Rejected (with the failing gate).
Other clients¶
- CLI:
factory delivery proposals list,factory delivery runs show <id>,factory delivery releases create --run <id> --version <v>,factory delivery promote <release> --env <id>,factory delivery rollback <promotionId>. - VS Code extension: proposal status in the source-control view for Factory-authored branches; pipeline results inline on the pull request.