EL
6ec2d0b0e0
鉴权改为登录态回库校验，新增 tokenValidAfter 失效时间，支持密码变更与 seed 重置后旧 token 立即失效 患者字段由 idCardHash 统一迁移为 idCard，新增身份证标准化逻辑并同步 C 端生命周期查询参数 组织模块增加小组删除限制（有成员时返回 409）并补充中文错误消息 任务取消接口支持可选 reason 字段（先透传事件层） 补齐 Prisma 迁移、文档说明和 E2E 用例（含设备模块与 token 失效场景）
62 lines
1.6 KiB
Markdown
62 lines
1.6 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` 指向数据库的全部数据，请仅在测试库执行。
|
||
另外，seed 账号会刷新 `tokenValidAfter`，所以重置前签发的旧 token 会全部失效，需要重新登录获取新 token。
|
||
|
||
## 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 端角色可见性
|
||
- 组织域院管作用域限制与删除冲突
|