# E2E 接口测试说明

## 1. 目标

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

## 2. 风险提示

`pnpm test:e2e` 会执行：

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

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

## 3. 运行命令

```bash
pnpm test:e2e
```

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

```bash
pnpm test:e2e:prepare
```

监听模式：

```bash
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 端角色可见性
  - 患者创建人返回与展示
  - 跨院工程师隔离
  - 组织域院管作用域限制与删除冲突
  - 目录、设备、组织、用户的删除保护
