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

62 行
2.9 KiB
Markdown

# 部署统一列表详情改造并复检报销页
## 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
- [x] 本地部署前检查通过。
- [x] `SYNC_ENV=0 bash deploy/trialrun/deploy.sh` 成功完成。
- [x] 公网 `/ready` 返回健康状态。
- [x] 公网 bundle 检查通过或给出明确失败原因。
- [x] 报告部署提交 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`