# testdata

自动化测试用的**脱敏小样本**放这里，**要提交进 Git**。
否则别人拉下仓库跑 `go test ./...` 会失败。

## 需要准备的文件

| 文件 | 用途 | 状态 |
|---|---|---|
| `shopee_sample.xlsx` | Excel 导入测试 | **待制作** |

## 怎么制作 `shopee_sample.xlsx`

从真实报表（`raw_data/蝦皮数据样本.xlsx`，需向项目负责人索取）里裁出来：

1. **只保留几十行**，但要覆盖这几种情况：
   - 商品汇总行（`商品規格ID` 是 `-`）；
   - SKU 行，规格原文用**带【】**的格式，如 `黑色,M【建議40-50公斤】`；
   - SKU 行，规格原文用**空格分隔**的格式，如 `卡其色拼黑色,L 建議50-57.5kg`；
   - 至少一行**故意写成解析不了的格式**，用来验证 `parse_ok=0` 且不瞎猜。

   前两种在真实数据里各占 53.4% 和 46.6%，两种都必须有用例。

2. **删掉全部商业指标列**——销售额、曝光次数、点击数、转化率、
   买家数、回购率等等。导入根本用不到这些，留着就是泄露。

   只保留：`商品ID`、`商品名稱`、`商品當前狀態`、`商品規格ID`、
   `商品規格`、`規格當前狀態`、`商品選項貨號`、`主商品貨號`。

3. **商品名称换成无意义的占位文字**，如 `测试商品A`、`测试商品B`。

4. 记下期望结果，写进测试断言（例如 3 商品 + 8 SKU + 1 行解析失败）。

## 为什么不直接用真实报表

- 1.9MB，每次跑测试都读一遍太慢；
- 含逐商品的台币销售额，属于商业数据，已在 `.gitignore` 里排除。

相关规定见 `docs/admin/06-quality-security.md` §2.1。