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

1.6 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 指向数据库的全部数据，请仅在测试库执行。 另外，seed 账号会刷新 tokenValidAfter，所以重置前签发的旧 token 会全部失效，需要重新登录获取新 token。

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 端角色可见性
    • 组织域院管作用域限制与删除冲突