Marketplace — 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 marketplace lives in the Studio's Assets work area (browse, install, updates) and Governance & administration (publisher console, review queue, entitlements).
Screens¶
| Screen | Reads | Acts | Roles |
|---|---|---|---|
| Browse and search | SearchListings (compatibility with the caller's edition applied) |
filter by kind, publisher, rating | everyone |
| Listing detail | GetListing, GetPricing |
acquire; install into a project; review | Workspace admin (acquire, install), Asset maintainer (install), Requester (review) |
| My installations | ListInstallations |
accept updates; remove | Workspace admin, Asset maintainer |
| Entitlements | ListEntitlements |
see validity, seats, terms | Workspace admin, Observer |
| Publisher console | own listings and pricing | create, submit, set pricing, delist | Asset maintainer of a certified publisher |
| Review queue | listings InReview, publisher applications | approve (publication class), request changes, certify | Platform admin |
States the screens must show¶
- Listing: Draft, InReview, Listed, Suspended, Delisted, with visibility and the release it points to; the evidence badge from the evaluation record.
- Installation: Requested, EntitlementChecked, Installed, Updating, Removed, Failed (with the limiting entitlement or policy), and the update-available marker.
- Entitlement: Pending (with a spend approval card when above threshold), Active, Suspended, Expired, Revoked.
- Publisher: Applied, Certified, Suspended, Retired.
Other clients¶
- CLI:
factory marketplace search <text>,factory marketplace install <listing> --project P,factory marketplace entitlements,factory marketplace publish --release <id>.