touyun-elderly-care/docs/requirements/服务机构端-P0范围清单.md
liuyun 87b6a532b4 docs: 入库需求与范围基线(P0 PRD + 参考文档 + 范围清单)
- docs/requirements/P0 PRD(交付开发·V1)
- docs/requirements/服务机构端-P0范围清单、评估机构端-待设计清单
- docs/refs/ 数据字典与接口契约、产品介绍

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-10-14 10:33:39 +08:00

67 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 服务机构端 · 本期(P0)范围清单
> 依据:`docs/requirements/20261011-投云长护险管理系统-P0 PRD(交付开发·V1).md` + `docs/refs/` 数据字典与接口契约。
> 用途:后续拆任务 / 开 openspec change 的**范围基线**。与 PRD 冲突时以 PRD 为准。
## 1. 定位与形态
- 长护险**护理服务机构端**,机构内部运营系统:官方医保 APP 管打卡留痕,本系统管内部运营(计划/派单/台账/质控/对账)。
- **三端共用一套后端**:护理员 APP(安卓)/机构管理后台(Web)/家属公众号(H5 只读)。
- 多租户按 `org_id` 隔离;属地(统筹区)决定服务目录与规则,**走配置不走代码**。
## 2. P0 四块(本期交付)
### ① 待遇档案
- 老人建档:OCR 回填、参保地、参保核验留痕、**等级唯一来源=评估结论**
- 待遇状态机(**十态**)+ `elder_status_log` 状态变更留痕
- 老人个人项目库 `elder_svc`(派单带入源)
- 批量导入(老人/护理员/项目配价)
### ② 派单工单
- 服务计划:制定/变更(新建+指向旧,不原地改)/三方确认/属地项数校验
- 排班派单:日视图、调单 ≤3 步、时间冲突硬拦、批量推荐需人工确认
- 工单状态机(**八态**,含「未遇/扑空」)
- 垫付期台账与「结转」(`is_prepaid`)
### ③ 履约留痕
- 签到/签退:**服务器取时**、定位失败不阻塞、离线可用、`client_md5` 去重
- 项目勾选:默认全勾、`exec_result` 枚举(`done/undo_not_done/undo_refused`)、临时加项
- 拍照分档(必拍/免拍/可拍)+ 拒拍出路 + 压疮结构化标签
- 异常上报(9 宫格、语音、照片可选)
- 未遇(扑空)专门形态
### ④ 质控闸门
- 全量质控(非抽检)+ 五类主动推送
- 放行/退回(退回必填原因;**禁止自审自放行 `4001`**)
- 异常联动改计划
## 3. 支撑能力(横切)
- 多属地目录四层 L1–L4(`svc_national/svc_local/svc_mapping/svc_org`)+ 五条纪律
- RBAC:五角色(`nurse/leader/qc/admin/director`)多值 + 并集判权 + 字段级权限(身份证/手机号/照片)+ 本组界定
- 六条硬锁 L1–L6(L6 本期降级为**提示**,二期改硬拦)
- 统一响应 `{code,message,data,hint}` + 错误码表(`1001`–`4001`)
- 字典(异常分类、拍照分档)、文书导出(合规版式、服务端掩码、访问留痕)
- 离线队列 + 自动补传
## 4. 数据层(23 表)
- **业务主链**:`org` `user` `staff` `elder` `elder_status_log` `elder_svc` `plan` `plan_item` `order` `record` `record_item` `record_photo` `record_abnormal` `qc`
- **目录四层**:`svc_national` `svc_local` `svc_mapping` `svc_org`
- **字典/配置**:`dict_abnormal_type` `dict_photo_tier` `loc_config`
- **预留(建表不写数据)**:`report` `settlement`
## 5. 接口层
6 组 40+:A 待遇档案 / B 服务计划 / C 派单工单 / D 履约留痕 / E 质控闸门 / F 家属端。
## 6. 二期不做(只留字段,本期不实现)
- 结算对账(B5)、人员资质(B6)、院长看板(B0)
- 上报池、医保接口对接、扫脸/身份核验(P-9 待补)
- 多业务线(`biz_line` 恒 `ltci`,只留锚点)
## 7. 验收基线(11 条硬指标)
≤4 击(常态 3 击)、必填自由文本 = 0、离线可用+自动补传、字号 ≥20pt、首屏即任务、误操作可撤销、调单 ≤3 步、异常主动推送、导出即合规版式、家属端零任务、最小必要留痕。