docs: 记录前端降噪审计修复部署复检（frontend-audit-fixes-deploy-verify）
这个提交包含在：
@@ -0,0 +1,123 @@
|
||||
# 前端降噪审计修复部署复检
|
||||
|
||||
## 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
|
||||
|
||||
- [x] 用户明确批准执行公网部署。
|
||||
- [x] Trellis task 材料完整并通过 validate/governance。
|
||||
- [x] 部署前本地门禁通过。
|
||||
- [x] `SYNC_ENV=0 bash deploy/trialrun/deploy.sh` 完成远端服务重建，未覆盖远端 `.env`。
|
||||
- [x] 部署后公网 `/ready` 通过。
|
||||
- [x] live smoke / OCR readiness 通过或有可解释 SKIP/PASS_WITH_FINDINGS。
|
||||
- [x] 权限矩阵返回 `PASS_WITH_FINDINGS`：缺少本地角色凭据导致 7 个角色 SKIP，无权限断言失败。
|
||||
- [x] PC 只读视觉矩阵无 P1 blocker。
|
||||
- [x] 移动入口和企业微信渲染矩阵通过。
|
||||
- [x] 当前任务记录公网验证摘要和报告相对路径。
|
||||
|
||||
## Test Plan
|
||||
|
||||
部署前：
|
||||
|
||||
```bash
|
||||
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
|
||||
```
|
||||
|
||||
部署：
|
||||
|
||||
```bash
|
||||
SYNC_ENV=0 bash deploy/trialrun/deploy.sh
|
||||
```
|
||||
|
||||
部署后：
|
||||
|
||||
```bash
|
||||
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/`
|
||||
在新工单中引用
屏蔽一个用户