# 项目约定

## 目录结构

```
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`