EL
0b5640a977
新增工程师“取消接收”能力，任务可从 ACCEPTED 回退到 PENDING。 发布任务不再要求 engineerId，并增加同设备存在未结束任务时的重复发布拦截。 完成任务新增 completionMaterials 必填校验，仅允许图片/视频凭证，并在完成时落库。 植入物目录新增 isValve，区分阀门与管子；非阀门不维护压力挡位，阀门至少 1 个挡位。 患者设备与任务查询返回新增字段，前端任务页支持接收/取消接收/上传凭证后完成。 增补 Prisma 迁移、接口文档、E2E 用例与夹具修复逻辑。
2.5 KiB
2.5 KiB
调压任务模块说明（src/tasks）
1. 目标
- 管理调压主任务
Task与明细TaskItem。 - 支持状态机流转与事件触发，保证设备压力同步更新。
2. 状态机
- 当前发布流程：
PENDING -> ACCEPTED -> COMPLETED - 当前工程师撤回流程：
ACCEPTED -> PENDING - 当前取消流程：
PENDING/ACCEPTED -> CANCELLED PENDING表示任务已发布，等待本院工程师接收
非法流转会返回 409 冲突错误（中文消息）。
3. 角色权限
- 系统管理员/医院管理员/医生/主任/组长：发布任务时不再指定工程师，只能取消自己创建的任务
- 工程师：可接收本院
PENDING任务；接收后只能由接收工程师自己完成，或取消接收并退回PENDING - 其他角色：默认拒绝
补充：
GET /b/tasks/engineers：返回当前角色可见的医院工程师列表，系统管理员可按医院筛选。GET /b/tasks：返回当前角色可见的调压记录列表，系统管理员可按医院筛选。POST /b/tasks/cancel现支持可选reason字段，便于前端保留取消原因输入。- 当前取消原因仅透传到事件层，数据库暂未持久化该字段。
- 如果当前设备已经存在
PENDING / ACCEPTED调压任务，则禁止再次发布；同一患者的其他设备不受影响。
4. 记录列表
- 后台任务页不再承担手工发布入口，只展示调压记录。
- 记录维度按
TaskItem展开，每条记录会携带：- 任务状态
- 患者信息
- 手术名称
- 设备信息
- 旧压力 / 目标压力 / 当前压力（均为字符串挡位标签）
- 完成凭证（图片/视频）
- 创建人 / 接收人 / 发布时间
5. 事件触发
状态变化后会发出事件：
task.publishedtask.acceptedtask.completedtask.cancelled
用于后续接入微信通知或消息中心。
6. 完成任务时的设备同步
completeTask 在单事务中执行：
- 更新任务状态为
COMPLETED - 校验至少上传 1 条图片或视频凭证
- 读取
TaskItem.targetPressure - 批量更新关联
Device.currentPressure
确保任务状态与设备压力一致性。
补充：
publishTask只负责生成任务和目标挡位，不会立刻修改设备当前压力。- 只有工程师完成任务后，目标挡位才会回写到设备实例。
- 完成任务时必须上传至少一张图片或一个视频，凭证会保存到
Task.completionMaterials。