数据交付规范

本目录用于规范组员或 AI 生成数据可视化展示所需的汇总数据。目标是让不同成员交付的数据可以直接进入 Streamlit、Metabase、静态 HTML 看板和答辩材料。

使用对象

• 组长：分配数据处理任务、验收结果、合并汇总表。
• 组员：按任务生成指定汇总表。
• AI 助手：根据输入数据和任务说明生成脚本、校验数据、补充说明。

总原则

• 不把原始大 CSV 直接交给展示工具。
• 每个展示工具只读取汇总层数据。
• 每张汇总表必须有字段说明、口径说明和校验结果。
• 文件名、字段名、时间格式保持一致。
• 后续新增维度时优先新增字段或新增汇总表，不破坏已有表结构。

推荐数据流

原始 CSV 分片
  -> 本地 Python / DuckDB 清洗
  -> 标准清洗层
  -> 指标汇总表
  -> Streamlit / Metabase / 静态 HTML

目录清单

• 01-本地清洗聚合任务规范.md：说明本地生成汇总表的任务拆分、输入输出、执行要求。
• 02-标准汇总表字段规范.md：定义 Streamlit 和 BI 需要的核心汇总表字段。
• 03-交付与验收规范.md：定义组员提交方式、检查项和验收标准。
• 04-扩展维度规范.md：说明后续增加地区、渠道、GMV、用户画像等维度时如何扩展。
• 05-AI协作提示词模板.md：给组员和 AI 使用的标准任务提示词。