71 行
3.4 KiB
Markdown
71 行
3.4 KiB
Markdown
# 实施说明
|
||
|
||
## Plan
|
||
|
||
1. 移除 `PortalHomePage` 的常驻 `GettingStartedCard` 渲染和清单数据，保留首次欢迎弹窗触发逻辑。
|
||
2. 精简 `WelcomeDialog`：
|
||
- 标题改为常用入口语义。
|
||
- 只保留处理待办、提交报销、请假 3 个入口。
|
||
- 移除个人设置、通知中心、考勤汇总。
|
||
3. 精简 `ProfilePage`：
|
||
- 第一屏主内容只保留账号信息、通知设置、企业微信绑定。
|
||
- 完整员工档案作为次要入口。
|
||
- 组织/角色状态移入折叠 `账号详情`。
|
||
- 移除权限 code 默认展示。
|
||
4. 更新 `login-portal-ux.spec.ts` 中 onboarding 断言，覆盖：
|
||
- 欢迎弹窗入口数量和文案。
|
||
- 快速上手清单不再显示。
|
||
- 个人设置默认不出现权限 code。
|
||
5. 跑本地验证并用 Playwright 生成截图。
|
||
|
||
## Risk
|
||
|
||
- 工作台新员工引导测试原本依赖 `快速上手` 卡片，需要同步改断言。
|
||
- 个人设置页如果完全移除角色信息，管理员排查账号状态会少一个入口；因此保留折叠的自然语言 `账号详情`。
|
||
- 移除快速上手可能影响首次用户发现功能；通过欢迎弹窗 3 个常用入口和左侧导航承接。
|
||
|
||
## Rollback
|
||
|
||
- 若用户确认仍需要常驻上手清单，可恢复 `GettingStartedCard`，但只放真实任务型入口，不再放个人设置/通知中心/流程说明。
|
||
|
||
## Local Evidence
|
||
|
||
- 截图：
|
||
- `output/playwright/portal-onboarding-profile-simplification/welcome-dialog.png`
|
||
- `output/playwright/portal-onboarding-profile-simplification/portal-workbench.png`
|
||
- `output/playwright/portal-onboarding-profile-simplification/profile-settings.png`
|
||
- 验证：
|
||
- `cd client && npm run build`：通过。
|
||
- `cd client && E2E_BASE_URL=http://127.0.0.1:5173 npx playwright test tests/e2e/login-portal-ux.spec.ts --workers=1 --reporter=list`：12/12 通过。
|
||
- `node scripts/qa/check-ui-design-rules.mjs`：通过。
|
||
- `python3 ./.trellis/scripts/task.py validate 05-29-portal-onboarding-profile-simplification`：通过。
|
||
- `node scripts/qa/check-trellis-governance.mjs`：通过。
|
||
- `node scripts/qa/check-process-contract.mjs --baseline --json`：通过。
|
||
- `node scripts/qa/audit-docs.mjs --check-registry`：通过，保留既有 `unregistered docs files: 24` 警告。
|
||
- `git diff --check`：通过。
|
||
|
||
## Public Deployment Evidence
|
||
|
||
用户确认本地截图后执行公网部署验证：
|
||
|
||
- 发布 commit：
|
||
- `6b7dce4`：工作台上手入口和个人设置降噪。
|
||
- `35f16ff`：更新公网 live smoke 中个人设置断言。
|
||
- 部署命令：`SYNC_ENV=0 bash deploy/trialrun/deploy.sh`
|
||
- 未同步或覆盖远端 `.env`。
|
||
- 远端前端 build 通过。
|
||
- Prisma migrate deploy：无待应用 migration。
|
||
- Prisma migration status：通过。
|
||
- 公网 live smoke：3/3 通过。
|
||
- 公网前端资源文案扫描：`scanned=91 focused=2 findings=0`。
|
||
- 公网入口：
|
||
- `https://oa.hyinda.com/ready` 返回 `{ "ok": true }`。
|
||
- 企业微信入口状态：ready，entry 和 oauth 均启用。
|
||
- Readiness 汇总：
|
||
- 报告目录：`artifacts/qa-flow/live-smoke-readiness-20260529-183741/`
|
||
- `/ready`：通过。
|
||
- public bundle copy：0 findings。
|
||
- live smoke：3/3 通过。
|
||
- pending OCR：本地缺少 `DATABASE_URL`，按脚本规则记录 `SKIP`。
|
||
- 真实 OCR 样本复核被 readiness 脚本自动触发并通过，结果为可解释的 `duplicate_or_same_invoice` 类别；该项不作为本前端任务验收口径。
|