# 调压任务模块说明（`src/tasks`）

## 1. 目标

- 管理调压主任务 `Task` 与明细 `TaskItem`。
- 支持状态机流转与事件触发，保证设备压力同步更新。

## 2. 状态机

- 当前发布流程：`ACCEPTED -> COMPLETED`
- 当前取消流程：`ACCEPTED -> CANCELLED`
- 历史兼容：保留 `PENDING` 状态枚举，便于兼容旧数据与旧任务记录

非法流转会返回 `409` 冲突错误（中文消息）。

## 3. 角色权限

- 系统管理员/医院管理员/医生/主任/组长：发布任务时必须直接指定接收工程师，并且只能取消自己创建的任务
- 工程师：不能再执行“接收”动作，只能完成指派给自己的任务
- 其他角色：默认拒绝

补充：

- `GET /b/tasks/engineers`：返回当前角色可选的接收工程师列表，系统管理员可按医院筛选。
- `GET /b/tasks`：返回当前角色可见的调压记录列表，系统管理员可按医院筛选。
- `POST /b/tasks/cancel` 现支持可选 `reason` 字段，便于前端保留取消原因输入。
- 当前取消原因仅透传到事件层，数据库暂未持久化该字段。

## 4. 记录列表

- 后台任务页不再承担手工发布入口，只展示调压记录。
- 记录维度按 `TaskItem` 展开，每条记录会携带：
  - 任务状态
  - 患者信息
  - 手术名称
  - 设备信息
  - 旧压力 / 目标压力 / 当前压力（均为字符串挡位标签）
  - 创建人 / 接收人 / 发布时间

## 5. 事件触发

状态变化后会发出事件：

- `task.published`
- `task.completed`
- `task.cancelled`

用于后续接入微信通知或消息中心。

## 6. 完成任务时的设备同步

`completeTask` 在单事务中执行：

1. 更新任务状态为 `COMPLETED`
2. 读取 `TaskItem.targetPressure`
3. 批量更新关联 `Device.currentPressure`

确保任务状态与设备压力一致性。

补充：

- `publishTask` 只负责生成任务和目标挡位，不会立刻修改设备当前压力。
- 只有工程师完成任务后，目标挡位才会回写到设备实例。