nc/chis_osi
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 新增 docs/07 本项目 HTTP 接口文档

Browse Source 
- 整理 server 模式 5 个查询端点（档案 find + 体检 last/all/list）
- 参数/上游 serviceId/返回形态/PII 警示/通用约定
- README 导航登记；CLAUDE.md 同步表加端点→docs/07

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
ila
2026-07-08 22:21:21 +08:00
co-authored by Claude Opus 4.8
parent adc99e1b43
commit 8d54ad38d5
4 changed files with 122 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
progress.md
+7
View File
@@ -242,3 +242,10 @@
- 发现（实测校准）：① JKTJ00002 身份证字段是**驼峰 `idCard`**（≠ 最近一次小写 `idcard`；体检三接口 last 独用小写）；② **`checkId` 仅近年记录有值，历史记录为 `null`**（本样本仅最近 2 条有编号）——历史体检只能按 `checkDate` 定位；③ 数组元素结构同 §11.3。
- 决策：数组查询只强类型化定位字段（checkId/checkDate/idCard/personName），完整体检走 Result.Raw；单独建 `HealthCheckRecordSummary`（驼峰 idCard）不复用最近一次的 `HealthCheckSummary`（小写 idcard），因平台字段大小写不一致。
- 下一步：go test 复验后提交；体检查询三接口（最近一次/全部/名单）osi+HTTP 全齐。
## 2026-07-08 新增 docs/07 本项目 HTTP 接口文档
- 状态：DONE
- 变更：新建 `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；对外前补鉴权/日志/限流。