EL
2bfe8ac8c8
新增 B 端上传接口与列表接口，统一文件上传和分页查询能力 上传能力支持医院级数据隔离：系统管理员需显式指定医院，院内角色按登录医院自动隔离 图片上传自动压缩并转为 webp，视频上传自动转码并压缩为 mp4，普通文件按原始类型存储 增加上传目录与公开访问能力，统一输出可直接预览的访问地址 前端新增影像库页面，支持按类型筛选、关键字检索、分页浏览、在线预览与原文件访问 前端新增通用上传组件，支持在页面内复用并返回上传结果 管理后台新增影像库菜单与路由，并补充页面级角色权限控制 患者手术相关表单接入上传复用能力，支持术前资料与设备标签上传回填 新增上传模块 e2e 用例，覆盖成功路径、权限矩阵与关键失败场景 补充上传模块文档与安装依赖说明，完善工程内使用说明
64 lines
2.0 KiB
Markdown
64 lines
2.0 KiB
Markdown
# 调压任务模块说明（`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` 只负责生成任务和目标挡位，不会立刻修改设备当前压力。
|
||
- 只有工程师完成任务后，目标挡位才会回写到设备实例。
|