EL
6ec2d0b0e0
鉴权改为登录态回库校验，新增 tokenValidAfter 失效时间，支持密码变更与 seed 重置后旧 token 立即失效 患者字段由 idCardHash 统一迁移为 idCard，新增身份证标准化逻辑并同步 C 端生命周期查询参数 组织模块增加小组删除限制（有成员时返回 409）并补充中文错误消息 任务取消接口支持可选 reason 字段（先透传事件层） 补齐 Prisma 迁移、文档说明和 E2E 用例（含设备模块与 token 失效场景）
46 lines
1.1 KiB
Markdown
46 lines
1.1 KiB
Markdown
# 调压任务模块说明（`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`
|
||
|
||
确保任务状态与设备压力一致性。
|