docs: 登记 T-305 名单查询契约(JKTJLIST00002 实测字段校正)
- docs/04 §11.4 校正实测字段名并标端点已部署 - docs/01 §5.2 JKTJLIST00002 联调可用 - tasks T-305 DONE Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -216,3 +216,12 @@
|
||||
- 变更:从 docx 扒出 JKTJLIST00002 完整契约(checkYear/page/rows 在 baseInfo,返回人员名单+checkType 状态),记入 `docs/04 §11.4`;`tasks.md` 拆出 **T-305(体检已检/未检名单,契约齐全仅待沙箱部署验证,TODO 可领)**,把 T-304 收窄为真正缺 serviceId 的列表(档案/老年人/中医指导);`scripts/query_health_check.py` 的 list 模式改为 docx 正确参数。
|
||||
- 决策:JKTJLIST00002 契约不缺(docx 完整),不该被 B1/B2 阻塞——只差运行时确认端点是否部署,故独立成可领任务;纠正原 T-304"一刀切 BLOCKED"把能做的和真卡的混在一起。它是名单/进度接口,不含体检明细,非数据源。
|
||||
- 下一步:跑 list 探针确认部署 → 若通即领 T-305 建 osi 方法;未部署则归 docs/06 B5 催厂家。
|
||||
|
||||
## 2026-07-08 T-305 体检已检/未检名单查询打通
|
||||
|
||||
- 状态:DONE
|
||||
- 变更:`contract/jktj.go` 加 `HealthCheckPerson`(名单一行 20 字段,字段名按实测校正);`osi/jktj.go` 加 `ListHealthCheckPeople`(JKTJLIST00002)+ `ListHealthCheckQuery`(checkYear 必填、page/rows 默认、idCard/checkType 可选);`osi/jktj_test.go` 加名单解码/路径/baseInfo分页/checkYear 校验测试(脱敏假数据);`docs/04 §11.4` 校正实测字段名并标端点已部署;`docs/01 §5.2` 标 JKTJLIST00002 联调可用。
|
||||
- 验证:Python 探针 `list` 实测 `code=01`,返回 10 人名单(每人 checkType 状态)。Go 侧待用户 `go test ./...` 复验(本环境离线)。
|
||||
- 发现:实测字段名与 docx 多处不符——`birthday`(非 birthDay)、`phrId`(非 phrid,驼峰)、`manaDoctorId`(非 manadoctorId),另有 docx 未列的 `manaDocterName`(拼写 Docter)/`empiId`/`manaUnitText`。再次印证以实测样本为准。
|
||||
- 决策:名单行字段稳定且均为字符串(20 项),全部强类型化(区别于体检明细 260 项只留 Raw);单查 JKTJ00002 仍未部署,与本条无关。
|
||||
- 下一步:T-302 体检 HTTP 端点;或按需把名单也暴露成 HTTP 端点。
|
||||
|
||||
Reference in New Issue
Block a user