touyun-elderly-care/docs/requirements/服务机构端-P0范围清单.md

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