hyb-oa/.trellis/tasks/archive/2026-05/05-31-deploy-menu-naming-public-check/prd.md

部署菜单命名改动并公网复检

Goal

将当前 main 上已完成并本地验证通过的菜单命名、业务页面操作区和去除通用 台账工具 的改动部署到公网 OA，并完成公网健康、live readiness 和重点页面视觉/文案复检。部署通过后才告知用户可以在线查看。

What I Already Know

• 用户已确认继续执行部署与公网复检。
• 最新业务改造提交为 43efc9e 统一菜单命名并移除剩余台账工具（05-31-unified-menu-remove-ledger-tools-wave2），归档提交为 df26922。
• 本地验证已通过：前端 typecheck/build、聚焦 Playwright、Trellis validate/governance 和 git diff --check。
• 目标公网为 https://oa.hyinda.com，属于准生产试运行环境。
• 部署必须使用 SYNC_ENV=0 bash deploy/trialrun/deploy.sh，不得覆盖远端 .env。
• 当前产品边界固定：系统不接 ERP；不使用通用 台账工具 文案；菜单统一为 报销、采购、合同、项目、资产、付款、应付账款、票据 等短名称。

Scope

• 使用现有部署脚本将当前 main 部署到公网 OA。
• 部署后执行 /ready、public bundle scan、live smoke readiness 和重点页面视觉/文案复检。
• 允许修复阻塞本次部署或只读复检完成的部署脚本、smoke 基线或证据记录问题。
• 记录部署提交、命令、检查结果、截图/报告位置和是否可让用户测试。

Out of Scope

• 不同步或覆盖公网 .env。
• 不执行真实付款、银行流水导入、真实支付接口、企业微信写入或数据库重置。
• 不执行真实业务写入；公网页面复检以只读和登录 smoke 为主。
• 不新增页面设计改造；如公网发现新的 UI 问题，优先记录并另建最小修复任务。

Requirements

• 部署前确认工作区状态和部署环境契约。
• 部署脚本必须完成远端构建、Prisma 迁移部署/状态检查、seed、/ready、external deps smoke、runtime smoke 和公网 bundle 文案扫描。
• 部署后独立复核：
  • https://oa.hyinda.com/ready
  • public bundle copy scan
  • live smoke readiness
  • 重点业务页面没有回退到 台账工具、合同台账、资产台账、票据中心 等旧命名。
• 如本地缺少 LIVE_SMOKE_* 凭据，必须记录为 SKIP/BLOCKED，不能声明完整登录 smoke 通过。
• 若部署或公网 smoke 失败，不告知用户“可以测试”，先记录失败点并处理或提出回滚/修复建议。

Test Plan

部署前：

node deploy/trialrun/validate-env-contract.js
git diff --check

部署：

SYNC_ENV=0 LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash deploy/trialrun/deploy.sh

部署后：

curl -fsS https://oa.hyinda.com/ready
node scripts/qa/check-public-bundle-copy.mjs https://oa.hyinda.com
LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readiness.sh

视觉/文案复检：

• 使用 Playwright/浏览器访问公网，保存截图到 output/playwright/05-31-deploy-menu-naming-public-check/。
• 检查工作台、报销、采购、合同、项目、资产、付款、应付账款、票据等入口和页面标题/操作区。

收口：

python3 ./.trellis/scripts/task.py validate 05-31-deploy-menu-naming-public-check
node scripts/qa/check-trellis-governance.mjs
git diff --check

Acceptance Criteria

• 当前 main 成功部署到公网 OA，并记录部署基线提交 hash。
• 部署使用 SYNC_ENV=0，未覆盖远端 .env。
• 公网 /ready 通过。
• public bundle copy scan 通过，且重点旧文案没有回退。
• live smoke readiness 通过；如凭据缺失，按规则记录 SKIP，不声明真实登录通过。
• 重点页面视觉/文案复检有截图或脚本证据。
• 本任务记录部署和复检结果，并明确用户是否可以线上测试。

Deployment Result

• 部署基线提交：df26922 归档菜单命名与台账工具任务（05-31-unified-menu-remove-ledger-tools-wave2）
• 部署命令：SYNC_ENV=0 LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash deploy/trialrun/deploy.sh
• 部署结论：通过。
• 公网 /ready：{"ok":true}。
• 部署脚本内检查：环境契约、远端构建、migration deploy/status、seed、/ready、external deps smoke、runtime smoke、live smoke 3/3、公网资源文案扫描均通过。
• 独立 live readiness：通过，报告目录 artifacts/qa-flow/live-smoke-readiness-20260531-151949；其中 pending OCR 扫描因当前本地 shell 未配置 DATABASE_URL 记录为 SKIP，不影响 live smoke 和 live OCR 复核结论。
• 视觉/文案复检：通过，截图目录 output/playwright/05-31-deploy-menu-naming-public-check/，未发现可见 台账工具、合同台账、资产台账、票据中心。
• 用户可测试：可以，公网地址 https://oa.hyinda.com。

Technical Notes

• 部署规范：.trellis/spec/hyb-oa/deployment-trialrun.md
• 前端视觉/交互规范：.trellis/spec/hyb-oa/frontend-react-vite-design.md 与 frontend-design skill
• 项目治理：.trellis/spec/hyb-oa/project-governance.md
• 试运行手册：docs/试运行与自动化验证手册.md