tyt-api-nest/docs/tasks.md
EL 2bfe8ac8c8 新增上传资产模型与迁移,支持 IMAGE、VIDEO、FILE 三类资产管理
新增 B 端上传接口与列表接口,统一文件上传和分页查询能力
上传能力支持医院级数据隔离:系统管理员需显式指定医院,院内角色按登录医院自动隔离
图片上传自动压缩并转为 webp,视频上传自动转码并压缩为 mp4,普通文件按原始类型存储
增加上传目录与公开访问能力,统一输出可直接预览的访问地址
前端新增影像库页面,支持按类型筛选、关键字检索、分页浏览、在线预览与原文件访问
前端新增通用上传组件,支持在页面内复用并返回上传结果
管理后台新增影像库菜单与路由,并补充页面级角色权限控制
患者手术相关表单接入上传复用能力,支持术前资料与设备标签上传回填
新增上传模块 e2e 用例,覆盖成功路径、权限矩阵与关键失败场景
补充上传模块文档与安装依赖说明,完善工程内使用说明
2026-03-20 04:35:43 +08:00

2.0 KiB
Raw Blame History

调压任务模块说明(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 只负责生成任务和目标挡位,不会立刻修改设备当前压力。
  • 只有工程师完成任务后,目标挡位才会回写到设备实例。