hyb-oa/.trellis/tasks/archive/2026-05/05-30-deploy-unified-page-design-public-check/prd.md

部署最新页面改造并公网复检

Goal

把已提交的统一页面设计改造部署到公网试运行环境，并完成公网可用性、关键页面冒烟和基础视觉/代码审计，明确当前线上是否可以让用户测试。

What I already know

• 最新页面改造已提交：
  • d5ef818 统一业务台账首屏设计（05-30-unified-page-design-review）
  • 74db53b 归档统一页面设计规范重审（05-30-unified-page-design-review）
• 上一轮本地验证通过：git diff --check、Trellis task validate、Trellis governance check。
• 用户要求继续推进；结合上一轮结论，本任务范围是部署和公网复检。
• 公网试运行环境是准生产环境，部署和公网检查必须记录命令、commit、/ready、smoke 结果和是否可测试。
• 默认部署命令是 SYNC_ENV=0 bash deploy/trialrun/deploy.sh，不得覆盖远端 .env。
• 部署脚本已包含环境契约、远端 /ready、external deps smoke、runtime smoke 和公网 bundle 文案扫描。

Assumptions

• 本轮只部署已提交代码，不修改生产配置、不重置数据库、不写企业微信、不执行真实付款。
• 如果缺少 live smoke 凭据或真实 OCR 样本，按脚本规则记录 SKIP，不阻塞基础部署结论。
• 如果部署或公网检查失败，先定位并修复最小问题，再重新验证；涉及真实配置变更时再单独请求确认。

Scope

• 部署当前 main HEAD 到 https://oa.hyinda.com 对应试运行环境。
• 执行部署前本地质量门禁。
• 执行部署脚本的安全模式发布。
• 执行公网 /ready、公网 bundle copy、live smoke readiness。
• 对这次修改涉及的主要页面做公网视觉/交互抽查：
  • 工作台
  • 待我处理
  • 采购
  • 合同
  • 项目
  • 资产
  • 应付账款
• 输出是否可以线上测试的结论。

Out of Scope

• 不改业务功能范围。
• 不新增 UI 设计规则。
• 不做数据库重置、远端 .env 覆盖、企业微信写入或真实付款。
• 不导入真实业务数据。

Requirements

• 部署前必须确认工作区状态，避免带未提交改动发布。
• 使用 SYNC_ENV=0，不覆盖远端 .env。
• 发布后必须检查公网 /ready。
• 面向用户可测试的声明必须以部署和公网检查通过为前提。
• 如果发现视觉或交互问题，优先判断是否属于本轮部署阻断；非阻断问题另建后续改造任务。

Acceptance Criteria

• 当前 commit 已部署到公网试运行环境。
• https://oa.hyinda.com/ready 通过。
• 部署脚本内置 smoke 通过或失败原因已记录。
• scripts/qa/run-live-smoke-readiness.sh 通过。
• 至少完成工作台、待我处理和本轮主要业务台账页面的公网抽查。
• 最终结论明确：可以线上测试 / 已部署但仍有阻断 / 未部署成功。

Test Plan

• git status --short
• cd client && npm run typecheck
• cd client && npm run build
• node deploy/trialrun/validate-env-contract.js
• SYNC_ENV=0 bash deploy/trialrun/deploy.sh
• LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readiness.sh
• 必要时运行聚焦公网 Playwright 或截图检查。
• git diff --check
• python3 ./.trellis/scripts/task.py validate 05-30-deploy-unified-page-design-public-check
• node scripts/qa/check-trellis-governance.mjs

Technical Notes

• 相关规范：
  • .trellis/spec/hyb-oa/project-governance.md
  • .trellis/spec/hyb-oa/deployment-trialrun.md
  • .trellis/spec/hyb-oa/frontend-react-vite-design.md
• 相关脚本：
  • deploy/trialrun/deploy.sh
  • scripts/qa/run-live-smoke-readiness.sh
  • scripts/qa/check-public-bundle-copy.mjs
• 本轮部署 commit：74db53b。
• 公网 readiness 报告：artifacts/qa-flow/live-smoke-readiness-20260530-200338。
• 公网页面抽查截图：output/playwright/05-30-public-ledger-check/。
• r104-public-visual-acceptance 原先在普通浏览器要求企业微信 OAuth 按钮；当前产品规则是普通浏览器展示企业微信工作台边界说明，企业微信 WebView UA 才展示一键进入按钮。本任务已同步修正断言。

Definition of Done

• 公网部署与复检完成。
• 阻断问题已修复或明确记录。
• 任务文档、验证命令和提交记录完整。
• 最终回复包含 commit、部署状态、公网检查结果和可测试结论。