同步遗留任务与运行手册状态（07-16-legacy-task-runbook-closeout）

2026-07-16 20:50:26 +08:00
@@ -2,7 +2,7 @@

 **文档状态**：当前操作手册，用于本地、公网、企业微信和真实 OCR 试运行验证。

-**当前状态（2026-05-17 / SYSTEM-COMPLETE-GATE）**：R7E、PRELAUNCH、FIN-PROD-ENABLE、ACCOUNTING-HANDOFF-V1、SYSTEM-COMPLETE-GATE 和 LAUNCH-OPS-V1 均已收口；公网 `payment_batch_v1=force_on`，`erp_sync=force_off`。当前正式能力保持 PDF-only OCR，不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水。后续新增移动或企业微信门禁仍必须保留真机证据，自动化、公网视觉矩阵和 live smoke 不能替代未来新增真机验收。
+**当前状态（2026-07-16）**：最后有部署和公网复检证据的来源基线为 `df26922`；未做当前公网只读检查时，不据此断言服务器此刻仍运行该提交。7 月 P0 可信度修复只在本地 `main`，尚未 push、部署或完成公网复检。旧 7 天试运行只有 Day 1–Day 4 后中断，缺人工业务闭环和 Day 7 Go/No-Go；下一轮必须待当前可信基线部署并复核后，新建 Trellis task，从 Day 1 连续启动。正式能力继续保持 PDF-only OCR，不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水。

 本文用于 hyb-oa 本地、企业微信和公网试运行。默认策略是：能自动化的先自动化，自动化无法覆盖的才请求人工配合。

@@ -10,13 +10,14 @@

 ## 入口顺序

-1. 读取 `AGENTS.md`。
-2. 读取最新 `issues/*.csv`。
-3. 按任务读取事实源：
+1. 读取 `.trellis/workflow.md` 和当前 Trellis task 的 PRD/设计。
+2. 读取 `.trellis/spec/hyb-oa/` 与任务对应的业务事实源。
+3. 读取 `AGENTS.md` 并检查 `git status --short`，保护已有改动。
+4. 按任务读取事实源：
   - 页面体验事实：`docs/产品设计规则.md`；视觉与交互裁决使用 `frontend-design`
   - 报销发票：`docs/报销发票附件规则.md`
   - Agent 交付：`docs/Agent开发交付实践.md`
-4. 检查 `git status --short`，保护用户已有改动。
+5. 旧 `issues/*.csv` 只在需要历史追溯或外部导出时读取，不作为新任务执行合同。

 ## 本地验证

@@ -58,7 +59,7 @@ cd client && npm run build
 - PC viewport: 1440x960。
 - mobile viewport: 基础 390x844；涉及移动布局、企业微信或 R6 移动反馈时必须扩展到 320x568、360x740、375x667、390x844、393x873、414x896、430x932。
 - 企业微信 UA 使用 iPhone + `wxwork` 标识。
- 截图放在 `output/playwright/<issue-id>/`。
+- 截图放在 `output/playwright/<trellis-task-id>/`。

 移动端必须检查：

@@ -93,7 +94,7 @@ node scripts/qa/create-real-device-report.mjs
 - `PASS`：代表性真机和必要人工确认均通过。
 - `FAIL`：真机复现阻断或严重问题，必须登记设备、账号、URL、步骤和证据位置。
 - `BLOCKED`：缺少测试账号、企业微信后台配置、样票或网络等前置条件。
- `PAUSED`：用户或现场条件暂停验证；自动化通过也不能据此关闭真机门禁或把相关 Issue 标为完成。
+- `PAUSED`：用户或现场条件暂停验证；自动化通过也不能据此关闭真机门禁或把当前 task 验收标为完成。

 ### WF8 通知渠道验收矩阵

@@ -103,7 +104,7 @@ WF8 阶段采用“两渠道验收 + 邮件冻结说明”：站内通知和企
 | --- | --- | --- | --- | --- |
 | 站内通知 | 测试用户、审批或业务事件、OA 登录态 | 触发待办或状态变化；目标用户进入 OA 通知或目标业务页；核对未读、标题、目标类型和目标 ID | 通知存在，deeplink 指向具体 OA 目标，权限拦截正确，非目标用户不可见 | 只跑后端单测不能替代 PC 或移动页面可达性 |
 | 企业微信个人应用消息 | `IM_NOTIFIER_ENABLED=true`、个人应用消息渠道启用、员工已绑定企业微信 userId、应用可见范围正确、公网域名可访问 | 触发待办；管理员检查 delivery；审批人在手机企业微信收到消息并点击回 OA | delivery 成功且无 `invaliduser`、`unlicenseduser`、可见范围错误；手机端能进入 OA 移动审批或业务详情 | 企业微信 UA 自动化不能替代代表性真机消息接收和点击回流 |
