适用场景
数据项目失败的原因 80% 不在技术，而在口径：同一个"销售额"三个部门三种算法。先定口径，再谈平台。
配置步骤（指标口径与文档）
# 指标文档字段
# 指标名 | 英文名 | 计算公式 | 统计范围 | 时间维度 | 数据源 | 负责人 | 版本
# 例：有效访客数 | valid_visitor | count(distinct id) | 排除测试数据 | 自然日 | 访客库 | 张三 | v1.2关键参数与建议
- 数据源清单：业务系统、数据库、接口、文件，明确更新频率与责任人
- 指标口径文档化：计算公式、统计范围、时间维度、例外规则
- 分层建设：原始层 → 明细层 → 汇总层，避免报表直连生产库
- 权限：按角色分配数据范围，敏感字段脱敏
- 质量：对账机制（与源系统核对），异常数据有告警
容易踩的坑
- 口径口头约定，报表数字对不上
- 口径变更不留版本，历史数据不可比
- 无负责人，指标没人维护
验证与巡检
# 验证：随机抽 3 个指标，按文档能复算出报表数字- 巡检：口径文档更新记录、指标负责人明确
小结
数据平台的验收标准：拿一个指标，从原始数据到报表数字能完整解释清楚，且与源系统对账一致。解释不清的指标不上报表。
> 说明：文中命令为通用写法，不同型号/版本可能略有差异，落地前请对照设备实际版本的官方文档；带外管理与安全设备变更建议先在测试设备验证。