背景: - 开发计划 A1 批次要求登录/刷新/登出、用户生命周期、路由与按钮权限、 权限三态用例;视觉已选定方案 B(主从分栏 + 分屏登录)。 改动: - packages/shared:新增 identity 契约(User/Me/Login/Refresh/Department/Role) 与 user:view 权限点;写接口 strict 校验。 - apps/api:新增 identity 模块与 Prisma expand 迁移(departments/users/roles/ user_roles/role_permissions/refresh_tokens);Argon2id、JWT access+refresh 旋转与 jti 吊销、登录失败锁定、首登强改、守卫链、/me、@Audit 上下文、幂等种子。 - apps/web:按方案 B 落地 /users、/users/new、/users/:id、分屏登录与 403; usePermission/<Can>、路由守卫、401 单飞刷新、停用会话兜底、Semi + token。 - e2e:新增 A1-QA-01 六类端到端用例(A1_E2E 门控)。 - openapi 与前端生成类型同步;.env.example 登记认证变量;实施报告入库。 影响面: - 新增运行时依赖 @nestjs/jwt、argon2(计划 A1-BE-02 已批准,版本精确锁定)。 - 迁移为 expand,不改既有表;本地需 prisma migrate 后重新 seed。 - 平台导航「用户与组织」由 /platform/users 调整为 /users。 回滚方式: - 代码整体回滚本提交;迁移为 expand,回滚代码不需删表; - 本地如需彻底回退按实施报告 §6 处理。 验证证据: - pnpm format:check / lint / typecheck 通过; - pnpm test:shared 95 / api 60 / web 55; - pnpm test:int:7 个(真实 PG/Redis); - A1_E2E=1 playwright test e2e/a1-identity.spec.ts:6/6; - 报告:docs/开发计划/灵犀_A1身份认证与用户管理_实施报告_V0.1.md
This commit is contained in:
1 parent
f0d218bd99
commit
4d9eb980af
120 files changed
+13112
-314
No files matched your search
@@ -0,0 +1,35 @@
|
||||
# e2e(Playwright)
|
||||
|
||||
## 现有用例
|
||||
|
||||
| 文件 | 说明 | 默认是否执行 |
|
||||
| --------------------- | ---------------------------------- | ----------------- |
|
||||
| `smoke.spec.ts` | A0 冒烟:登录、模块切换、403 / 404 | 是 |
|
||||
| `a1-identity.spec.ts` | A1-QA-01 账号生命周期(①–⑥) | 否,需 `A1_E2E=1` |
|
||||
|
||||
## A1 账号生命周期用例
|
||||
|
||||
覆盖 6 类:首登强改 → 重登 → `/users`;刷新页面单飞刷新;登出后 refresh 失效;停用后旧会话与再登录被拒;角色变更下一次请求生效;无 `user:view` 访问 `/users` 显示 403。
|
||||
|
||||
### 前置
|
||||
|
||||
1. API:`pnpm --filter @lingxi/api dev`(`http://127.0.0.1:3000/api/v1`,真实 PG + Redis,已 `db:reset` + seed)。
|
||||
2. Web:`pnpm --filter @lingxi/web dev`(`http://127.0.0.1:5173`,需 `VITE_PUBLIC_DEMO_SESSION=false`,否则登录走演示会话)。
|
||||
3. 管理员 actor:默认用种子超管 `jiang.lan`(首登会把初始密码 `lingxi2026` 改成 `QaE2eAdmin2026`,之后复用)。
|
||||
若本地已改密或想换账号,覆盖:`A1_E2E_ACTOR_ACCOUNT` / `A1_E2E_ACTOR_PASSWORD`。
|
||||
⚠️ 不要用 `admin`:本地 `admin` 密码可能已被人工修改或触发登录锁定。
|
||||
|
||||
### 运行
|
||||
|
||||
```bash
|
||||
A1_E2E=1 pnpm exec playwright test e2e/a1-identity.spec.ts --reporter=list
|
||||
```
|
||||
|
||||
- 可选覆盖:`A1_E2E_BASE_URL`(缺省 `http://127.0.0.1:5173`)、`A1_E2E_API_BASE_URL`(缺省 `http://127.0.0.1:3000/api/v1`)。
|
||||
- 截图:`design/a1-ui-v1/shots/impl/e2e/`(`01-*` … `06-*`)。
|
||||
- 数据自建自清:用管理员 token 通过 API 创建 `qa.first.* / qa.main.* / qa.noperm.* / qa.disable.*` 四个用户,结束后统一停用(不删除,便于审计回看);不改 admin 密码。
|
||||
|
||||
### 说明
|
||||
|
||||
- 门控未开启(无 `A1_E2E=1`)时整文件 `test.skip`,`pnpm test:e2e` 与 CI 行为不变。
|
||||
- 若在 `vite preview`(4173)上执行,需把 API 的 `WEB_ORIGIN` 同时包含 `http://127.0.0.1:4173`,否则跨域请求被拦;本用例默认打 5173 dev,避免改动 API 配置。
|
||||
Reference in new issue
Block a user