tyt-api-nest/docs/tasks.md
EL 6ec2d0b0e0 新增 B 端设备模块(后端 CRUD、分页筛选、权限隔离)并接入前端设备管理页面与路由菜单
鉴权改为登录态回库校验,新增 tokenValidAfter 失效时间,支持密码变更与 seed 重置后旧 token 立即失效
患者字段由 idCardHash 统一迁移为 idCard,新增身份证标准化逻辑并同步 C 端生命周期查询参数
组织模块增加小组删除限制(有成员时返回 409)并补充中文错误消息
任务取消接口支持可选 reason 字段(先透传事件层)
补齐 Prisma 迁移、文档说明和 E2E 用例(含设备模块与 token 失效场景)
2026-03-18 20:23:55 +08:00

1.1 KiB
Raw Blame History

调压任务模块说明(src/tasks

1. 目标

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

2. 状态机

  • PENDING -> ACCEPTED -> COMPLETED
  • PENDING/ACCEPTED -> CANCELLED

非法流转会返回 409 冲突错误(中文消息)。

3. 角色权限

  • 医生/主任/组长:发布任务、取消自己创建的任务
  • 工程师:接收任务、完成自己接收的任务
  • 其他角色:默认拒绝

补充:

  • POST /b/tasks/cancel 现支持可选 reason 字段,便于前端保留取消原因输入。
  • 当前取消原因仅透传到事件层,数据库暂未持久化该字段。

4. 事件触发

状态变化后会发出事件:

  • task.published
  • task.accepted
  • task.completed
  • task.cancelled

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

5. 完成任务时的设备同步

completeTask 在单事务中执行:

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

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