Stev_Wang
140dc386c1
背景：A3 需把行业 / 客户 / 客户组 / 客户级字段立为资产根节点；用户确认两级行业树与混搭 UI（行业 B / 客户列表 A / 详情 A / 新建 B / 客户组 B / 字段 A）。 改动： - 新增 ADR-002，行业改为两级树，客户挂末级行业；同步 PRD / 技术架构 / 开发计划。 - 新增 client 模块：industries / customers / customer-groups / customer-fields 接口、真实 PrismaCustomerDirectory、客户状态机与客户转交、客户组数据范围解析、跨客户 404。 - 新增迁移与幂等种子（电商/金融两级行业、2 客户、1 客户组、4 条字段）。 - 前端新增行业/客户/客户组/字段审批页面与路由、导航更名（客户管理 / 行业管理 / 客户组），复用现有 token。 - 补充 shared 契约单测、client 集成用例、A3 浏览器 e2e。 影响面：client 模块与 client 表、shared 契约、web 路由/导航、ScopeContext 数据范围、OpenAPI 与种子；A1 客户转交占位由 client 实现替换。 回滚：回滚本提交；数据库保留新增表或按报告执行 down SQL；CUSTOMER_DIRECTORY 可切回空集实现。 验证：format:check / lint / typecheck / test 全绿（shared 131 / api 90 / web 125，共 346）；test:int 5 文件 39 条；A3 e2e 1/1；build 8/8；真实浏览器六页验证通过。
5.5 KiB
5.5 KiB
e2e（Playwright）
现有用例
| 文件 | 说明 | 默认是否执行 |
|---|---|---|
smoke.spec.ts |
A0 冒烟：登录、模块切换、403 / 404 | 是 |
a1-identity.spec.ts |
A1-QA-01 账号生命周期（①–⑥） | 否，需 A1_E2E=1 |
a2-roles.spec.ts |
A2-QA-01 角色管理 / 权限三态 / SoD / 即时生效 | 否，需 A2_E2E=1 |
a3-client.spec.ts |
A3-QA-01 客户与行业六页可访问 / 数据加载 | 否，需 A3_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，已pnpm db:init；不要执行db:reset，会清空本地账号密码）。 - 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密码可能已被人工修改或触发登录锁定。 ⚠️ e2e 会把 actor 密码改成QaE2eAdmin2026（之后复用），请用专用测试账号/测试库，不要指向日常在用的账号。
运行
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 配置。
A2 角色管理用例（A2-QA-01）
覆盖一条完整旅程（真实 API + 真实 PG/Redis + 真实浏览器）：
- 管理员登录 →
/system/roles→ 新建角色（名称、2 个普通权限、数据范围「本部门」）→ 保存进入编辑器。 - 编辑器改权限点；授予特殊权限（
delivery:export开关）触发二次确认，保存前再确认一次（特殊权限双确认）。 - SoD 冲突：同时勾选
script:write×script:review→ 顶部「命中职责互斥」拦截 + 底部「存在职责互斥，保存不可用」且保存按钮禁用；解除后恢复可保存。 - 用 API 断言权限即时生效：绑定用户同一 access token 的
/me在下一次请求即包含user:view与delivery:export，GET /users由 403 → 200；GET /roles/{id}的普通权限与特殊权限分桶正确。 - 权限三态（UI 侧）：该用户有
user:view但无role:view，访问/system/roles显示 403 页。 - 停用确认（勾选知晓 + 停用原因）→ 编辑器状态变「停用」；API 断言
/me权限清空、GET /users返回 40340301；列表「停用」筛选下可见该角色且行内标记「停用」。 - 数据自建自清：
beforeAll按前缀清理上次异常中断的遗留角色/用户；afterAll解绑并停用qa2.roles.*用户、删除A2E2E-角色-*角色（不停用 admin、不改 admin 密码）。
前置与运行
前置与 A1 相同（API http://127.0.0.1:3000/api/v1、Web http://127.0.0.1:5173 非 demo 会话、已 pnpm db:init）：
A2_E2E=1 pnpm exec playwright test e2e/a2-roles.spec.ts --reporter=list
- 门控未开启（无
A2_E2E=1）时整文件test.skip，pnpm test:e2e/ CI 行为不变。 - 可选覆盖：
A2_E2E_BASE_URL（缺省http://127.0.0.1:5173）、A2_E2E_API_BASE_URL（缺省http://127.0.0.1:3000/api/v1）、A2_E2E_ACTOR_ACCOUNT/A2_E2E_ACTOR_PASSWORD（缺省jiang.lan/QaE2eAdmin2026，首跑用种子口令lingxi2026自动完成首登改密）。 - 截图：
design/a2-ui-v1/shots/impl/e2e/（01-roles-list…11-roles-list-disabled，共 11 张 1440×900）。 - 说明：用户按 A1 口径只停用不删除（用户不可删）；角色在解绑后删除，可重复运行。
A3 客户与行业用例（A3-QA-01）
覆盖：登录注入 → 行业管理 / 客户列表 / 新建客户 / 客户组 / 字段审批五页标题 → 客户列表有数据 → 点击行进入客户详情深链。
前置与运行
- API 3000 + Web 5173（
pnpm dev，真实 PG；已执行pnpm db:init）。 - 用例自建临时超管
qa3.e2e（Prisma 写入，结束后删除），不依赖本地账号密码。
A3_E2E=1 pnpm exec playwright test e2e/a3-client.spec.ts --reporter=list
- 可选覆盖：
A3_E2E_BASE_URL（缺省http://127.0.0.1:5173）、A3_E2E_API_BASE_URL（缺省http://127.0.0.1:3000/api/v1）。 - 截图：
design/a3-ui-v1/impl/（实施报告引用）。