2.2 KiB
2.2 KiB
frontend/nurse-app Specification
Purpose
定义护理员 APP（Flutter）的交互与行为——登录、今日任务、服务执行、拍照分档、异常上报、扑空、离线补传。
Requirements
Requirement: 登录
APP MUST 支持租户 code + 账号 + 密码登录，token 持久化，后续请求带 token。
Scenario: 登录
- WHEN 护理员输入租户/账号/密码登录
- THEN 进入今日任务页，token 落本地
Requirement: 今日任务（M1）
APP MUST 展示本人今日工单（老人/时段/项目/状态），点卡片进入服务执行。
Scenario: 看今日任务
- WHEN 护理员打开 APP
- THEN 首屏即今日工单卡片
Requirement: 服务执行（M2）
APP MUST 支持签到（自动定位+时间）→ 勾项目（默认全勾，exec_result 三态）→ 拍照 → 签退（自动算时长）。签到/签退时间不传客户端值（服务器取时）。
Scenario: 签到签退
- WHEN 护理员点签到再点签退
- THEN 自动记录时间/定位/时长，后端生成留痕
Requirement: 拍照分档
APP MUST 支持必拍/免拍/可拍三档；必拍项强制拍照 + 压疮结构化标签；必拍未拍签退按钮不可点；提供「无法拍摄」拒拍出路（选原因放行）。
Scenario: 必拍强制
- WHEN 必拍项未拍照
- THEN 签退按钮不可点，提示「这项需要拍一张照片」
Requirement: 异常上报
APP MUST 支持异常上报（9 宫格分类必选，描述/语音/照片可选）。
Scenario: 分类必选
- WHEN 护理员上报异常只选分类
- THEN 允许提交
Requirement: 扑空（未遇）
APP MUST 支持扑空专门形态：到访时间（自动）/定位（自动）/原因（必选），工单转 not_met。
Scenario: 扑空留证据
- WHEN 护理员登记未遇
- THEN 到访时间+定位+原因必留，工单转 not_met
Requirement: 离线队列
APP MUST 支持离线签到/签退/勾项目/照片/异常（本地队列 + client_md5），恢复联网后自动补传（幂等去重）。
Scenario: 离线补传
- WHEN 断网时签到，恢复联网
- THEN 自动补传且不重复（client_md5 去重）