docs: 登记人群分类查询优化任务(T-209)

This commit is contained in:
ila
2026-07-09 20:35:11 +08:00
parent 8d54ad38d5
commit ca16f61263
4 changed files with 55 additions and 2 deletions
+7
View File
@@ -249,3 +249,10 @@
- 变更:新建 `docs/07-本项目HTTP接口.md`,整理 server 模式 5 个查询端点(档案 find + 体检 last/all/list)的参数/上游 serviceId/返回形态/PII 警示/通用约定;`docs/README.md` 导航登记;`CLAUDE.md` 文档同步表加"HTTP 端点增改 → docs/07"。
- 决策:区分两层接口文档——上游 OSI 契约以 docs/01+04(实测)为准,本项目对外接口以 docs/07 为单一事实来源;docx 反复被证明不可靠,只作参考。
- 下一步:新增端点时同步 docs/07;对外前补鉴权/日志/限流。
## 2026-07-09 登记 T-209 人群分类查询优化
- 状态:DONE(看板+契约文档维护)
- 来源:用户更新 `scripts/query_crow_with_idcard.py`,并提供本地响应样本 `scripts/query_crow_with_idcard.json`(含真实身份证/phrId,不入库)。
- 发现:JKDA00005 实测请求路径为 `/osi/api/auto/jkda/findrqbj`,响应 `data` 是对象,字段含 `personSign`、`idCard`、`phrId`;当前 Go 侧只建模 `personSign`,且路径仍是早期 `/jkda/findrqbj`。
- 变更:`tasks.md` 新增 T-209;`docs/01`、`docs/04 §12` 登记实测契约和待改点。
- 下一步:实现 T-209,修正 `osi` 路由/响应结构,并补 server 模式人群分类查询端点。