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
61 lines
1.4 KiB
Markdown
61 lines
1.4 KiB
Markdown
# 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. 运行命令
|
||
|
||
```bash
|
||
pnpm test:e2e
|
||
```
|
||
|
||
仅重置数据库并注入 seed:
|
||
|
||
```bash
|
||
pnpm test:e2e:prepare
|
||
```
|
||
|
||
监听模式:
|
||
|
||
```bash
|
||
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 端角色可见性
|
||
- 组织域院管作用域限制与删除冲突
|