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：通过。