docs: 登记老年人自理能力查询任务(T-303)

This commit is contained in:
ila
2026-07-13 19:49:52 +08:00
parent 5745d41e30
commit ab5499acd4
6 changed files with 61 additions and 8 deletions
+41 -1
View File
@@ -18,6 +18,7 @@
| JKTJLIST00002 | `/auto/jktjlist/query` | `ListHealthCheckPeople` | (查询) |
| JKTJLSJL00002 | `/auto/jktjlscx/query` | `LastHealthCheck` | (查询) |
| LNRZLPG00001 | `/lnrzlpg/create` | `CreateElderlySelfCare` | `elderly_self_care` |
| LNRZLPG00002 | `/auto/lnr/query` | `QueryElderlySelfCare` | (查询,待联调确认) |
| LNRZLPG00003 | `/lnrzlpg/update` | `UpdateElderlySelfCare` | `elderly_self_care` |
| LNRZYTZ00001 | `/lnrzyygl/create` | `CreateTCMConstitution` | `tcm` |
| LNRZYTZ00003 | `/lnrzyygl/update` | `UpdateTCMConstitution` | `tcm` |
@@ -143,7 +144,8 @@ checkId = 截断20位( 编码( 源系统标识 | dataType | 源记录主键 [ |
以下接口的完整字段表 docx 未充分给出或存在坑点,建模时以联调样本为准并在此登记:
- [ ] 体检 `jktj/create` 全量字段(hcData/lsData/exaData/aeData,体量最大)
- [ ] 老年人自理评估 `lnrzlpg` 字段
- [x] 老年人自理评估 `lnrzlpg` **查询**字段 —— 厂家查询文档已给出,待真实联调确认,见 §13
- [ ] 老年人自理评估 `lnrzlpg` 创建/更新字段
- [ ] 中医体质辨识 `lnrzyygl` 字段
- [ ] 中医健康指导 `zyjkzd` 字段 + serviceId
- [x] 个人档案查询 JKDA00002 的请求信封与返回结构 —— 已联调实测,见 §8
@@ -360,3 +362,41 @@ T-206 已建立本地契约与客户端方法,真实写入验收暂未执行
| `phrId` | string | 健康档案号,响应为驼峰 `phrId` |
Go 侧契约应从只承接 `personSign` 优化为完整承接 `personSign/idCard/phrId`,server 端点原样回写平台 JSON,避免裁掉后续可能新增字段。
---
## 13. 老年人生活自理能力评估查询 · 厂家文档契约(待联调确认)
> 来源:2026-07 新增《老年人生活自理能力评估查询服务.docx》。文档中 `serviceId` 参数表与请求样例冲突;以下以参数表的 `LNRZLPG00002` 为实现候选,真实请求成功后才能升级为实测契约。
### 13.1 请求
- `POST /osi/api/auto/lnr/query`
- `serviceId`: `LNRZLPG00002`
- 信封沿用实测查询格式:`{"serviceId", "uploadinfo": {"baseInfo", "manageInfo"}}`。docx 样例遗漏了 `uploadinfo/manageInfo`,不可照搬。
`baseInfo` 字段:
| 字段 | 必填 | 说明 |
| --- | --- | --- |
| `idCard` | ✅ | 身份证件号 |
| `phrId` | 否 | 健康档案编号 |
| `checkId` | 否 | 第三方检查主键 |
### 13.2 响应
`data` 为评估记录数组。每条记录包含:
| 维度 | 原始值 | 等级 | 评分 |
| --- | --- | --- | --- |
| 进餐 | `jc` | `jcdj` | `jcpf` |
| 梳洗 | `sx` | `sxdj` | `sxpf` |
| 穿衣 | `cy` | `cydj` | `cypf` |
| 如厕 | `rc` | `rcdj` | `rcpf` |
| 活动 | `hd` | `hddj` | `hdpf` |
| 总评 | `zp` | `zpdj` | `zpfs` |
- 等级统一为:`1` 可自理、`2` 轻度依赖、`3` 中度依赖、`4` 不能自理。
- 定位和审计字段:`phrId`、`checkId`、`createUnit`、`createUser`、`createDate`、`inputDate`、`inputUser`、`inputUnit`。
- docx 仍误写成功码为 `"1"`;项目统一按现有 `IsSuccessCode` 兼容处理,实测成功基线仍为 `"01"`。
- docx 请求样例错误写为 `"serviceId":" LNR00004"`,不能用作实现依据。