文件
hyb-oa/.trellis/tasks/05-27-pc-frontend-visual-consistency-wave1/implement.md
T

2.5 KiB

实施记录

设计方向

  • 视觉基调按 frontend-design 收敛为“克制、精密、低噪音的 Hyinda 工作台”。
  • docs/产品设计规则.md 作为业务、品牌和验收参考;不使用营销式大卡、装饰光斑或多套页面局部风格。
  • 第一批只覆盖共享 PC 视觉底座、/portal 和 /reimbursements,不扩展到全站。

实施范围

  • 降低全局背景、卡片、侧边栏、顶栏、按钮、指标卡和动作块的装饰强度。
  • /portal 员工视角保留核心指标、待处理、常用、团队状态和通知,把申请/资产/继续工作等低频内容收进“更多入口”。
  • /reimbursements 只突出“新建报销”,把统计、导出、批量和代提交范围切换降到工具行。
  • 补充视觉壳层 E2E mock,覆盖 /portal 与 /reimbursements 的 PC 收敛基线。

约束

  • 不修改后端 API、权限模型、路由语义、数据库、真实业务数据或部署配置。
  • 不改变移动端业务结构;移动用例只作为回归保护。
  • 面向用户可测试前仍需部署和公网检查通过。

Spec 更新判断

  • 本轮没有新增 API、数据结构、权限、部署、环境变量或跨层契约。
  • frontend-design 作为最终视觉裁决、PC 工作台低噪音方向、截图证据路径等规则已由 .trellis/spec/hyb-oa/frontend-react-vite-design.md、docs/产品设计规则.md 和本任务 PRD 覆盖。
  • 因此不更新 .trellis/spec/,仅在当前任务实施记录中保留本轮样板页决策和验证结果。

验证记录

  • cd client && E2E_BASE_URL=http://127.0.0.1:3000 npx playwright test tests/e2e/visual-shell.spec.ts --workers=1 --reporter=list:通过,5 passed。
  • cd client && npm run typecheck:通过。
  • cd client && npm run build:通过。
  • cd client && E2E_BASE_URL=http://127.0.0.1:3000 npx playwright test tests/e2e/login-portal-ux.spec.ts --workers=1 --reporter=list:首次 9 passed / 1 failed,旧断言仍查找“我的申请与资产 / 继续工作”;已更新为“更多入口”后重跑通过,10 passed。
  • node scripts/qa/check-ui-design-rules.mjs --strict:通过,0 findings。
  • python3 ./.trellis/scripts/task.py validate 05-27-pc-frontend-visual-consistency-wave1:通过。
  • node scripts/qa/check-trellis-governance.mjs:通过。
  • git diff --check:通过。
  • 截图证据:output/playwright/pc-frontend-visual-consistency-wave1/ 已生成 PC 首页、PC 报销列表、壳层和移动回归截图。