hyb-oa/.trellis/tasks/05-28-frontend-ux-redesign/implement.md

Implementation Notes

Scope Implemented

• Wave 0: wrote research/ux-audit-matrix.md with global findings, Wave 2 page audit and Wave 3-5 follow-up grouping.
• Wave 1: updated global shell, sidebar, topbar, page headers and shared layout classes.
• Wave 2: refined login, forgot password, portal, workflow tasks, reimbursements, reimbursement detail and notifications with clearer hierarchy and next-step language.

UX Decisions

• Visual direction: precise, restrained OA operations console.
• Navigation groups now reflect user tasks: 工作、业务、财务、管理、更多.
• Search is presented as a command entry in the Topbar.
• Notifications now behave as an inbox and return to the workbench, not the legacy dashboard.
• Login and password reset retain the generic “如账号可用” copy to avoid account enumeration.
• Wave 3-5 stay as follow-up tasks because they require different validation surfaces.

Validation

• cd client && npm run typecheck — PASS.
• cd client && npm run build — PASS.
• cd client && npx playwright test tests/e2e/pc-core-workflow-visual-wave2.spec.ts tests/e2e/login-portal-ux.spec.ts --workers=1 --reporter=list — PASS, 11 tests.
• cd client && npx playwright test tests/e2e/r89-mobile-login-navigation.spec.ts --workers=1 --reporter=list — PASS, 3 tests.
• cd client && npx playwright test tests/e2e/visual-shell.spec.ts tests/e2e/r103-cross-page-ui-consistency.spec.ts --workers=1 --reporter=list — PASS, 8 tests.
• python3 ./.trellis/scripts/task.py validate 05-28-frontend-ux-redesign — PASS.
• node scripts/qa/check-trellis-governance.mjs — PASS.
• git diff --check — PASS.

Deployment And Public Verification

• 用户已批准将本轮 Wave0-2 前端体验重构部署到公网 OA。
• 部署命令：SYNC_ENV=0 LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash deploy/trialrun/deploy.sh
• 部署边界：未同步本地 .env，未改远端配置，未执行真实付款、ERP 写入或企业微信写入。
• 首次部署后 live smoke 暴露旧断言：测试仍查找旧导航文案“备用模块”。已修正 live/视觉测试基线为新导航“更多”，并提交 1f13dd9。
• 重新部署结果：远端前端构建通过，Prisma migration deploy/status 显示无待执行 migration，部署脚本内置 live smoke 3 passed，公网资源文案扫描 findings=0。
• 独立公网 readiness：
  • LIVE_SMOKE_READINESS_DIR=.trellis/tasks/05-28-frontend-ux-redesign/research/postdeploy-20260528-wave0-2-public/live-smoke-readiness LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readiness.sh — PASS。
  • 真实 OCR 样票复核返回 duplicate_or_same_invoice 可解释终态，测试通过；pending OCR 扫描因本地未提供 DATABASE_URL 记录 SKIP。
• 完整只读巡检：
  • OAOPS1_REPORT_DIR=.trellis/tasks/05-28-frontend-ux-redesign/research/postdeploy-20260528-wave0-2-public/oa-real-use-daily LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-oa-real-use-daily.sh — PASS_OA_REAL_USE_DAILY_READY，findingCount=0。
  • 通过检查：public-ready、live-smoke-env、live-readiness、oa-only-smoke-readiness、live-feature-flags、authenticated-readonly-probe、mobile-entry-matrix、wecom-rendering-matrix、wecom-entry、report-privacy-smoke。
• 证据目录：research/postdeploy-20260528-wave0-2-public/。
• 非阻断提示：部署同步时远端历史 artifacts/qa-flow/wecom-controlled-trial-evidence-20260520-205320 目录仍无法自动删除；不影响本次部署、构建或公网检查。

Not Done In This Task

• No backend permission, workflow, status-machine or data model changes.
• Wave 3-5 pages are recorded for follow-up tasks, not completed here.