Analytics Domain Events¶
Why This Exists¶
This document defines events published by the Analytics Domain.
Owner¶
The owner is the Chief Product Officer and Enterprise Architect.
Business Value¶
Analytics events make dashboards, metric snapshots, reports, and insights observable across Algosure without giving other domains ownership of analytical records.
Event Metadata¶
Every Analytics event should include:
- EventId.
- EventType.
- OccurredAt.
- AggregateId.
- OrganizationId where applicable.
- ReportingPeriod where applicable.
- SourceLineage.
- CorrelationId.
- CausationId.
- SchemaVersion.
Event Catalogue¶
| Event | Trigger | Payload | Consumers | Business value |
|---|---|---|---|---|
| KPIDefined | A KPI definition is approved. | KpiId, version, owner, formula. | Analytics, Intelligence. | Establishes metric governance. |
| KPIUpdated | A KPI definition changes. | KpiId, previous version, new version. | Analytics, Audit. | Tracks formula change. |
| AnalyticalViewRefreshed | Reporting model refresh completes. | ViewId, refresh time, source lineage. | Dashboards, Reports. | Keeps reporting current. |
| MetricSnapshotCreated | A metric value is calculated. | SnapshotId, KpiId, value, period, lineage. | Dashboard, Reports, Intelligence. | Supports trends and insight generation. |
| DashboardPublished | A dashboard is approved for use. | DashboardId, audience, status. | Executive Office, Users. | Makes reporting available. |
| ReportGenerated | A report is generated. | ReportId, period, output reference. | Notification, Executive Office. | Supports management review. |
| InsightCreated | An analytical finding is recorded. | InsightId, severity, evidence, explanation. | Intelligence, Executive Office. | Directs leadership attention. |
| InsightReviewed | An insight is accepted, dismissed, or resolved. | InsightId, review result, reviewed by. | Analytics, Audit. | Closes insight lifecycle. |
| PerformanceSummaryCreated | A domain or period summary is created. | SummaryId, scope, period, highlights. | CEO Briefing. | Supports executive reporting. |
| CEOBriefingCreated | A CEO briefing is prepared. | BriefingId, period, audience, sections. | Notification, Executive Office. | Supports leadership cadence. |
Event Flow¶
sequenceDiagram
participant Bid
participant Analytics
participant Intelligence
participant ExecutiveOffice as Executive Office
Bid->>Analytics: BidOutcomeCaptured event
Analytics->>Analytics: Refresh win/loss view
Analytics->>Analytics: Create metric snapshot
Analytics->>Intelligence: Request explanation support
Intelligence-->>Analytics: Explanation metadata
Analytics-->>ExecutiveOffice: InsightCreated / CEOBriefingCreated
Cross-Domain Rule¶
Analytics events may inform source domains, but source domains must decide whether any operational change is allowed under their own rules.