docs: 补全 §11.1 体检查询返回形态(JKTJ00002 返回某人全部体检数组)

- 表格加返回列,三接口返回形态明确
- 修正 JKTJ00002 定位为某人全部体检查询(非按 id 单查)
- 校正 JKTJLIST00002 状态为实测可用
- 说明按体检编号取历史须查全部+本地过滤

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
ila
2026-07-08 21:37:26 +08:00
co-authored by Claude Opus 4.8
parent f293aaef00
commit c358f20c39
+9 -6
View File
@@ -260,14 +260,17 @@ T-206 已建立本地契约与客户端方法,真实写入验收暂未执行
### 11.1 接口与状态
| 业务 | serviceId | 路径 | 状态 |
| --- | --- | --- | --- |
| 最近一次体检 | `JKTJLSJL00002` | `/auto/jktjlscx/query` | ✅ 实测可用(`osi.LastHealthCheck`) |
| 已检/待检列表 | `JKTJLIST00002` | `/auto/jktjlist/query` | 路径已登记;入参(机构/日期/分页)待厂家确认 |
| 单条按体检 id 查 | `JKTJ00002` | docx 标 `/auto/jktj/query` | ⚠ 实测返回"没有url的接口配置"(**未部署**);`/auto/jktj/find` 待确认,见 docs/06 B5 |
| 业务 | serviceId | 路径 | 返回 | 状态 |
| --- | --- | --- | --- | --- |
| 最近一次体检 | `JKTJLSJL00002` | `/auto/jktjlscx/query` | 单对象(最近一次完整体检) | ✅ 实测可用(`osi.LastHealthCheck`) |
| 某人全部体检 | `JKTJ00002` | `/auto/jktj/query` | **数组**(该人全部体检,每条完整) | ⚠ docx 有定义,实测"没有url的接口配置"(**未部署**),见 docs/06 B5 |
| 已检/待检名单 | `JKTJLIST00002` | `/auto/jktjlist/query` | 数组(人员名单+状态,非体检明细) | ✅ 实测可用(`osi.ListHealthCheckPeople`,见 §11.4) |
- 请求信封同档案(`serviceId` + `uploadinfo{baseInfo, manageInfo}`);查询按 `idCard`/`phrid`/`empiId` 之一。
- 请求信封同档案(`serviceId` + `uploadinfo{baseInfo, manageInfo}`);查询按 `phrid`/`idCard` 之一(docx baseInfo 只列这俩)。
- **两处与档案不同的坑**:① 最近一次的 `data` 是**单个对象**(档案 find 是数组);② 体检身份证字段是小写 **`idcard`**(档案是 `idCard`)。
- **JKTJ00002 返回形态**:`data` 为**数组**,每个元素是一份**完整体检**(结构同"最近一次",约 260 项 + 各子节点,见 §11.3),每条含自己的 `checkId`(体检编号,响应字段,长度 20)。
- docx 无"按 `checkId` 直接查单条"的接口——`checkId` 只是响应字段。要按体检编号取历史某次,须用本接口查该人全部体检,再**本地按 `checkId` 过滤**。
- 部署后即为"查历史体检 / 按体检编号定位"的正解接口;未部署前只有"最近一次"可用。
### 11.2 记录结构与主键