docs: 登记人群分类查询优化任务(T-209)

This commit is contained in:
ila
2026-07-09 20:35:11 +08:00
parent 8d54ad38d5
commit ca16f61263
4 changed files with 55 additions and 2 deletions
+46 -1
View File
@@ -11,7 +11,7 @@
| JKDA00001 | `/jkda/create` | `CreateHealthRecord` | `health_record` |
| JKDA00003 | `/jkda/update` | `UpdateHealthRecord` | `health_record` |
| JKDA00002 | `/auto/jkda/find` | `FindHealthRecord` | (查询) |
| JKDA00005 | `/jkda/findrqbj` | `FindPersonSign` | (查询) |
| JKDA00005 | `/auto/jkda/findrqbj` | `FindRqbj` | (查询) |
| JKTJ00001 | `/jktj/create` | `CreateHealthCheck` | `health_check` |
| JKTJ00003 | `/jktj/update` | `UpdateHealthCheck` | `health_check` |
| JKTJ00002 | `/auto/jktj/query` | `QueryHealthCheck` | (查询) |
@@ -315,3 +315,48 @@ T-206 已建立本地契约与客户端方法,真实写入验收暂未执行
- **响应 `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 码表)。
---
## 12. JKDA00005 人群分类查询 · 联调实测契约(T-209)
> 来源:2026-07-09 本地探针 `scripts/query_crow_with_idcard.py` 与返回样本 `scripts/query_crow_with_idcard.json`。样本含真实身份证和档案号,只本地留存、不入库;本文只记录脱敏结构。
### 12.1 请求
```json
{
"serviceId": "JKDA00005",
"uploadinfo": {
"baseInfo": { "idCard": "<idCard>" },
"manageInfo": { "DSFMC": "<userName>", "operateUser": "<operateUser>", "operateUnit": "<orgCode-18位>" }
}
}
```
- 路径:`/osi/api/auto/jkda/findrqbj`。
- `baseInfo` 支持 `idCard` / `phrid` 二选一;实测样本使用 `idCard`。
- 注意:早期代码/文档登记为 `/jkda/findrqbj`,本次实测脚本使用 `auto/jkda/findrqbj` 返回 `code="01"`,T-209 需同步修正 `osi/codes.go`。
### 12.2 响应
```json
{
"code": "01",
"message": "操作成功",
"data": {
"personSign": "LAO",
"idCard": "<idCard>",
"phrId": "<phrId>"
}
}
```
字段说明:
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `personSign` | string | 人群分类码,可能为逗号分隔多值;码表见 §3 `personSign` |
| `idCard` | string | 身份证号,PII |
| `phrId` | string | 健康档案号,响应为驼峰 `phrId` |
Go 侧契约应从只承接 `personSign` 优化为完整承接 `personSign/idCard/phrId`,server 端点原样回写平台 JSON,避免裁掉后续可能新增字段。