2.0 KiB
2.0 KiB
Why
C2 已落地派单工单（八态 order）+ 老人个人项目库。C3 交付 PRD 第三块「履约留痕」：护理员签到/签退/项目执行/拍照/异常上报 + 垫付台账与结转（is_prepaid）+ admin 工单留痕/异常列表。为 C4 质控闸门提供「已提交留痕」这一 L4/L5 前提。
What Changes
- 新增
ho_record/ho_record_item/ho_record_photo/ho_record_abnormal四张表 +settlement/report二期预留空表。 - 履约留痕：签到（服务器取时）、项目执行（exec_result 枚举）、拍照（≤500KB）、签退（必拍 3001 硬拒 + 拒拍出路）、离线补传（client_md5 去重）。
- 异常上报：
abnormal_type必选、其余可选；扑空（未遇）专门形态（工单转 not_met + 到访证据，不产生 record）。 - 垫付台账与结转：
waiting_period留痕is_prepaid=1、billable=0；档案页「结转」按钮勾选垫付记录生成正式记录（原记录保留只读、不改原始时间戳）。 - L3 硬锁落地：留痕必须关联有效工单；L1 例外：
waiting_period走垫付不误拦。 - 前端「工单留痕」页 + 「异常列表」页 + 服务对象页结转入口。
Capabilities
New Capabilities
backend/record: 履约留痕——签到/签退/项目/照片/离线/列表/垫付台账/结转。backend/abnormal: 异常上报/列表 + 扑空专门形态。frontend/ad/record: admin 工单留痕页 + 异常列表页 + 服务对象页结转入口。
Modified Capabilities
shared/data-model: 新增ho_record/ho_record_item/ho_record_photo/ho_record_abnormal+settlement/report六实体。shared/api-contract: 新增 record/abnormal/prepaid 接口。
Impact
- 后端 ec-nest：新增 record/abnormal 模块（纯新增）。
- 前端 ec-admin：工单留痕页 + 异常列表页 + 服务对象页扩展。
- 数据：新增 6 张表（迁移，utf8mb4_general_ci）。
- 依赖：C2 的 order 八态、plan/plan_item、staff（护理员）、MinIO StorageService。