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

1.9 KiB
Raw Permalink Blame History

用户与权限模块说明(src/users

1. 目标

  • 管理用户基础信息(姓名、手机号、角色、组织归属)。
  • 维护 B 端角色权限边界和工程师绑定医院逻辑。

2. 角色枚举

  • SYSTEM_ADMIN:系统管理员
  • HOSPITAL_ADMIN:院管
  • DIRECTOR:主任
  • LEADER:组长
  • DOCTOR:医生
  • ENGINEER:工程师

3. 关键规则

  • 医院内数据按 hospitalId 强隔离。
  • SYSTEM_ADMIN 可执行工程师绑定医院。
  • SYSTEM_ADMIN/HOSPITAL_ADMIN 可执行用户创建、编辑、删除。
  • DIRECTOR 仅可只读查看本科室下级医生/组长。
  • LEADER 仅可只读查看本小组医生列表。
  • HOSPITAL_ADMIN 仅可操作本院非管理员账号。
  • 用户组织字段校验:
    • 院管/医生/工程师等需有医院归属;
    • 主任/组长需有科室/小组等必要归属;
    • 系统管理员不能绑定院内组织字段。
  • 更新用户时,仅允许医生调整 departmentId/groupId(后端强约束)。
  • 科室/小组父级关系冻结:不允许通过更新接口迁移科室所属医院或小组所属科室。

4. 典型接口

  • GET /usersGET /users/:idPATCH /users/:idDELETE /users/:id
  • POST /b/users/:id/assign-engineer-hospital

其中院管侧的常用链路为:

  • POST /users:创建本院用户
  • GET /users/:id:查看本院用户详情
  • PATCH /users/:id:修改本院用户信息
  • DELETE /users/:id:删除本院无关联、且非管理员用户

其中主任侧的常用链路为:

  • GET /users:查看本科室下级医生/组长
  • GET /users/:id:查看本科室下级详情

其中组长侧的常用链路为:

  • GET /users:查看本小组医生列表
  • GET /users/:id:查看本小组医生详情

5. 开发改造建议

  • 若增加角色,请同步修改:
    • Prisma Role 枚举
    • roles.guard.ts 与各 Service 权限判断
    • Swagger DTO 中文说明