# 实施记录

## 设计方向

- 视觉基调按 `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`。