hyb-oa/.trellis/tasks/05-29-frontend-audit-fixes-deploy-verify/prd.md

前端降噪审计修复部署复检

Goal

将已完成并提交的前端降噪审计修复部署到公网试运行环境，并完成必要的公网只读复检，确认工作台审计日志入口、报销支付日期默认值和报销详情状态文案修复已经进入试运行版本，且没有引入登录、权限、PC 只读视觉、移动入口或企业微信渲染回归。

本任务只做已提交修复的部署和只读验证；不扩大页面重构范围，不写真实业务数据，不覆盖远端 .env。

Scope

• 部署当前 main 中 7b6e705 前端审计修复到公网试运行环境。
• 部署前复跑本地门禁，确认当前工作区和任务合同稳定。
• 使用 SYNC_ENV=0 bash deploy/trialrun/deploy.sh 部署，禁止同步或覆盖远端 .env。
• 部署后执行公网只读验证矩阵。
• 在当前 Trellis task 中保存脱敏摘要和相对报告路径。

What I Already Know

• 最新本地修复提交：7b6e705 修复前端降噪审计问题（frontend-simplification-audit-fixes）。
• 任务归档提交：13643e3 归档前端降噪审计修复任务（frontend-simplification-audit-fixes）。
• 当前 main 工作区干净，本地比远端 ahead 11。
• 前端审计修复本地验证已通过：
  • cd client && npm run typecheck
  • cd client && npm run build
  • 聚焦 Playwright：login-portal-ux.spec.ts --grep "系统摘要审计日志"
  • UI 设计规则、Trellis governance、git diff --check
• 上一轮降噪部署复检已验证公网环境可通过 live readiness、权限矩阵、PC 只读视觉、移动入口和企微渲染矩阵。

Requirements

• 部署前必须记录执行边界、验证计划和脱敏证据路径。
• 部署前必须复跑最小本地门禁：
  • cd client && npm run typecheck
  • cd client && npm run build
  • node scripts/qa/check-ui-design-rules.mjs
  • node deploy/trialrun/validate-env-contract.js
  • python3 ./.trellis/scripts/task.py validate 05-29-frontend-audit-fixes-deploy-verify
  • node scripts/qa/check-trellis-governance.mjs
  • git diff --check
• 公网部署必须使用安全模式：
  • SYNC_ENV=0 bash deploy/trialrun/deploy.sh
  • 不覆盖远端 .env
  • 不做数据库重置、恢复或手工迁移
• 部署后必须执行公网只读验证：
  • /ready 和部署脚本自带 smoke 结论
  • live smoke / OCR readiness
  • OA 权限矩阵
  • OAFRONT3 PC 只读视觉矩阵
  • 移动入口矩阵和企业微信渲染矩阵
• 验证报告只登记相对路径、状态和脱敏摘要；不得写入密码、token、完整账号、完整本地路径、真实票据或 raw payload。

Acceptance Criteria

• 用户明确批准执行公网部署。
• Trellis task 材料完整并通过 validate/governance。
• 部署前本地门禁通过。
• SYNC_ENV=0 bash deploy/trialrun/deploy.sh 完成远端服务重建，未覆盖远端 .env。
• 部署后公网 /ready 通过。
• live smoke / OCR readiness 通过或有可解释 SKIP/PASS_WITH_FINDINGS。
• 权限矩阵返回 PASS_WITH_FINDINGS：缺少本地角色凭据导致 7 个角色 SKIP，无权限断言失败。
• PC 只读视觉矩阵无 P1 blocker。
• 移动入口和企业微信渲染矩阵通过。
• 当前任务记录公网验证摘要和报告相对路径。

Test Plan

部署前：

cd client && npm run typecheck
cd client && npm run build
node scripts/qa/check-ui-design-rules.mjs
node deploy/trialrun/validate-env-contract.js
python3 ./.trellis/scripts/task.py validate 05-29-frontend-audit-fixes-deploy-verify
node scripts/qa/check-trellis-governance.mjs
git diff --check

部署：

SYNC_ENV=0 bash deploy/trialrun/deploy.sh

部署后：

LIVE_SMOKE_BASE_URL=https://oa.hyinda.com LIVE_SMOKE_READINESS_DIR=.trellis/tasks/05-29-frontend-audit-fixes-deploy-verify/research/postdeploy-live-smoke-readiness bash scripts/qa/run-live-smoke-readiness.sh
LIVE_SMOKE_BASE_URL=https://oa.hyinda.com OA_PERMISSION_MATRIX_REPORT_DIR=.trellis/tasks/05-29-frontend-audit-fixes-deploy-verify/research/postdeploy-permission-matrix node scripts/qa/check-oa-permission-matrix.mjs
bash scripts/qa/run-oafront3-pc-readonly-visual.sh
cd client && E2E_BASE_URL=https://oa.hyinda.com npx playwright test tests/e2e/dg7-mobile-information-dedupe.spec.ts tests/e2e/r124-mobile-entry-matrix.spec.ts --workers=1 --reporter=list
cd client && E2E_BASE_URL=https://oa.hyinda.com npx playwright test tests/e2e/r6-wecom-mobile-rendering-hardening.spec.ts --workers=1 --reporter=list
node scripts/qa/check-trellis-governance.mjs
git diff --check

Definition Of Done

• 公网试运行环境部署到包含 7b6e705 修复的 commit。
• 公网只读验证结果记录到当前任务。
• 结论明确为 READY_WITH_FINDINGS。
• 只有在部署与公网只读检查通过或可解释后，才告知用户可以测试。
• 提交中文 commit，commit message 引用本 Trellis task。

Out Of Scope

• 不继续重构其他页面。
• 不新增截图对比页。
• 不启动或重置真实 7 天试运行计数。
• 不创建、提交、审批、付款任何真实业务单据。
• 不写企业微信消息、通讯录、审批或回调数据。
• 不改远端 .env、生产配置、Caddy 配置或生产数据库。
• 不执行真实付款、银行流水导入、ERP 写入或支付接口联调。

Technical Notes

• Deployment spec: .trellis/spec/hyb-oa/deployment-trialrun.md
• Frontend spec: .trellis/spec/hyb-oa/frontend-react-vite-design.md
• Evidence spec: .trellis/spec/hyb-oa/docs-and-evidence.md
• Privacy spec: .trellis/spec/hyb-oa/security-privacy.md
• Governance spec: .trellis/spec/hyb-oa/project-governance.md
• Trial run runbook: docs/试运行与自动化验证手册.md
• Fix task: .trellis/tasks/archive/2026-05/05-29-frontend-simplification-audit-fixes/