## 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。