hyb-oa/.trellis/tasks/05-26-oa-auth-layout-wecom-login-ux/implement.md

认证页布局与企业微信登录体验优化实施记录

Implementation Scope

• 新增共享认证页组件 AuthPanel，统一品牌、标题、副标题、内容区和页脚样式。
• 调整 AuthLayout，仅保留认证页面背景、居中容器、PWA 更新提示和路由出口。
• 重构登录页，移除卡片套卡片；普通浏览器以账号密码登录为主，企业微信/SSO 放入次级登录区。
• 重构企业微信 WebView 登录页层级，企业微信一键进入为主 CTA，账号密码保留为兜底入口。
• 重构找回密码页和修改密码页，复用同一认证面板，不改后端认证接口。
• 收窄企业微信入口 E2E，避免前端 UI 用例依赖真实登录和个人设置页跳转。

Safety Boundaries

• 不新增邮箱验证码登录。
• 不改后端登录、找回密码、企业微信 OAuth 或绑定接口。
• 不写入企业微信后台配置，不写真实业务数据。
• 不记录账号密码、验证码、token、Secret 或真实 payload。
• 部署和公网 smoke 需在本地验证通过后另行确认。

Validation Log

• cd client && npm run typecheck：已通过。
• cd client && npm run build：已通过，production build 和 PWA precache 正常生成。
• node scripts/qa/check-ui-design-rules.mjs --strict：已通过。
• python3 ./.trellis/scripts/task.py validate 05-26-oa-auth-layout-wecom-login-ux：已通过。
• node scripts/qa/check-trellis-governance.mjs：已通过；仅提示 docs/产品设计规则.md 是非 spec/task research 上下文。
• git diff --check：已通过。
• 登录/找回密码 focused E2E：已通过，2 passed。
• 企业微信入口 E2E：已通过，2 passed。
• 完整 login-portal-ux.spec.ts：认证页、找回密码、企业微信 WebView 相关 5 passed；Portal 历史文案断言 3 failed，见下方已知漂移。
• 视觉截图已生成：
  • output/playwright/oa-auth-layout-wecom-login-ux/desktop-login.png
  • output/playwright/oa-auth-layout-wecom-login-ux/desktop-forgot-password.png
  • output/playwright/oa-auth-layout-wecom-login-ux/mobile-wecom-login.png
• 移动企业微信主按钮计算背景色：rgb(0, 57, 138)。

Known Unrelated Test Drift

• client/tests/e2e/login-portal-ux.spec.ts 的完整套件仍有 Portal 历史文案断言漂移，涉及旧文案 快捷操作栏、角色重点、常用入口。
• 该漂移不属于本认证页任务，本任务仅保留登录页、找回密码和企业微信入口 focused 用例作为验收依据。