Stev_Wang
f97f97b0cd
ci / 质量门禁 (push) Canceled after 0s
背景： - 落实 11-前端路由与目录规范：URL、导航、面包屑、页面目录一一对应； - 「平台」更名「管理中心」，模块 key 由 platform 改为 system； - 原导航模块 key 与 URL 首段不一致（script vs /scripts、asset vs /assets）， 占位页按 URL 解析不到模块，出现「页面不存在」。 改动： - nav-config：模块 key 改为 URL 首段（scripts / assets / system），平台更名 管理中心，管理中心全部路径收敛到 /system/*；用户页为 /system/users； - routes / router：ROUTES 按模块分组；新增 /system/users、/system/users/new、 /system/users/:id；旧 /users* 与 /platform* 加前端重定向；/system 落到用户列表； - 页面目录迁移：pages/users → pages/system/users，pages/home → pages/dashboard， 懒加载与所有引用同步； - 面包屑、AppLayout、登录回跳、通用占位页（按路径 + 权限解析，无权限进 403） 与单测 / e2e 路径同步； - 顺带修复 /scripts/library、/assets/library 等占位页因模块 key 不一致导致的 404。 影响面： - 仅前端路由与目录；后端 /api/v1/users 等接口与权限点不变； - 旧书签 /users*、/platform* 由前端重定向兼容一个版本。 回滚方式： - 回滚本提交即恢复 /users 与 /platform/* 路由、原页面目录与导航命名。 验证证据： - pnpm --filter @lingxi/web lint / typecheck / test 通过（15 files / 55 tests）； - pnpm build 通过； - 浏览器：登录后落在 /system/users，导航显示「管理中心」；/users → /system/users， /platform/roles → /system/roles；有权限的 /scripts/library、/assets/library 显示占位页，无权限显示 403； - A1 e2e 6/6 通过（真实 API + 浏览器）。
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 配置。