文件
hyb-oa/.trellis/tasks/05-31-deploy-unified-list-detail-reimbursement-public-check/prd.md
T

2.9 KiB

部署统一列表详情改造并复检报销页

Goal

将当前 main 的统一列表、详情页操作区和报销页改造部署到公网试运行环境,复检用户反馈的“报销页面顶部仍看到三个圆形按钮”是否已由最新版本修正。

What I Already Know

  • 用户已明确批准公网部署。
  • 本地 main 最新提交为 efd6d28,工作区干净。
  • 本地 client/src/pages/ReimbursementsPage.tsx 已不再保留旧的三张顶部快捷任务卡/圆形入口,当前顶部应为常规 WorkspaceHeader、新建报销、状态筛选和按权限显隐的 台账工具。
  • 公网试运行环境属于准生产环境,部署必须保留远端 .env,使用 SYNC_ENV=0 bash deploy/trialrun/deploy.sh。

Requirements

  • 部署当前 main 到 https://oa.hyinda.com 对应公网试运行环境。
  • 不覆盖远端环境变量,不执行真实付款、真实业务写入或数据库重置。
  • 部署后验证 /ready 可用。
  • 部署后复检公网前端资源已更新到当前提交对应版本。
  • 尽量复检报销页视觉状态:报销页顶部不应再出现旧的三个圆形按钮或三张任务入口。
  • 如果本地缺少 LIVE_SMOKE_* 登录凭据,必须明确标注完整登录后页面检查的限制,并使用可用的公开 readiness/bundle 检查补足证据。

Scope

  • 公网试运行部署脚本、部署后 smoke、runtime smoke 基线和本任务证据记录。
  • 允许修复阻塞部署验证完成的部署脚本或 smoke 基线问题。
  • 不改变报销、列表、详情等业务页面实现。

Acceptance Criteria

  • 本地部署前检查通过。
  • SYNC_ENV=0 bash deploy/trialrun/deploy.sh 成功完成。
  • 公网 /ready 返回健康状态。
  • 公网 bundle 检查通过或给出明确失败原因。
  • 报告部署提交 hash、ready 结果、smoke/复检结果,以及用户是否可以测试。

Out Of Scope

  • 不新增或修改业务代码。
  • 不修改数据库结构和远端 .env。
  • 不执行真实付款、银行、ERP 或其他外部写入。
  • 不处理与本次部署无关的 UI 新问题。

Test Plan

  • node deploy/trialrun/validate-env-contract.js
  • cd client && npm run build
  • node --check server/src/scripts/smoke-trialrun-runtime.js
  • bash -n deploy/trialrun/deploy.sh
  • SYNC_ENV=0 bash deploy/trialrun/deploy.sh
  • curl -fsS https://oa.hyinda.com/ready
  • LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readiness.sh
  • node scripts/qa/check-public-bundle-copy.mjs https://oa.hyinda.com
  • Public reimbursement bundle scan for absence of old task-card markers.

Technical Notes

  • 部署规范:.trellis/spec/hyb-oa/deployment-trialrun.md
  • 部署命令:SYNC_ENV=0 bash deploy/trialrun/deploy.sh
  • 环境契约检查:node deploy/trialrun/validate-env-contract.js
  • 公网目标:https://oa.hyinda.com