# 服务机构端 · 本期（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 步、异常主动推送、导出即合规版式、家属端零任务、最小必要留痕。