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
+4 -1
View File
@@ -148,12 +148,15 @@
| --- | --- | --- |
| 生活自理能力评估·创建 | `/osi/api/lnrzlpg/create` | `LNRZLPG00001` |
| 生活自理能力评估·更新 | `/osi/api/lnrzlpg/update` | `LNRZLPG00003` |
| 生活自理能力评估·查询/列表 | (清单第 14/17 项) | 待确认(推断 `LNRZLPG00002`) |
| 生活自理能力评估·查询 | `/osi/api/auto/lnr/query` | `LNRZLPG00002`(厂家查询文档给出,待真实联调确认) |
| 生活自理能力评估·列表 | (清单第 14 项) | 待确认 |
| 中医体质辨识·创建 | `/osi/api/lnrzyygl/create` | `LNRZYTZ00001` |
| 中医体质辨识·更新 | `/osi/api/lnrzyygl/update` | `LNRZYTZ00003` |
| 中医体质辨识·查询/列表 | (清单第 11 项) | 待确认(推断 `LNRZYTZ00002`) |
> 注意路径与 serviceId 的命名不一致:中医体质辨识的**路径**用 `lnrzyygl`,而 **serviceId** 用 `LNRZYTZ`。对接时以文档逐条为准,不要据路径猜 serviceId。
>
> 2026-07 新增《老年人生活自理能力评估查询服务》:查询参数表明确 `LNRZLPG00002` 与 `/auto/lnr/query`,但请求样例错写为 `LNR00004` 且省略通用 `uploadinfo.manageInfo`。实现应以参数表和已实测的统一查询信封为准,真实请求后再标记确认。
### 5.4 中医健康指导(ZYJKZD)
+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"`,不能用作实现依据。
+2 -2
View File
@@ -38,10 +38,10 @@
| # | 需要确认 | 状态 | 厂家答复 |
|---|---|---|---|
| B1 | 缺失的**列表/查询接口路径 + serviceId**:档案列表查询、老年人自理评估「列表」与「查询」、中医体质辨识「列表」、中医健康指导「列表」与「查询」 | 待要 | |
| B1 | 缺失的**列表/查询接口路径 + serviceId**:档案列表查询、老年人自理评估「列表」、中医体质辨识「列表」、中医健康指导「列表」与「查询」 | 部分 | 自理评估「查询」已收到独立文档:`/auto/lnr/query` + `LNRZLPG00002`,待真实联调确认 |
| B2 | **中医健康指导 zyjkzd** 的 serviceId + 完整字段表 | 待要 | |
| B3 | 确认 `jkda/find` 的 serviceId 是否为 `JKDA00002`(docx 样例误写成 `TNB00004`) | 已确认 | ✅联调实测 `JKDA00002` 正确 |
| B4 | 老年人自理/体质**查询**的 serviceId(我方推断 `LNRZLPG00002`/`LNRZYTZ00002`) | 待要 | |
| B4 | 老年人自理/体质**查询**的 serviceId(我方推断 `LNRZLPG00002`/`LNRZYTZ00002`) | 部分 | 自理查询文档给出 `LNRZLPG00002`,仍需真实请求确认;体质查询仍待厂家提供 |
| B5 | 体检 `jktj/create` 的**完整字段表**(hcData/lsData/exaData/aeData,体量最大) | 待要 | |
| B6 | 字段名/类型不一致点核对:`jzsfqn` vs `jzsfq`、`addressNumber` vs `adressNumber`、`familyMiddle`/`pastHistory` 是 object 还是 list | 部分 | JKDA00002 **响应**侧确认:`adressNumber`(缺 d)、`pastHistory`/`familyMiddle`=object(docs/04 §8);创建**入参**拼写仍待核 |
+4 -3
View File
@@ -6,7 +6,7 @@
## 当前快照
- 日期:2026-07-09
- 阶段:**Phase D 创建/更新代码基线完成,真实写入验收受阻;T-210 公开查询 HTTP API 已完成**;T-001~T-006、T-201、T-203、T-102、T-202、T-205、T-101、T-103、T-209、T-210 已验收;T-206 已完成本地契约/客户端/映射组装代码,但未执行真实 `JKDA00001` create
- 阶段:**Phase D 创建/更新代码基线完成,真实写入验收受阻;T-303 老年人生活自理能力评估查询待实现**;T-001~T-006、T-201、T-203、T-102、T-202、T-205、T-101、T-103、T-209、T-210 已验收;T-206 已完成本地契约/客户端/映射组装代码,但未执行真实 `JKDA00001` create
- 技术栈:Go 1.24 单二进制;`main.go -mode server|deliver`;配置读取使用 viper,支持环境变量覆盖;OSI 客户端已具备签名、信封、传输、基础判码、JKDA00002 Find、JKDA00005 FindRqbj(人群分类,已按实测 auto 路径校准)、JKDA00001 Create、JKDA00003 Update,以及 WGDZ/ZRYS/YPML/CXJG 四个公开查询薄封装
- 生产代码:已有 `main.go`、`config/`、`contract/envelope.go`、`contract/jkda.go`、`osi/` 薄客户端、`cache/dictionary.go`、`verify_jkda.go`、`go.mod`/`go.sum`;`mapping/dict.go`、`mapping/health_record.go`、`mapping/checkid.go` 已建立映射纯函数、码表基线、主数据反查接入点和创建请求组装;`handler/health_record.go`+`handler/public.go`+`server.go` 提供 server 模式档案查询、人群分类查询、网格地址、责任医生、药品目录、机构查询端点;`pipeline/` 等业务模块仍待后续任务建立
- 联调现实:**JKDA00002 个人档案查询已用 Go 侧真实请求打通**,返回 `code="01" message="操作成功" data_count=1`;**公开查询 WGDZ00001/ZRYS00001/CXJG00002 已用真实档案主数据验证通过**,均返回 `code="01"` 且数组非空;药品目录 YPML00001 已完成客户端封装和单测,尚未做真实药品关键字样本验证;**JKDA00001 create 未跑真实请求**,避免在没有安全测试居民/写入授权时污染平台档案
@@ -99,8 +99,9 @@ python3 scripts/query_health_record.py
> 读先行调整(2026-07-08):写入(T-206/T-204)被厂家授权锁死,先推其余业务线查询。
1. ✅ T-301/T-305 体检查询(最近一次 + 名单)、T-302 体检 HTTP 端点 —— 均已完成。
2. **T-303 老年人查询**(自理/体质,serviceId 部分待 B4)——起 Python 探针试探。
3. 并行催厂家(docs/06 ★ 优先催办):写入授权+测试档案、缺失单查/老年人 serviceId、checkId/完整度规则。
2. **T-303 老年人生活自理能力评估查询**:厂家文档已给出 `LNRZLPG00002` 与 `/auto/lnr/query`,先实现客户端、HTTP 端点与测试,再用真实请求确认契约。
3. T-307 老年人中医体质辨识查询仍待厂家补查询文档(docs/06 B4)。
4. 并行催厂家(docs/06 ★ 优先催办):写入授权+测试档案、缺失单查/老年人体质 serviceId、checkId/完整度规则。
4. 授权到位后回到 T-206 真实 create 验收 → T-204。
## 维护规则