-| 邮件通道 | 用户确认邮件为正式通道、SMTP provider 和发件域确定、密钥存放和退信处理方案批准 | 当前 WF8 不执行；Issue 和规约记录冻结原因及解锁条件 | 当前结论为冻结或 SKIP，不参与 Go/No-Go PASS 统计 | 站内或企业微信成功不能证明邮件通道成功 |
+| 邮件通道 | 用户确认邮件为正式通道、SMTP provider 和发件域确定、密钥存放和退信处理方案批准 | 当前 WF8 不执行；当前或独立 Trellis task 及对应规约记录冻结原因和解锁条件 | 当前结论为冻结或 SKIP，不参与 Go/No-Go PASS 统计 | 站内或企业微信成功不能证明邮件通道成功 |
 | 失败追溯 | 通知 provider 可模拟失败或测试渠道返回失败 | 模拟发送失败；检查 `notificationDelivery` 摘要、错误类型、重试次数和管理员可见性；确认主业务不回滚 | 失败可追溯、敏感字段不外泄、业务状态保持正确 | 日志片段不能替代投递记录或管理员查询证据 |

 验收结论必须区分四类环境：
@@ -120,7 +121,13 @@ node scripts/qa/check-live-smoke-env.mjs
 LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readiness.sh
 ```

-### SYSTEM-COMPLETE-GATE 完成门禁
+### 当前可信度判定
+
+- 聚合状态为 `PASS` 时仍必须检查必要子项和 `findingCount`；必要 live smoke、真实 OCR、权限、来源校验出现 `SKIP`、`PARTIAL`、`MISSING` 或 SHA 不匹配时，不得给出最终 clean PASS。
+- 本地 runner 通过只证明当前代码；必须核对部署来源 commit、`/ready` observed build SHA 和公网 bundle marker，才能证明公网使用了同一基线。
+- 新连续试运行前必须确认部署 runner 已包含 7 月 P0 修复；旧 Day 1–Day 4 报告不得补证新的正式启用结论。
+
+### 2026-05 SYSTEM-COMPLETE-GATE 历史完成门禁

 系统开发完成收口采用以下最小门禁：

@@ -133,7 +140,7 @@ cd client && E2E_BASE_URL=https://oa.hyinda.com npx playwright test tests/e2e/dg

 完成门禁只核验系统可正式使用，不扩展功能边界。`payment_batch_v1` 应保持 `force_on`，`erp_sync` 应保持 `force_off`。图片发票 OCR、真实支付接口、ERP 实时凭证、银行流水导入、复杂 BPM、审批设计器和重预算控制继续冻结。

-### LAUNCH-OPS-V1 首周运营检查
+### 2026-05 LAUNCH-OPS-V1 历史首周运营检查

 正式使用首周每日检查：

@@ -143,7 +150,7 @@ cd client && E2E_BASE_URL=https://oa.hyinda.com npx playwright test tests/e2e/dg
 - 出纳上传银行回单后再执行 OA 已付款标记；银行流水和回单原件由出纳从银行侧导出给代账，不导入 OA。
 - 当天问题按时间、角色、页面、步骤、影响等级和处理结论登记。

-无法登录、无法审批、无法提交核心单据、付款状态错误、权限越权、`/ready` 异常或冻结项被误开启时，结论应为 Pause，并另建最小修复 Issue；不得用重置数据库或生产恢复临时绕过。
+无法登录、无法审批、无法提交核心单据、付款状态错误、权限越权、`/ready` 异常或冻结项被误开启时，结论应为 Pause，并另建或更新最小修复 Trellis task；不得用重置数据库或生产恢复临时绕过。

 发布候选进入公网或小范围试运行前，先按 [`docs/trialrun/发布试运行准备清单.md`](trialrun/发布试运行准备清单.md) 完成证据整理、权限直连审计、部署预检、live smoke 和试运行分级。

@@ -275,8 +282,10 @@ PROJECT_CLOSURE_CHECKLIST_ENABLED=true

 每轮交付收口至少包含：

- Issue CSV 状态真实。
- 自动化命令和结果记录在最终回复。
- 视觉截图路径记录。
+- 当前 Trellis task 的 PRD、验收、状态和提交引用真实。
+- 明确区分本地 commit、部署来源 commit 和公网复检结果。
+- 自动化命令、结果和必要视觉证据路径记录完整。
 - 已知阻塞明确归类为代码、测试、环境、数据或人工配置。
+- task validate、Trellis governance 和任务要求的必要门禁通过。
+- 历史 Issue CSV 保持审计可追溯，但不要求作为当前状态合同。
 - 中文分批 commit。