Stev_Wang
4d9eb980af
ci / 质量门禁 (push) Canceled after 0s
背景： - 开发计划 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
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。
前置
- API：
pnpm --filter @lingxi/api dev（http://127.0.0.1:3000/api/v1，真实 PG + Redis，已db:reset+ seed）。 - Web：
pnpm --filter @lingxi/web dev（http://127.0.0.1:5173，需VITE_PUBLIC_DEMO_SESSION=false，否则登录走演示会话）。 - 管理员 actor：默认用种子超管
jiang.lan（首登会把初始密码lingxi2026改成QaE2eAdmin2026，之后复用）。 若本地已改密或想换账号，覆盖：A1_E2E_ACTOR_ACCOUNT/A1_E2E_ACTOR_PASSWORD。 ⚠️ 不要用admin：本地admin密码可能已被人工修改或触发登录锁定。
运行
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 配置。