data_analysis/CLAUDE.md

项目约定

目录结构

data_analysis/
├── lib/                    # 核心库
│   └── odps_module.py      # ODPS 客户端
├── tasks/                  # 分析任务（按任务名建目录）
│   └── 任务名/
│       ├── query.sql       # SQL 文件
│       └── output/         # 结果目录
│           └── start_end.csv
└── run_sql.py              # 入口脚本

命名规范

• 任务目录：中文表意，如 渠道再分享回流/
• SQL 文件：统一用 query.sql
• 输出目录：统一用 output/
• 结果文件：{start}_{end}.csv，如 20251229_20260104.csv

SQL 变量

• ${start} - dt 分区起始日期
• ${end} - dt 分区结束日期
• 默认值：最近 7 天（T-7 ~ T-1）

新建任务

1. 创建目录 tasks/任务名/
2. 编写 query.sql，日期用 ${start} 和 ${end}
3. 运行 python run_sql.py tasks/任务名/query.sql