Skip to content

Product Fleet Operations — 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
IncidentOpened FleetIncidentService fleet-operations.incidents.v1.incident-opened integration 5
IncidentStateChanged FleetIncidentService fleet-operations.incidents.v1.incident-state-changed integration 3
IncidentResolved FleetIncidentService fleet-operations.incidents.v1.incident-resolved integration 4
OnCallChanged FleetIncidentService fleet-operations.on-call.v1.on-call-changed integration 2
OffboardingRequested FleetIncidentService fleet-operations.offboarding.v1.offboarding-requested integration 3
OffboardingCompleted FleetIncidentService fleet-operations.offboarding.v1.offboarding-completed integration 4
ProductOnboarded FleetInventoryService fleet-inventory.products.v1.product-onboarded integration 4
ProductInstanceStateChanged FleetInventoryService fleet-inventory.products.v1.product-instance-state-changed integration 4
ProductObjectiveDefined FleetInventoryService fleet-inventory.objectives.v1.product-objective-defined integration 3
RolloutPlanned FleetRolloutService fleet-rollouts.rollouts.v1.rollout-planned integration 3
RolloutWaveCompleted FleetRolloutService fleet-rollouts.rollouts.v1.rollout-wave-completed integration 3
RolloutHalted FleetRolloutService fleet-rollouts.rollouts.v1.rollout-halted integration 5
RolloutCompleted FleetRolloutService fleet-rollouts.rollouts.v1.rollout-completed integration 4

IncidentOpened

An incident was opened; on-call paged for Sev1 and Sev2.

Producer FleetIncidentService (BC-37 Fleet Incidents & Off-boarding)
Scope / version integration / v1
Topic fleet-operations.incidents.v1.incident-opened
Aggregate ProductIncident
Consumers StudioBff, StudioNotificationService, AuditService, DashboardService, AlertRuleService
Field Type Required Description
incidentId guid yes
tenantId string yes
productId string yes
severity enum:IncidentSeverity yes
title string yes

IncidentStateChanged

Acknowledged, mitigated, resolved or reviewed.

Producer FleetIncidentService (BC-37 Fleet Incidents & Off-boarding)
Scope / version integration / v1
Topic fleet-operations.incidents.v1.incident-state-changed
Aggregate ProductIncident
Consumers StudioBff, AuditService, DashboardService
Field Type Required Description
incidentId guid yes
tenantId string yes
productId string yes
fromState enum:IncidentState yes
toState enum:IncidentState yes

IncidentResolved

The incident is resolved; customers notified.

Producer FleetIncidentService (BC-37 Fleet Incidents & Off-boarding)
Scope / version integration / v1
Topic fleet-operations.incidents.v1.incident-resolved
Aggregate ProductIncident
Consumers StudioBff, AuditService, SloService, FeedbackService
Field Type Required Description
incidentId guid yes
tenantId string yes
productId string yes
severity enum:IncidentSeverity yes
durationMinutes int yes

OnCallChanged

On-call coverage changed.

Producer FleetIncidentService (BC-37 Fleet Incidents & Off-boarding)
Scope / version integration / v1
Topic fleet-operations.on-call.v1.on-call-changed
Aggregate OnCallRecord
Consumers StudioBff, AuditService
Field Type Required Description
recordId guid yes
tenantId string yes
responder string yes
from datetime yes
to datetime yes

OffboardingRequested

An off-boarding was requested.

Producer FleetIncidentService (BC-37 Fleet Incidents & Off-boarding)
Scope / version integration / v1
Topic fleet-operations.offboarding.v1.offboarding-requested
Aggregate Offboarding
Consumers StudioBff, AuditService, FactoryCommercialService
Field Type Required Description
offboardingId guid yes
tenantId string yes
productId string yes
customerTenantId string no

OffboardingCompleted

Export handed over and deletion completed with evidence.

Producer FleetIncidentService (BC-37 Fleet Incidents & Off-boarding)
Scope / version integration / v1
Topic fleet-operations.offboarding.v1.offboarding-completed
Aggregate Offboarding
Consumers FleetInventoryService, StudioBff, AuditService, FactoryCommercialService
Field Type Required Description
offboardingId guid yes
tenantId string yes
productId string yes
customerTenantId string no
deletionOrderId guid yes

ProductOnboarded

A product is under fleet operation.

Producer FleetInventoryService (BC-35 Fleet Inventory & SLOs)
Scope / version integration / v1
Topic fleet-inventory.products.v1.product-onboarded
Aggregate OperatedProduct
Consumers StudioBff, AuditService, FactoryCommercialService, SloService
Field Type Required Description
productId string yes
tenantId string yes
projectId string yes
edition enum:ManagedEdition yes

ProductInstanceStateChanged

An instance changed state, release or health.

Producer FleetInventoryService (BC-35 Fleet Inventory & SLOs)
Scope / version integration / v1
Topic fleet-inventory.products.v1.product-instance-state-changed
Aggregate OperatedProduct
Consumers FleetRolloutService, FleetIncidentService, StudioBff, DashboardService
Field Type Required Description
instanceId guid yes
productId string yes
tenantId string yes
customerTenantId string yes
environmentId string yes
fromState enum:InstanceState yes
toState enum:InstanceState yes
releaseId guid yes

ProductObjectiveDefined

A product objective exists or was tightened.

