docs: 排除蝦皮原始报表,并同步主按钮文案
raw_data 不进 Git 原始报表含逐商品台币销售额等商业数据,进了 Git 就是永久历史。 - .gitignore 排除 raw_data/ - 改掉三处"仓库里有一份样本"的失真表述,改为向项目负责人索取 - 06 §2.1 相应加强:既然大样本不进库,admin/testdata/ 下的脱敏小样本 就必须提交,否则别人拉下来测试跑不了;并写明脱敏做法 主按钮文案 开始自动获取 → 获取任务 ⇄ 停止获取 只改按钮标签。"自动获取"作为功能名保留(状态栏、Tab 顺序、 协调器开关等处不动),05 §4.1 加了一句说明两者不是一回事。 已知遗留:pdd_ui.py 自身仍不一致——构造时用「获取任务」, 但状态机 485/487 行仍是「开始自动获取」/「停止自动获取」, 会覆盖掉构造时的文字。该文件有未提交改动,本次未触碰, 差异已记入 02 §3.1,需另开工单修。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -113,14 +113,20 @@ admin/data/
|
||||
|
||||
## 7. 拿样本数据试一下导入
|
||||
|
||||
仓库里有一份真实的蝦皮导出样本:
|
||||
蝦皮的真实报表**不在仓库里**——里面有逐商品的台币销售额,属于商业数据,
|
||||
已在 `.gitignore` 里排除。
|
||||
|
||||
需要的话**找项目负责人要一份**,放到仓库根目录的 `raw_data/` 下:
|
||||
|
||||
```text
|
||||
raw_data/蝦皮数据样本.xlsx
|
||||
```
|
||||
|
||||
11287 行,其中 5195 行是商品汇总行、6092 行是 SKU 行。
|
||||
导入后应该得到 **5195 条商品 + 6092 条 SKU**。数字对不上就是解析有问题。
|
||||
参考样本是 11287 行 = 5195 商品汇总行 + 6092 SKU 行,
|
||||
导入后应得到 **5195 条商品 + 6092 条 SKU**。数字对不上就是解析有问题。
|
||||
|
||||
> 写自动化测试**不要**用这份大文件,用 `admin/testdata/` 下已脱敏的小样本,
|
||||
> 见 [06 质量与安全](06-quality-security.md) §2.1。
|
||||
|
||||
解析规则见 [03 数据模型](03-data-model.md) §3.3,那里说明了为什么一个文件要拆成两张表。
|
||||
|
||||
|
||||
@@ -105,7 +105,10 @@ CREATE INDEX idx_shopee_skus_parse ON shopee_skus(parse_ok);
|
||||
| 商品汇总行 | `商品規格ID` 是 `-` 或空 | 5195 | `shopee_products` |
|
||||
| SKU 行 | `商品規格ID` 是数字 | 6092 | `shopee_skus` |
|
||||
|
||||
导入 `raw_data/蝦皮数据样本.xlsx` 应得到 **5195 商品 + 6092 SKU**,数字对不上就是解析有问题。
|
||||
拿参考样本(11287 行)导入应得到 **5195 商品 + 6092 SKU**,数字对不上就是解析有问题。
|
||||
|
||||
> 样本文件含商业数据,**不在仓库里**,找项目负责人要,放 `raw_data/` 下。
|
||||
> 自动化测试用 `admin/testdata/` 里的小样本,别读大文件。
|
||||
|
||||
**第二步:按列名找索引,不要写死列号**
|
||||
|
||||
|
||||
@@ -29,8 +29,15 @@
|
||||
- SKU 映射复用:第二次匹配同一 SKU 应自动带出;
|
||||
- 在线状态派生:`last_seen_at` 刚好在边界前后。
|
||||
|
||||
`[必须]` 导入相关的测试用 `testdata/` 下的**小样本**(几十行),
|
||||
不要每次跑测试都读 1.9MB 的完整报表。
|
||||
`[必须]` 导入相关的测试用 `admin/testdata/` 下的**小样本**(几十行),
|
||||
不要读完整报表。
|
||||
|
||||
`[必须]` 这份小样本**必须提交进 Git**,否则别人拉下来测试跑不了。
|
||||
制作方法:从真实报表里挑几十行,**删掉全部销售额、曝光、转化率等指标列**,
|
||||
只保留导入用得到的字段(商品ID、商品名稱、商品規格ID、商品規格、貨號等),
|
||||
并把商品名称改成无意义的占位文字。
|
||||
|
||||
完整报表含商业数据,**不进 Git**(见 `.gitignore`)。
|
||||
|
||||
### 2.2 集成测试
|
||||
|
||||
@@ -144,7 +151,7 @@
|
||||
| 2 | `go vet ./...` 无告警 | | 开发者 |
|
||||
| 3 | `go test ./...` 全绿 | 不允许有跳过而未说明的用例 | 开发者 |
|
||||
| 4 | 四个页面能正常打开 | 起服务跑一遍 | 开发者 |
|
||||
| 5 | 样本导入条数正确 | 导 `raw_data/蝦皮数据样本.xlsx`,应得 5195 商品 + 6092 SKU | 开发者 |
|
||||
| 5 | 样本导入条数正确 | 导入参考样本(需向项目负责人索取,放 `raw_data/`),应得 5195 商品 + 6092 SKU | 开发者 |
|
||||
| 6 | 数据库从上一版本迁移成功 | 拿旧 `admin.db` 副本启动新版本,人工数据不丢 | 开发者 |
|
||||
| 7 | 契约测试通过 | [04 §9 清单](04-client-api.md)逐条 | 开发者 |
|
||||
| 8 | 干净环境启动 | 没装过本项目的机器上 `go run .` 或跑 exe | 开发者 |
|
||||
|
||||
Reference in New Issue
Block a user