hyb-oa/.trellis/tasks/05-29-portal-onboarding-profile-simplification/implement.md

实施说明

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 类别；该项不作为本前端任务验收口径。