4a8613b27e
- 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 同步表述
29 lines
1.9 KiB
Markdown
29 lines
1.9 KiB
Markdown
# 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/`。
|
||
- 若用例来自真实客户样本，须先**脱敏、泛化、替换编号与地名**，再作为模板数据提交。
|
||
|