docs: 登记 T-208 查询端点并同步快照

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-08 00:05:23 +08:00
parent 47eaf1051e
commit d196339ed3
3 changed files with 16 additions and 2 deletions
@@ -185,3 +185,11 @@
 - 验证：`go test ./...` 通过。
 - 验证：`go build ./...` 通过。
 - 阻塞：未执行真实 `JKDA00001` create。原因是当前只有真实查询样本，没有明确的安全测试居民/身份证和写入授权；直接用现有真实样本创建/更新可能污染平台档案或触发重复建档。解除条件：提供可写入沙箱的测试居民资料，或明确授权使用某条测试数据做 create。
+
+## 2026-07-08 T-208 server 模式健康档案查询端点
+
+- 状态：DONE
+- 变更：新增 `handler/health_record.go`（`GET /api/health-record/find`，回写平台完整响应，不裁字段）、`handler/health_record_test.go`（完整回写 + 缺标识符 400）、`server.go`（server 模式起 HTTP 服务 + 路由）、`osi_client.go`（抽出 `buildOSIClient` 共用构造）；`verify_jkda.go` 改用共用构造消除重复；`main.go` 加 `-addr`、server 模式真正启动服务；`tasks.md`/`current-state.md` 同步。
+- 验证：用户在 Windows 侧 `go test ./...`、`go build ./...` 通过；`go run . -mode server` 起服务后 `curl .../find?idCard=<..>` 返回平台完整档案 JSON。（本 WSL 离线无 go 工具链，未在本环境复跑。）
+- 决策：查询端点直接回写 `Result.Raw`（平台原始 `{code,message,data}`），保证未建模字段不丢失；默认监听 `127.0.0.1:8080` 而非 `:8080`，因端点返回真实档案 PII，避免绑 0.0.0.0 暴露到局域网；身份证经 URL query 传入，仅作本机查看工具，勿反代外网。
+- 下一步：解 T-206 阻塞（真实 create），或按需为查询端点加鉴权后再考虑对外。