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。