40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
|
# 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。
|