# 良渚日报/月报格式抽取稿

本稿从原 `liangzhu-ecommerce-reporting` 和相关月报规则中抽取，只保留“如何合并数据、如何输出表格、如何校验 Excel”的内容。已主动排除数据库、平台导出、GUI、Bot2、Kanban、cron、dashboard、云部署、NAS 写入、Git 等操作流程。

## 保留内容

### 1. 数据输入边界

- 只使用用户已上传或已经准备好的源文件/表格。
- 源文件复制到任务工作区后处理，不编辑原始上传缓存。
- 缺失字段写入 `口径说明`，不得编造。
- 用户明确要求只要 Excel 时，不输出 Markdown 汇报文件。

### 2. 日报/周报数据合并

源数据分组：

- 淘宝/天猫日维度店铺数据：访客、浏览、支付金额、退款金额、件数、买家数、转化、客单价等。
- 淘宝/天猫商品数据：商品/SKU TOP。
- 京东流量数据：UV/PV/停留等。
- 京东交易概况：成交金额、件数、买家数、转化、客单价、退款金额。
- 京东商品明细：商品 TOP；没有则只做店铺层分析。

合并维度：

- 平台/店铺；
- 日期或周/月窗口；
- 产品名 + SKU/编码；
- 源文件和 sheet 名保留用于追溯。

### 3. 公式

- 实际成交金额 = 支付/成交金额 - 成功退款金额
- 客单价 = 支付/成交金额 ÷ 支付买家数
- 支付转化率 = 支付买家数 ÷ 访客数
- UV价值 = 支付/成交金额 ÷ 访客数
- 退款率 = 成功退款金额 ÷ 支付/成交金额

覆盖期不一致时，不强行计算完整周期客单价/转化率，应标记为部分口径。

### 4. 日报/周报推荐 Sheet

- `00_口径说明`
- `01_店铺核心指标`
- `02_商品TOP`
- `03_平台店铺对比`
- `04_运营结论`
- `05_原始汇总明细`，可选

商品 TOP：

- 优先按实际成交金额排序；
- 没有退款字段时按支付/成交金额排序并说明限制；
- 排除零销售；
- 不用零销售补齐 TOP15/TOP20。

### 5. 月报推荐 Sheet

- `00_口径说明`
- `01_月度经营总览`
- `02_店铺核心指标`
- `03_商品TOP20`
- `04_新品表现`
- `05_推广分析`
- `06_流量来源`
- `07_下月执行重点`
- `08_原始汇总明细`，可选

### 6. 接手前后对比

默认窗口：

- 接手前30天：2026-04-09 至 2026-05-08
- 接手后30天：2026-05-09 至 2026-06-07

推荐 Sheet：

- `核心指标对比`
- `分店铺宽表`
- `每日原始汇总`
- `口径说明`

### 7. 推广分析要求

推广数据不能只罗列原始表。必须输出结论：

- `推广分析结论`
- `推广效果_前后变化`
- `推广场景_前后变化`

判断口径：

- CPC 下降为好；
- ROI、CTR、CVR、点击、成交金额、成交笔数上升为好；
- 花费上升/下降本身中性，必须结合成交和 ROI 判断；
- 不要把计划、场景、关键词等重叠维度重复相加。

### 8. Excel 校验

交付前必须：

1. 用 `openpyxl` 或等价方式重新打开；
2. 检查文件非空；
3. 检查预期 sheet；
4. 检查日期窗口/标题单元格；
5. 抽查核心数值；
6. 检查商品 TOP 无零销售补齐；
7. 缺失字段在 `口径说明` 里可见；
8. 不把内部脚本日志、过程说明或无关路径放进交付物。