docs: 登记 T-210 公开查询 HTTP API

This commit is contained in:
ila
2026-07-09 21:17:16 +08:00
parent 561cd839e7
commit 1903fa476b
6 changed files with 430 additions and 6 deletions
+7
View File
@@ -266,3 +266,10 @@
- 验证:`go build ./...` 通过。
- 验证:`git diff --check` 通过。
- 决策:HTTP 端点继续采用查询类统一策略,直接回写 `Result.Raw`,避免裁掉平台后续新增字段;真实样本 JSON 仍只本地留存,不提交。
## 2026-07-09 登记 T-210 公开查询 HTTP API
- 状态:DONE(看板+文档维护)
- 变更:`tasks.md` 新增 T-210,范围为把人群分类、网格地址、责任医生、药品目录、机构查询统一暴露为 server 模式 HTTP API;同步登记 `docs/openapi.yaml` 作为本项目 HTTP API 的机器可读文档。
- 决策:T-210 依赖 T-101(四类公开查询 OSI 客户端已完成)与 T-209(人群分类 HTTP 端点已存在)。实现时不再重复写 OSI 客户端,只补 handler/router、HTTP 测试、`docs/07` 与 OpenAPI。项目后续以内网部署为目标,但接口仍返回 PII/主数据,需在文档中明确绑定地址和鉴权边界。
- 验证:文档登记阶段运行 `git diff --check`;代码实现阶段再跑 `go test ./...`、`go build ./...`。
- 下一步:开始 T-210,实现公开查询 HTTP API。