hyb-oa/.trellis/tasks/archive/2026-05/05-27-pc-frontend-visual-consistency-wave1/implement.md

实施记录

设计方向

• 视觉基调按 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 报销列表、壳层和移动回归截图。

公网部署记录

• 部署时间：2026-05-27。
• 部署提交：466075c 收敛 PC 工作台视觉 05-27-pc-frontend-visual-consistency-wave1。
• 部署命令：SYNC_ENV=0 LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash deploy/trialrun/deploy.sh，未覆盖远端 .env。
• 部署结果：通过；远端前端构建、服务重启、init、Prisma migration status 完成。
• 公网 /ready：通过。
• 部署后 live smoke：tests/e2e/live-smoke.spec.ts 通过，3 passed。
• 公网 bundle 扫描：PUBLIC_BASE_URL=https://oa.hyinda.com node scripts/qa/check-public-bundle-copy.mjs 通过，findings=0。
• 远端 external deps smoke：通过。
• 远端 runtime smoke：通过。
• 公网 PC 只读视觉：LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-oafront3-pc-readonly-visual.sh 通过，summary=PASS_PC_READONLY_VISUAL_READY，findings=0。
• 公网视觉证据：output/playwright/oafront3-pc-readonly/；报告摘要：artifacts/qa-flow/oafront3-pc-readonly-visual-20260527-141729/summary.json。