指标口径治理规则

适用于运营看板、绩效考核、业务复盘中的指标定义统一与跨报表一致性治理。

规则文件内容

请复制以下内容，保存为 .cursor/rules/metric-caliber-governance.mdc：

---
description: 指标口径定义、时间窗口、维度过滤与回溯修订规则
globs: src/analytics/**, src/reports/**, docs/metrics/**
---

# 指标口径治理业务规则

## 1. 核心原则
- **先定义后计算**：每个指标必须先有标准口径文档。
- **同口径同结果**：同一指标在不同报表必须一致。
- **修订可回溯**：口径变更后需保留历史版本结果。

## 2. 指标定义规则
- 指标包含：名称、业务意义、公式、粒度、刷新周期。
- 公式必须明确分子分母与过滤条件。
- 指标必须绑定业务 owner 与技术 owner。

## 3. 时间窗口规则
- 必须明确 `自然日/业务日` 口径。
- 支持 `T+0/T+1` 数据延迟声明。
- 跨时区统计必须统一到业务时区。

```ts
interface MetricDefinition {
  metricCode: string;
  formula: string;
  grain: 'day' | 'week' | 'month';
  timezone: string;
  dataDelay: 'T+0' | 'T+1';
}

4. 维度与过滤规则

• 指标默认维度需声明（组织、区域、业务线）。
• 隐式过滤条件必须显式文档化。
• 同一维度编码在所有报表中保持一致。

5. 变更治理规则

• 口径变更必须走评审流程并发布版本。
• major 变更必须提供新旧口径对照期。
• 变更后重算历史数据需标记重算批次。

6. 校验规则

• 每日对核心指标执行阈值波动检测。
• 指标与明细账抽样对账误差需在阈值内。
• 缺失数据必须返回 data_incomplete 标记。

7. 展示规则

• 看板必须显示口径版本与更新时间。
• 关键指标需提供“公式说明”入口。
• 被修订指标需可查看版本历史。

8. 数据模型约束

• metric_definitions 必须包含：metric_code, name, formula, grain, version, owner_id
• metric_runs 必须包含：metric_code, run_date, version, value, data_status, computed_at
• metric_change_logs 必须包含：metric_code, from_version, to_version, change_reason, approved_by

9. 实施注意事项

• 建议口径定义与 SQL 脚本同仓管理。
• 关键指标可增加快照表，支持审计追溯。
• 报表平台需禁止未注册指标上线。

## 适用场景

- 经营分析看板
- SLA/效率指标统计
- 绩效与结算口径统一