Analytics Aggregates¶

Why This Exists¶

This document defines aggregate boundaries for the Analytics Domain.

Owner¶

The owner is the Chief Product Officer and Enterprise Architect.

Business Value¶

Aggregate boundaries ensure KPI definitions, reports, dashboards, snapshots, and insight records are governed independently from source operational domains.

Aggregate Map¶

flowchart TD
    KPIDef[KPI Definition Aggregate]
    Report[Report Definition Aggregate]
    Dashboard[Dashboard Aggregate]
    View[Analytical View Aggregate]
    Snapshot[Metric Snapshot Aggregate]
    Summary[Performance Summary Aggregate]
    Insight[Insight Record Aggregate]
    Briefing[CEO Briefing Aggregate]

    KPIDef --> Snapshot
    View --> Snapshot
    Snapshot --> Dashboard
    Report --> Dashboard
    Snapshot --> Summary
    Summary --> Insight
    Insight --> Briefing

KPI Definition Aggregate¶

The KPI Definition aggregate owns KPI name, formula, owner, interpretation rules, thresholds, cadence, and status.

Invariants¶

A KPI must have a formula or calculation rule.
A KPI must identify source domains and source fields.
A KPI must define interpretation guidance or thresholds before executive use.

Report Definition Aggregate¶

The Report Definition aggregate owns report purpose, audience, schedule, included metrics, filters, format, and distribution rules.

Invariants¶

A report must have an audience and purpose.
Scheduled reports must have cadence and timezone.
Reports must reference approved KPI definitions or approved analytical views.

Dashboard Aggregate¶

The Dashboard aggregate owns dashboard layout, audience, widgets, filters, and status.

Invariants¶

A dashboard must have a clear audience.
Dashboard widgets must reference approved metrics, views, or summaries.
Executive dashboards must separate current status, trend, and action-required sections.

Analytical View Aggregate¶

The Analytical View aggregate owns the reporting model derived from source facts.

Invariants¶

A view must identify its source domains and refresh cadence.
A view must not become the mutation path for source facts.
A view must retain lineage metadata.

Metric Snapshot Aggregate¶

The Metric Snapshot aggregate owns a point-in-time metric value, calculation context, source references, and timestamp.

Invariants¶

A snapshot must include KPI definition version.
A snapshot must include calculation timestamp and scope.
A snapshot should retain lineage sufficient for audit.

Insight Record Aggregate¶

The Insight Record aggregate owns analytical observations, severity, explanation, evidence, and recommended attention.

Invariants¶

An insight must reference metric snapshots or analytical views.
AI-assisted explanations must be labeled and auditable.
An insight cannot mutate source domain facts.

CEO Briefing Aggregate¶

The CEO Briefing aggregate owns executive-ready summaries, selected KPIs, risk notes, decisions required, and follow-up items.

Invariants¶

A briefing must have audience, period, source summaries, and generation timestamp.
Briefing recommendations must distinguish Analytics observations from Intelligence-generated advice.