Marketplace — events
Generated from the architecture model
This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.
Topics follow context.area.vN.event-name (ADR-0012 port, ADR-0014 envelope). The context segment is the producing bounded context's slug.
| Event |
Producer |
Topic |
Scope |
Consumers |
| PricingPlanChanged |
LicenseService |
licensing.pricing.v1.pricing-plan-changed |
integration |
3 |
| EntitlementGranted |
LicenseService |
licensing.entitlements.v1.entitlement-granted |
integration |
4 |
| EntitlementStateChanged |
LicenseService |
licensing.entitlements.v1.entitlement-state-changed |
integration |
4 |
| PublisherCertified |
LicenseService |
licensing.publishers.v1.publisher-certified |
integration |
3 |
| ListingPublished |
MarketplaceCatalogService |
marketplace.listings.v1.listing-published |
integration |
4 |
| ListingStateChanged |
MarketplaceCatalogService |
marketplace.listings.v1.listing-state-changed |
integration |
3 |
| ListingInstalled |
MarketplaceCatalogService |
marketplace.installations.v1.listing-installed |
integration |
4 |
| ListingRemoved |
MarketplaceCatalogService |
marketplace.installations.v1.listing-removed |
integration |
4 |
PricingPlanChanged
A pricing plan was set or changed.
|
|
| Producer |
LicenseService (BC-28 Marketplace Acquisition & Licensing) |
| Scope / version |
integration / v1 |
| Topic |
licensing.pricing.v1.pricing-plan-changed |
| Aggregate |
PricingPlan |
| Consumers |
MarketplaceCatalogService, StudioBff, AuditService |
| Field |
Type |
Required |
Description |
pricingId |
guid |
yes |
|
listingId |
guid |
yes |
|
model |
enum:PricingModel |
yes |
|
EntitlementGranted
A tenant is entitled to a listing.
|
|
| Producer |
LicenseService (BC-28 Marketplace Acquisition & Licensing) |
| Scope / version |
integration / v1 |
| Topic |
licensing.entitlements.v1.entitlement-granted |
| Aggregate |
Entitlement |
| Consumers |
MarketplaceCatalogService, FactoryCommercialService, StudioBff, AuditService |
| Field |
Type |
Required |
Description |
entitlementId |
guid |
yes |
|
tenantId |
string |
yes |
|
listingId |
guid |
yes |
|
subscriptionId |
guid |
yes |
|
validTo |
datetime |
no |
|
EntitlementStateChanged
Suspended, restored, expired or revoked.
|
|
| Producer |
LicenseService (BC-28 Marketplace Acquisition & Licensing) |
| Scope / version |
integration / v1 |
| Topic |
licensing.entitlements.v1.entitlement-state-changed |
| Aggregate |
Entitlement |
| Consumers |
MarketplaceCatalogService, AgentRegistryService, StudioBff, AuditService |
| Field |
Type |
Required |
Description |
entitlementId |
guid |
yes |
|
tenantId |
string |
yes |
|
listingId |
guid |
yes |
|
fromState |
enum:EntitlementState |
yes |
|
toState |
enum:EntitlementState |
yes |
|
PublisherCertified
A publisher was certified or suspended.
|
|
| Producer |
LicenseService (BC-28 Marketplace Acquisition & Licensing) |
| Scope / version |
integration / v1 |
| Topic |
licensing.publishers.v1.publisher-certified |
| Aggregate |
Publisher |
| Consumers |
MarketplaceCatalogService, StudioBff, AuditService |
| Field |
Type |
Required |
Description |
publisherId |
guid |
yes |
|
tenantId |
string |
yes |
|
state |
enum:PublisherState |
yes |
|
ListingPublished
A listing is Listed and visible.
|
|
| Producer |
MarketplaceCatalogService (BC-27 Marketplace Catalog & Distribution) |
| Scope / version |
integration / v1 |
| Topic |
marketplace.listings.v1.listing-published |
| Aggregate |
Listing |
| Consumers |
StudioBff, AuditService, AgentCardService, LicenseService |
| Field |
Type |
Required |
Description |
listingId |
guid |
yes |
|
tenantId |
string |
yes |
|
kind |
enum:ListingKind |
yes |
|
assetId |
string |
yes |
|
releaseId |
string |
yes |
|
visibility |
enum:Visibility |
yes |
|
ListingStateChanged
A listing changed state (suspended, delisted, re-listed).
|
|
| Producer |
MarketplaceCatalogService (BC-27 Marketplace Catalog & Distribution) |
| Scope / version |
integration / v1 |
| Topic |
marketplace.listings.v1.listing-state-changed |
| Aggregate |
Listing |
| Consumers |
StudioBff, AuditService, LicenseService |
| Field |
Type |
Required |
Description |
listingId |
guid |
yes |
|
tenantId |
string |
yes |
|
fromState |
enum:ListingState |
yes |
|
toState |
enum:ListingState |
yes |
|
reason |
string |
no |
|
ListingInstalled
A listing was installed or updated in a tenant.
|
|
| Producer |
MarketplaceCatalogService (BC-27 Marketplace Catalog & Distribution) |
| Scope / version |
integration / v1 |
| Topic |
marketplace.installations.v1.listing-installed |
| Aggregate |
Installation |
| Consumers |
AgentRegistryService, StudioBff, AuditService, LicenseService |
| Field |
Type |
Required |
Description |
installationId |
guid |
yes |
|
tenantId |
string |
yes |
|
projectId |
string |
no |
|
listingId |
guid |
yes |
|
releaseId |
string |
yes |
|
ListingRemoved
An installation was removed.
|
|
| Producer |
MarketplaceCatalogService (BC-27 Marketplace Catalog & Distribution) |
| Scope / version |
integration / v1 |
| Topic |
marketplace.installations.v1.listing-removed |
| Aggregate |
Installation |
| Consumers |
AgentRegistryService, StudioBff, AuditService, LicenseService |
| Field |
Type |
Required |
Description |
installationId |
guid |
yes |
|
tenantId |
string |
yes |
|
listingId |
guid |
yes |
|
Commands
| Command |
Service |
Handled by |
Result events |
Summary |
SetPricing |
LicenseService |
PricingPlan |
PricingPlanChanged |
|
AcquireListing |
LicenseService |
Entitlement |
EntitlementGranted |
|
CertifyPublisher |
LicenseService |
Publisher |
PublisherCertified |
|
ReviewListing |
LicenseService |
Publisher |
|
|
CreateListing |
MarketplaceCatalogService |
Listing |
|
|
SubmitListing |
MarketplaceCatalogService |
Listing |
ListingPublished |
|
InstallListing |
MarketplaceCatalogService |
Installation |
ListingInstalled |
|
RemoveInstallation |
MarketplaceCatalogService |
Installation |
ListingRemoved |
|
Consumed from other services
| Consumer |
Event |
Producer |
Handler |
Purpose |
| LicenseService |
SubscriptionChanged |
FactoryCommercialService |
FollowSubscription |
Suspend, restore or expire entitlements with the Factory subscription. |
| LicenseService |
ApprovalDecided |
RunControlService |
ApplySpendApproval |
Acquisitions above the spend threshold wait for approval. |
| LicenseService |
ListingStateChanged |
MarketplaceCatalogService |
FollowListing |
Delisted or suspended listings suspend or revoke entitlements. |
| LicenseService |
ListingPublished |
MarketplaceCatalogService |
TrackListing |
Pricing plans attach to Listed listings. |
| LicenseService |
ListingInstalled |
MarketplaceCatalogService |
CountSeats |
Seat consumption. |
| LicenseService |
ListingRemoved |
MarketplaceCatalogService |
ReleaseSeats |
Seat release. |
| MarketplaceCatalogService |
AssetReleasePublished |
AgentRegistryService |
OfferListingUpdate |
A newer Published release offers a listing update and installation updates. |
| MarketplaceCatalogService |
AssetReleaseDeprecated |
AgentRegistryService |
DelistOrFlag |
Deprecated releases delist; installations are flagged. |
| MarketplaceCatalogService |
AssetReleaseRevoked |
AgentRegistryService |
DelistAndNotify |
Revoked releases delist immediately and installations are notified. |
| MarketplaceCatalogService |
ApprovalDecided |
RunControlService |
ApplyListingApproval |
Public listing approvals. |
| MarketplaceCatalogService |
EntitlementGranted |
LicenseService |
ContinueInstallation |
An entitlement allows an installation to proceed. |