KFC/tyt-api-nest
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
tyt-api-nest/docs/e2e-testing.md
EL 6ec8891be5 修复 E2E 准备脚本： 
package.json
test:e2e:prepare 现在是 migrate reset --force && prisma generate && seed
为 seed 运行时补充 JS Prisma client 生成器：
schema.prisma
修复 seed 在 ESM/CJS 下的 Prisma 导入兼容：
seed.mjs
修复 Jest 环境未加载 .env 导致连到 127.0.0.1 的问题：
e2e-app.helper.ts
修复夹具依赖“名称”导致被组织测试改名后失效的问题（改为按 seed openId 反查）：
e2e-fixtures.helper.ts
修复组织测试的状态污染与清理逻辑，并收敛 afterAll 资源释放：
organization.e2e-spec.ts
e2e-context.helper.ts
2026-03-13 03:29:16 +08:00

1.4 KiB
Raw Blame History

E2E 接口测试说明

1. 目标

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

2. 风险提示

pnpm test:e2e 会执行：

  1. prisma migrate reset --force
  2. node prisma/seed.mjs

这会清空 .env 中 DATABASE_URL 指向数据库的全部数据，请仅在测试库执行。

3. 运行命令

pnpm test:e2e

仅重置数据库并注入 seed：

pnpm test:e2e:prepare

监听模式：

pnpm test:e2e:watch

4. 种子账号（默认密码：Seed@1234）

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

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/tasks.e2e-spec.ts
  • test/e2e/specs/patients.e2e-spec.ts

6. 覆盖策略

  • 受保护接口（27 个）：每个接口覆盖 6 角色访问结果 + 未登录 401。
  • 非受保护接口（3 个）：每个接口至少 1 个成功 + 1 个失败。
  • 关键行为额外覆盖：
    • 任务状态机冲突（409）
    • 患者 B 端角色可见性
    • 组织域院管作用域限制与删除冲突