customs-data / tests /baseline /README.md
3v324v23's picture
feat: 新增智利海关数据接入链路,完善系统框架与文档
89d8756
|
Raw
History Blame Contribute Delete
846 Bytes
# 测试基线库 (Testing Baseline)
为了避免“修一个国家坏一个国家”的回归风险,我们引入了基线快照测试机制。
## 目录结构
- `samples/`: 存放各国家真实的脱敏抓取样本(例如一小段 CSV,或者一个完整的 HTML 页面)。
- `snapshots/`: 存放样本经过 `parse()``normalize()` 后的预期 JSON 结果。
- `test_regression.py`: 自动化遍历 `samples/`,调用对应的 Connector 进行解析,并比对 `snapshots/`,如果出现 Diff 则报错。
## 维护原则
1. **每次新增国家**:必须至少提供 1 个有效样本和对应的快照。
2. **每次修改解析逻辑**:如果预期结果发生变化,必须使用更新脚本(未来实现)重新生成快照,并在 PR 中 review Diff,确认是预期的业务修改,而不是引发了 Bug。