Producer FleetInventoryService (BC-35 Fleet Inventory & SLOs)
Scope / version integration / v1
Topic fleet-inventory.objectives.v1.product-objective-defined
Aggregate ProductObjective
Consumers SloService, StudioBff, AuditService
Field Type Required Description
objectiveId guid yes
tenantId string yes
productId string yes
kind string yes
target decimal yes

RolloutPlanned

A rollout was planned (and may await approval).

Producer FleetRolloutService (BC-36 Fleet Upgrades & Rollouts)
Scope / version integration / v1
Topic fleet-rollouts.rollouts.v1.rollout-planned
Aggregate Rollout
Consumers StudioBff, AuditService, StudioNotificationService
Field Type Required Description
rolloutId guid yes
tenantId string yes
productId string yes
kind enum:RolloutKind yes
waves int yes
instances int yes

RolloutWaveCompleted

A wave promoted and baked successfully.

Producer FleetRolloutService (BC-36 Fleet Upgrades & Rollouts)
Scope / version integration / v1
Topic fleet-rollouts.rollouts.v1.rollout-wave-completed
Aggregate Rollout
Consumers StudioBff, DashboardService, FleetInventoryService
Field Type Required Description
rolloutId guid yes
tenantId string yes
productId string yes
wave int yes
instances int yes

RolloutHalted

A guard breached or a promotion failed; the wave is being rolled back.

Producer FleetRolloutService (BC-36 Fleet Upgrades & Rollouts)
Scope / version integration / v1
Topic fleet-rollouts.rollouts.v1.rollout-halted
Aggregate Rollout
Consumers FleetIncidentService, AlertRuleService, StudioBff, AuditService, StudioNotificationService
Field Type Required Description
rolloutId guid yes
tenantId string yes
productId string yes
wave int yes
reason string yes

RolloutCompleted

Every wave completed (or the rollout was rolled back or cancelled).

Producer FleetRolloutService (BC-36 Fleet Upgrades & Rollouts)
Scope / version integration / v1
Topic fleet-rollouts.rollouts.v1.rollout-completed
Aggregate Rollout
Consumers FleetInventoryService, StudioBff, AuditService, DashboardService
Field Type Required Description
rolloutId guid yes
tenantId string yes
productId string yes
state enum:RolloutState yes
targetReleaseId guid no

Commands

Command Service Handled by Result events Summary
OpenIncident FleetIncidentService ProductIncident IncidentOpened
TransitionIncident FleetIncidentService ProductIncident IncidentStateChanged, IncidentResolved
SetOnCall FleetIncidentService OnCallRecord OnCallChanged
RequestOffboarding FleetIncidentService Offboarding OffboardingRequested
AcknowledgeHandover FleetIncidentService Offboarding
OnboardProduct FleetInventoryService OperatedProduct ProductOnboarded
SetProductObjective FleetInventoryService ProductObjective ProductObjectiveDefined
PlanRollout FleetRolloutService Rollout RolloutPlanned
ResumeRollout FleetRolloutService Rollout
RollbackRollout FleetRolloutService Rollout RolloutCompleted
CancelRollout FleetRolloutService Rollout RolloutCompleted

Consumed from other services

Consumer Event Producer Handler Purpose
FleetIncidentService AlertFired AlertRuleService OpenFromAlert Critical alerts on operated products open incidents by rule.
FleetIncidentService RolloutHalted FleetRolloutService OpenFromRollout A halted rollout opens an incident linked to it.
FleetIncidentService ProductInstanceStateChanged FleetInventoryService TrackAffected Affected instances and recovery.
FleetIncidentService ApprovalDecided RunControlService ApplyOffboardingApproval Off-boarding approvals.
FleetIncidentService ExportCompleted RetentionResidencyService ExportReady The export bundle is ready for handover.
FleetIncidentService DeletionOrderCompleted RetentionResidencyService DeletionDone Off-boarding completes.
FleetInventoryService PromotionCompleted EnvironmentPromotionService UpdateInstanceRelease An instance runs a new release.
FleetInventoryService RollbackCompleted EnvironmentPromotionService UpdateInstanceRelease An instance was rolled back.
FleetInventoryService ObservedStateChanged RuntimeEnvironmentService UpdateInstanceHealth Health and staleness per instance.
FleetInventoryService SloBreached SloService MarkDegraded A product objective breached marks instances Degraded.
FleetInventoryService SloRecovered SloService MarkRecovered Back to Running.
FleetInventoryService SubscriptionChanged FactoryCommercialService ApplyEdition Managed edition follows the subscription.
FleetRolloutService ApprovalDecided RunControlService ApplyApproval Production rollouts wait for their approval.
FleetRolloutService PromotionCompleted EnvironmentPromotionService TrackWavePromotion Wave promotions complete.
FleetRolloutService PromotionFailed EnvironmentPromotionService HaltOnFailure A failed promotion halts the wave.
FleetRolloutService SloBreached SloService HaltOnGuard A guard objective breached during bake halts the rollout.
FleetRolloutService ReleaseReady ReleaseService OfferRollout A new product release can be rolled out to instances.
FleetRolloutService AssetReleasePublished AgentRegistryService OfferUpgrade A published template or library release offers an upgrade or re-scaffold rollout.
FleetRolloutService ProductInstanceStateChanged FleetInventoryService TrackInstances Instance set and states for wave selection.