Files
chenfuqiang 4a8613b27e fix: 批量匹配跳过画像待补录教师 + render-html 按行重建 + 金标准 fixtures 业务化(P0+P1)
- run_match 新增 skip_incomplete:批量缺省跳过画像不完整教师并记录 skipped,指定单教师仍 PROFILE_INCOMPLETE;汇总页出"画像待补录"行
- render-html 补 --report-id 行上下文(inputMapping $row.$pk),CLI 容错解析回退最近 10 份
- report_service 日志改容错 _log(),修复未 setup 时单跑测试崩溃的顺序依赖
- fixtures 替换为教师画像/赛道/期望结论金标准样例,新增 sample_tracks.json
- 新增 4 个批量跳过用例(314 项,除 3 个已知 jsonschema 环境失败外全绿)
- tests/README 增补本机无共享 runtime 的测试方式;TUTORIAL/ACTIONS.md 同步表述
2026-09-24 18:01:41 +08:00
..

fixtures(脱敏样例)

本目录存放 golden case / contract test 用的输入、期望输出与 adapter profile 样例。

规则

  • 只能放虚构、脱敏、可公开的数据(演示租户、演示 request_id 等)。
  • 禁止:真实客户名、真实订单/提单号、真实报关单、真实 token/cookie、真实内网 URL、生产环境凭证。
  • adapter_profiles.sample.yaml 中的 URL 须使用 localhost、example.invalid 等明显占位;credential_ref 仅表达「从密钥库引用」的约定,不得内嵌密钥。

与本仓库测试的对应关系

文件 用途
sample_request.json 教师画像金标准样例(脱敏,JSON 数组),可直接 import-teachers --teachers-json 消费;供 tests/samples/test_golden_cases.py.sample 演示读取。
sample_tracks.json 指南赛道金标准样例(脱敏,JSON 数组),可直接 import-tracks --tracks-json 消费;与上配套覆盖 H1/H2/S1~S3/T1 场景。
expected_response.json 与上两份配套的期望匹配结论(Top 赛道/分层/得分/剔除项,业务复制后按域替换)。
adapter_profiles.sample.yaml 五类运行方式(mock / simulator_api / simulator_rpa / real_api / real_rpa)的配置表达样例。

给 AI 工具的替换规则

  • 可以按业务重命名字段、增减键名,但必须保持虚构、脱敏;不得把真实客户标识原样搬进仓库。
  • 可以新增更多 fixture 文件,例如 case_valid_001.json、case_missing_required_001.json,并在测试中通过相对路径读取。
  • 禁止将真实企业数据、真实单证截图中的文字、真实报关要素未经处理直接复制进 fixtures/。
  • 若用例来自真实客户样本,须先脱敏、泛化、替换编号与地名,再作为模板数据提交。