EL 2bfe8ac8c8 新增上传资产模型与迁移，支持 IMAGE、VIDEO、FILE 三类资产管理

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

2026-03-20 04:35:43 +08:00

2.6 KiB

Raw Blame History

E2E 接口测试说明

1. 目标

覆盖 src/**/*controller.ts 当前全部 30 个业务接口。
采用 supertest + @nestjs/testing 进行真实 HTTP E2E 测试。
测试前固定执行数据库重置，并通过真实接口全流程建数，确保结果可重复。

2. 风险提示

pnpm test:e2e 会执行：

prisma migrate reset --force
启动 Jest 后，由测试用例通过真实 HTTP 接口完成基础夹具创建

这会清空 .env 中 DATABASE_URL 指向数据库的全部数据，请仅在测试库执行。另外，接口引导创建的测试账号会刷新 tokenValidAfter，所以重置前签发的旧 token 会全部失效，需要重新登录获取新 token。

3. 运行命令

pnpm test:e2e

仅重置数据库并重新生成 Prisma Client：

pnpm test:e2e:prepare

监听模式：

pnpm test:e2e:watch

4. 接口引导夹具（默认密码：`Seed@1234`）

系统管理员：13800001000
院管（医院 A）：13800001001
主任（医院 A）：13800001002
组长（医院 A）：13800001003
医生（医院 A）：13800001004
工程师（医院 A）：13800001005
院管（医院 B）：13800001011
工程师（医院 B）：13800001015

说明：

这些账号不再由 prisma/seed.mjs 直写生成。
每次执行 E2E 时，会先创建系统管理员，再通过后台接口依次创建医院、院管、医生、工程师、目录、患者、手术和调压任务。
因为夹具是通过真实业务接口生成的，所以权限、作用域、删除保护和调压链路都能在同一套测试里被覆盖。

5. 用例结构

test/e2e/specs/auth.e2e-spec.ts
test/e2e/specs/users.e2e-spec.ts
test/e2e/specs/organization.e2e-spec.ts
test/e2e/specs/dictionaries.e2e-spec.ts
test/e2e/specs/devices.e2e-spec.ts
test/e2e/specs/tasks.e2e-spec.ts
test/e2e/specs/patients.e2e-spec.ts
test/e2e/specs/auth-token-revocation.e2e-spec.ts

6. 覆盖策略

受保护接口（27 个）：每个接口覆盖 6 角色访问结果 + 未登录 401。
非受保护接口（3 个）：每个接口至少 1 个成功 + 1 个失败。
关键行为额外覆盖：
- 从创建系统管理员开始的完整接口建数链路
- 任务状态机冲突（409）
- 调压任务发布后不改当前压力，完成任务后才回写设备当前压力
- 主刀医生自动跟随患者归属医生，且历史手术保留快照
- 患者 B 端角色可见性
- 患者创建人返回与展示
- 跨院工程师隔离
- 组织域院管作用域限制与删除冲突
- 目录、设备、组织、用户的删除保护

2.6 KiB Raw Blame History Unescape Escape