version: "1.0.0" name: data-dashboard description: 为“数据看板”项目使用对应文档库，推动真实业务流程、记录交付与复盘。
先读主题根目录 AGENTS.md、公共/项目启动书.md 和 公共/指标口径与看板方案.md。所有路径相对主题根目录。
推进本主题
本主题流程：业务问题 → 口径确认 → 数据接入 → 数值核对 → 上线维护。
- 业务问题：先问使用者需要做什么决定，再选指标。
- 口径确认：确认分子分母、时间范围、单位与异常口径。
- 数据接入：接入源字段并记录刷新规则、依赖和失败处理。
- 数值核对：用独立明细核对结果，差异定位到字段或过滤条件。
- 上线维护：上线后监控刷新、权限与口径变更，定期复核。
- 任务入口：
进度视图.csv。按事项ID查找记录，展示给用户时使用任务名称。 - 决策与依据：
指标口径/计划表.csv、指标口径/资料/资料清单.csv。 - 新任务：复制
公共/指标页面单.md，在 看板/ 下用可读的任务名称建目录；场次、批次等重复任务加日期。 - 填写案例与真实任务时沿用空白模板的标题和字段，不另造一套简化结构。字段不适用写明原因；资料缺失时说明缺口及影响。过程写已发生的动作，产物保存到任务目录并登记实际路径。
- 结果写入
数据/数据对账.csv，沿用同一事项ID。检查字段单位、时间范围和对象粒度；单次任务不填项目累计数。缺失值不得用0代替。 - 本主题完成条件：指标计算与源数据抽样对账。先逐项核对模板中的审核字段，再更新状态；缺少影响验收的证据时保持待确认。
本库中的教学记录
看板/日销售额指标/任务记录.md 与 看板/日销售额指标/日销售额对账单.md 展示一次任务的记录及产物。其中人物和数据为模拟；未经用户要求，不把模拟数据当作真实事实或继续虚构实际结果。外部发布、支付和联系按用户授权执行。
数据记录先确认一行代表什么对象、哪段时间与什么单位。原始记录、分类合计和项目汇总分别维护；验收表的期望结果必须与实际结果逐项对应，不能只填写“通过”。
接续任务
第二项教学任务为 看板/跨日退款口径复核/任务记录.md。从前序反馈提取下一步，先建立新ID与计划行，再填写同一公共模板；复用数据不重复登记。更新视图前核对产物存在、审核结论与状态一致。