feat(osi): 优化人群分类查询接口（T-209）

2026-07-09 20:38:27 +08:00
parent ca16f61263
commit 561cd839e7
10 changed files with 108 additions and 16 deletions
@@ -256,3 +256,13 @@
 - 发现：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 模式人群分类查询端点。
+## 2026-07-09 T-209 人群分类查询优化
+
+- 状态：DONE
+- 变更：`osi/codes.go` 修正 JKDA00005 路由为 `/auto/jkda/findrqbj`；`osi.PersonSignResult` 补 `idCard`、`phrId` 字段；`handler.HealthRecordHandler` 新增 `GET /api/health-record/crowd`，原样回写平台响应；`server.go` 注册新端点。
+- RED：`go test ./osi -run TestFindRqbjCallsJKDA00005AndDecodesPersonSign -count=1` 初次失败，缺少 `idCard/phrId` 字段；`go test ./handler -run TestHealthRecordCrowdReturnsRawPlatformResponse -count=1` 初次失败，缺少 `Crowd` handler。
+- GREEN：补实现后上述目标测试通过。
+- 验证：`go test ./...` 通过。
+- 验证：`go build ./...` 通过。
+- 验证：`git diff --check` 通过。
+- 决策：HTTP 端点继续采用查询类统一策略，直接回写 `Result.Raw`，避免裁掉平台后续新增字段；真实样本 JSON 仍只本地留存，不提交。