Analytics Entities¶
Why This Exists¶
This document defines Analytics Domain entities with identity.
Owner¶
The owner is the Chief Product Officer and Enterprise Architect.
Business Value¶
Analytics entities make dashboards, reports, KPIs, snapshots, and insights traceable and governable.
Entity Catalogue¶
| Entity | Purpose | Key attributes | Business rules | Relationships | MVP status |
|---|---|---|---|---|---|
| Dashboard | Presents curated analytics to an audience. | DashboardId, title, audience, layout, status. | Must reference approved widgets or metrics. | Contains dashboard widgets. | MVP |
| Dashboard Widget | Displays a metric, chart, table, or insight. | WidgetId, type, source view, filters, position. | Must have data source and display rule. | Belongs to dashboard. | MVP |
| KPI Definition | Defines a metric and formula. | KpiId, name, formula, version, thresholds. | Must be versioned. | Produces snapshots. | MVP |
| Report Definition | Defines report structure and cadence. | ReportId, audience, schedule, format, filters. | Scheduled reports require cadence. | Uses KPIs and views. | MVP |
| Analytical View | Stores reporting model definition. | ViewId, source domains, refresh cadence, schema. | Must include lineage. | Feeds snapshots and dashboards. | MVP |
| Metric Snapshot | Stores point-in-time metric value. | SnapshotId, KpiId, value, scope, timestamp. | Must reference KPI version. | Feeds reports and insights. | MVP |
| Insight Record | Stores an analytical observation. | InsightId, severity, evidence, explanation, status. | Must cite evidence. | May appear in briefing. | MVP |
| Performance Summary | Summarizes performance for a period or domain. | SummaryId, period, domain, highlights, risks. | Must state scope. | Feeds CEO briefing. | MVP |
| CEO Briefing | Executive summary for leadership. | BriefingId, period, audience, sections, status. | Must separate facts, interpretations, and recommendations. | Uses summaries and insights. | MVP |
| Analytics Subscription | Defines who receives reports or briefings. | SubscriptionId, report, recipient, cadence, channel. | Must respect Notification preferences. | Uses Notification. | Later |
Entity Design Notes¶
Analytics entities should carry lineage metadata. A dashboard value without calculation context cannot support executive trust.