docs: 登记 T-305 名单查询契约(JKTJLIST00002 实测字段校正)

- docs/04 §11.4 校正实测字段名并标端点已部署
- docs/01 §5.2 JKTJLIST00002 联调可用
- tasks T-305 DONE

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
ila
2026-07-08 21:11:17 +08:00
co-authored by Claude Opus 4.8
parent bf204e0162
commit f69e073199
4 changed files with 14 additions and 4 deletions
+1 -1
View File
@@ -137,7 +137,7 @@
| 创建 | `/osi/api/jktj/create` | `JKTJ00001` | 待写入授权 |
| 查询(单条) | `/osi/api/auto/jktj/query` | `JKTJ00002` | ⚠ 实测"没有url的接口配置"(**未部署**);`auto/jktj/find` 待确认 |
| 更新 | `/osi/api/jktj/update` | `JKTJ00003` | 待写入授权 |
| 已检/待检人员列表 | `/osi/api/auto/jktjlist/query` | `JKTJLIST00002` | 路径登记;入参待确认 |
| 已检/待检人员列表 | `/osi/api/auto/jktjlist/query` | `JKTJLIST00002` | ✅ 联调可用(T-305,入参 checkYear+分页)|
| 最近一次体检 | `/osi/api/auto/jktjlscx/query` | `JKTJLSJL00002` | ✅ 联调可用(T-301) |
> 体检报文体量大(实测最近一次约 260 字段,分 4 object + 3 array 子节点),是字段映射工作量最大的一块。响应结构与字段清单见 `docs/04 §11`。
+3 -2
View File
@@ -295,7 +295,7 @@ T-206 已建立本地契约与客户端方法,真实写入验收暂未执行
### 11.4 已检/待检人员名单查询 JKTJLIST00002(docx 契约,沙箱部署待验证)
> **不是体检数据源**,是机构级"某年度已检/未检人员名单/进度":返回**人员一行 + 体检状态**,不含体检明细。
> 来源:docx。沙箱是否部署未实测(对应 T-305;先用 Python 探针 `SERVICE="list"` 确认)。
> 来源:docx + 2026-07 沙箱实测(`code="01"`,返回分页人员名单)。**端点已部署可用**(T-305)。
- serviceId `JKTJLIST00002`,`POST /osi/api/auto/jktjlist/query`,信封同查询式(`uploadinfo{baseInfo, manageInfo}`)。
- **请求 `baseInfo`**(page/rows 也在 baseInfo 内):
@@ -308,4 +308,5 @@ T-206 已建立本地契约与客户端方法,真实写入验收暂未执行
| `checkType` | 否 | `0`已检 / `1`未检 / `2`全部 |
| `personName` `sex` `age` `personGroup` `gridAddress` `beginDate` `endDate` | 否 | 各类筛选。⚠ docx 参数表与样例字段名不一致(表 `ageBegin/ageEnd`/`sexCode`/`regionCode` vs 样例 `age`/`sex`/`gridAddress`)——以联调实测为准 |
- **响应 `data`(list,每人一行)**:`idCard`/`personName`/`age`/`birthDay`/`regionCode`/`regionCodeText`/`manaUnitId`/`manaUnitText`/`sexCode`/`mobileNumber`/`contact`/`contactPhone`/`signFlag`(y/n 签约)/`address`/`manadoctorId`/`phrid`/**`checkType`(0已检/1未检)**/`rqbj`(人群标志,同 personSign 码表)。
- **响应 `data`(list,每人一行)· 实测字段名**(⚠ 与 docx 多处不符,以实测为准):
`idCard`/`personName`/`age`/**`birthday`**(docx 误写 birthDay)/`sexCode`/`regionCode`/`regionCodeText`/`manaUnitId`/`manaUnitText`/**`manaDoctorId`**(docx 误写 manadoctorId)/**`manaDocterName`**(拼写 Docter)/**`phrId`**(docx 误写 phrid,此处驼峰)/**`empiId`**/`signFlag`(y/n 签约)/`address`/`mobileNumber`/`contact`/`contactPhone`/**`checkType`(0已检/1未检)**/`rqbj`(人群标志,同 personSign 码表)。