同步遗留任务与运行手册状态(07-16-legacy-task-runbook-closeout)
这个提交包含在:
+27
-17
@@ -1,24 +1,25 @@
|
||||
# 发布试运行准备清单
|
||||
|
||||
**文档状态**:当前操作手册,用于首轮主线发布候选、live smoke 和小范围试运行准备。
|
||||
**适用范围**:`hyb-oa` MVP 首轮主线 A1-A8 之后,部署前和部署后试运行前。
|
||||
**文档状态**:当前操作手册,用于发布候选、live smoke 和连续试运行准备。
|
||||
**适用范围**:`hyb-oa` 当前发布候选的部署前、部署后和连续试运行前。
|
||||
|
||||
**当前状态(2026-05-14 / R7E)**:本清单保留 A1-A8、R5、R6 和 MIF7TD 的历史证据;当前事实已经推进到 R7E,`5491e92` 真机反馈修复已部署到试运行环境。R7E 浏览器业务线已通过,企业微信消息 deeplink、移动真机反馈和最终验收结论仍未关闭。
|
||||
**当前状态(2026-07-16)**:最后有部署和公网复检证据的来源基线为 `df26922`;7 月 P0 可信度修复只在本地 `main`,尚未 push、部署或完成公网复检。旧 7 天试运行只有 Day 1–Day 4 后中断,原目标未完成。新连续试运行必须等当前可信基线部署并完成公网来源/功能复核后,新建 Trellis task,从 Day 1 启动。
|
||||
|
||||
本文不替代 PRD、模块规约或 Issue CSV;它只回答“当前是否可以从本地可回归进入公网/企业微信/真实 OCR 验收”。
|
||||
本文不替代当前 Trellis task、PRD、模块规约或测试规约;旧 Issue CSV 只作历史审计。它只回答“当前是否可以从本地可回归进入公网/企业微信/真实 OCR 验收”。
|
||||
|
||||
## 1. 当前结论
|
||||
|
||||
- 首轮本地 release candidate:`537e608 A8 完成首轮主线总回归门禁`。
|
||||
- 当前公网 R5 运行代码:`b1ae41f W1-W3 实现企业微信个人应用消息通知`。
|
||||
- 2026-05 首轮本地 release candidate:`537e608 A8 完成首轮主线总回归门禁`。
|
||||
- 最后确认公网部署来源:`df26922`;未做当前公网只读检查时,不据此断言服务器此刻仍运行该提交。
|
||||
- 当前本地候选:含 7 月 P0 可信度修复的 `main`;发布前必须重跑 release gate,并核对 source/build SHA。
|
||||
- 主开发合同:`issues/2026-05-09_20-57-19-mvp-mainline-dev-kickoff.csv`,A1-A8 已全部 `DONE/DONE/DONE`。
|
||||
- 剩余主线批次合同:`issues/2026-05-10_10-48-03-mvp-remaining-mainline-closeout.csv`,B1-B5 已全部 `DONE/DONE/DONE`。
|
||||
- 当前状态:本地门禁已闭环;R4 部署预检、D3 受控同步、D4 只读复检、R5 公网 live smoke、真实 PDF OCR、PC/自动化审批链、企业微信真机入口、个人应用消息和 deeplink 均已完成。
|
||||
- 当前最大缺口:MIF7-7 已收口;若要启动 R7,必须另建 R7E 执行合同,固定试运行名单、时间窗口、回滚联系人和问题登记规则后再开始。
|
||||
- 历史状态:R4 部署预检、D3 受控同步、D4 只读复检、R5 公网 live smoke、真实 PDF OCR、PC/自动化审批链、企业微信真机入口、个人应用消息和 deeplink 均形成过证据。
|
||||
- 当前最大缺口:7 月本地可信基线尚未发布;旧 7 天任务中断。未来启动前必须新建 Trellis task,固定试运行名单、时间窗口、回滚联系人、问题负责人和暂停条件。
|
||||
|
||||
本清单中的 A1-A8/R5/R6/R7E 证据保留当时路线:OA 是首轮主业务系统和正式审批中心,企业微信只做入口、身份、通知、deeplink 和打卡原始采集边界。当前最新产品口径已由 WFOC/DBWFOC/WFDG/WDRG 覆盖:HR/考勤员工日常审批优先复用企业微信,OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台;财务、报销、采购、合同、项目、付款批次、AP、代账交接和高敏附件仍由 OA 主办。后续正式迁移前先读 [企微优先开发路线图](../企微优先开发路线图.md),再做 `WECOM-CAPABILITY-POC-V1`,不直接大规模开发。
|
||||
|
||||
## 2. 已完成证据
|
||||
## 2. 2026-05 历史已完成证据
|
||||
|
||||
| 范围 | 证据 | 结论 |
|
||||
| --- | --- | --- |
|
||||
@@ -76,7 +77,7 @@ node scripts/qa/check-live-smoke-env.mjs
|
||||
| 财务 | 报销复核、付款、导出、发票相关页面 | 管理员配置、员工敏感档案 | 财务能力可用,不越权到系统管理 |
|
||||
| 管理员 | 系统配置、权限、审计、企业微信配置 | 真实凭据和密钥明文 | 可配置系统,但接口不得返回 secret 明文 |
|
||||
|
||||
如发现服务端权限缺口,必须停止部署并拆独立修复 Issue;不得用前端隐藏临时绕过。
|
||||
如发现服务端权限缺口,必须停止部署并拆独立修复 Trellis task;不得用前端隐藏临时绕过。
|
||||
|
||||
R3 审计执行记录见 [`权限直连审计记录.md`](权限直连审计记录.md)。2026-05-10 本地自动化直连审计已通过,未发现权限泄漏;R4/D3/D4 旧部署预检长记录已在 DCL7 中从当前树移除,如需审计可从 `5da05eb` 的 git 历史恢复查看。
|
||||
|
||||
@@ -88,7 +89,7 @@ R3 审计执行记录见 [`权限直连审计记录.md`](权限直连审计记
|
||||
|
||||
- 当前生产 commit、部署目录和本地 release candidate 是否一致。
|
||||
- 生产 `.env` 必需项是否完整;检查时不得打印 secret。
|
||||
- 数据库迁移状态是否干净;若存在 drift,先备份并拆数据库治理 Issue。
|
||||
- 数据库迁移状态是否干净;若存在 drift,先备份并拆独立数据库治理 Trellis task。
|
||||
- 对象存储、附件目录、OCR provider、IM provider、企业微信回调域名是否与试运行目标一致。
|
||||
- Caddy/systemd 或既有部署脚本状态是否健康。
|
||||
- `/ready`、前端资源、企业微信 config 探活是否正常。
|
||||
@@ -128,7 +129,7 @@ LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readine
|
||||
2026-05-10 R5 credentialed 复查:
|
||||
|
||||
- 执行合同:`issues/2026-05-10_16-39-17-r5-credentialed-live-smoke.csv`。
|
||||
- `/home/shunli/.hyb-oa/live-smoke.env` 不存在,未执行 `source`。
|
||||
- 用户级 `~/.hyb-oa/live-smoke.env` 不存在,未执行 `source`。
|
||||
- `node scripts/qa/check-live-smoke-env.mjs`:`publicReady=true`,`wecom=ready`,`liveSmokeReady=false`,`liveOcrReady=false`。
|
||||
- `node scripts/qa/check-live-smoke-env.mjs --strict`:仍失败,缺公网 smoke 账号和 OCR live 文件或目录。
|
||||
- 结论:H3 公网自动化业务 smoke、H4 企业微信真机验收和 R6 小范围试运行仍不能开始。
|
||||
@@ -172,7 +173,16 @@ LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readine
|
||||
- `liveOcrReady=false` 时只能记录真实 OCR 条件缺失。
|
||||
- 手机企业微信入口必须用真实企业微信客户端补测;普通浏览器 UA 不等于真机通过。
|
||||
|
||||
## 7. 小范围试运行
|
||||
## 7. 连续试运行
|
||||
|
||||
当前规则:
|
||||
|
||||
- 旧 7 天任务不能从 Day 5 续跑,也不能补造缺失日期、人工闭环或 Go/No-Go。
|
||||
- 先部署并复核当前可信基线,再创建新的连续试运行 Trellis task。
|
||||
- 新任务必须固定参与人、连续窗口、回滚联系人、问题负责人、暂停条件和 Day 7 决策人,并从新的 Day 1 开始。
|
||||
- 每日 finding 回填当前 task;跨域或阻断问题另建最小修复 task,不在现场扩大范围。
|
||||
|
||||
以下为 2026-05 历史小范围试运行准备记录:
|
||||
|
||||
R5 已完成。R6 准备合同已创建:`issues/2026-05-11_10-23-41-r6-small-trialrun-prep.csv`。R6-2 已固定名单、窗口、回滚联系人和问题登记负责人;R6-3 自动检查已通过,且 WZ6 已创建真实财务候选账号 `wangzhiling`,只读核验为 `active`、角色 `employee,finance`。主 R6 仍保持 `TODO/TODO/TODO`,因为 R6-4 到 R6-6 的真实小范围流程、每日收口和结论尚未执行;不能直接把 R5/R6-3 通过解释为“自动进入正式试运行完成”。
|
||||
|
||||
@@ -185,15 +195,15 @@ R5 已完成。R6 准备合同已创建:`issues/2026-05-11_10-23-41-r6-small-t
|
||||
试运行规则:
|
||||
|
||||
- 每日固定收集问题,按阻断、重要、体验、后续需求分级。
|
||||
- 问题先登记到新 Issue CSV,不在试运行现场扩大范围。
|
||||
- 问题先登记到当前 Trellis task;跨域或阻断问题另建修复 task,不在试运行现场扩大范围。
|
||||
- P2 的预算、ERP、AI、完整差旅、复杂 BPM 继续不进入首轮试运行。
|
||||
- 出现权限泄漏、付款状态错乱、真实 OCR 大面积失败、企业微信入口无法进入时,应暂停试运行并回滚或修复。
|
||||
|
||||
## 8. QAOPS8 Go/No-Go 清单
|
||||
## 8. 2026-05 QAOPS8 历史 Go/No-Go 清单
|
||||
|
||||
本节是 `QAOPS8-17` 的上线和扩大试运行门禁。它只给当前时点结论,不替代 R7E 真实人工验收。
|
||||
本节是 `QAOPS8-17` 当时的上线和扩大试运行门禁,只保留历史结论,不替代未来新连续试运行的人工验收。
|
||||
|
||||
当前结论:`No-Go/Pause`。
|
||||
当时结论:`No-Go/Pause`。
|
||||
|
||||
| 门禁 | 当前状态 | 结论 |
|
||||
| --- | --- | --- |
|
||||
|
||||
+14
-3
@@ -2,7 +2,7 @@
|
||||
|
||||
**文档状态**:当前操作手册,用于真实手机、企业微信和移动浏览器人工验收。
|
||||
|
||||
**当前状态(2026-05-13 / MIF7TD)**:R6 已通过;`ME6-3` 代表性企业微信真机门禁已由 iPhone 12、iPhone 14、Redmi K60 企业微信主流程反馈关闭。MIF7/MIF7T 已完成本地整改、公网部署、公网匿名复检和带凭据 live smoke/OCR 复检。R7 未真实启动;R7 草案、OPS7 Runbook 和 DOC7 用户材料不代表已启动或已上线。
|
||||
**当前状态(2026-07-16)**:最后有部署和公网复检证据的来源基线为 `df26922`;7 月 P0 可信度修复只在本地 `main`,尚未 push、部署或完成公网复检。旧 7 天试运行只有 Day 1–Day 4 后中断。新连续试运行必须等当前可信基线部署并复核后,新建 Trellis task,从 Day 1 启动。下文 2026-05 的设备、账号和通过结果只对当时部署来源有效。
|
||||
|
||||
适用范围:使用真实手机访问 `https://oa.hyinda.com`,重点验证企业微信工作台、手机浏览器、PDF 发票上传、真实 OCR 状态反馈和移动核心流程。
|
||||
|
||||
@@ -10,7 +10,12 @@
|
||||
|
||||
- 测试日期:
|
||||
- 测试人:
|
||||
- 当前 Trellis task:
|
||||
- 公网地址:`https://oa.hyinda.com`
|
||||
- 预期部署来源 commit:
|
||||
- `/ready` observed build SHA:
|
||||
- 公网 bundle build marker:
|
||||
- 是否确认覆盖当前候选基线:是 / 否 / 阻塞
|
||||
- 验收状态:`TODO` / `PASS` / `FAIL` / `BLOCKED` / `PAUSED`
|
||||
- 账号角色:专用测试员工 / 测试主管 / 测试负责人 / 测试财务 / 测试财务主管 / 测试管理员
|
||||
- 设备:iPhone / Android
|
||||
@@ -20,6 +25,8 @@
|
||||
- 网络:公司 Wi-Fi / 4G / 5G / 其他
|
||||
- 测试发票样本:PDF
|
||||
|
||||
执行前置:必须核对实际部署来源。若公网仍只能证明 `df26922`,本轮结论只能覆盖该历史部署基线,不能宣称已验证 7 月 P0 修复;新连续试运行不得借用旧真机结论补作新的 Day 1–Day 7 证据。
|
||||
|
||||
## 企业微信入口
|
||||
|
||||
- 从企业微信工作台点击海音达工作台应用。
|
||||
@@ -81,7 +88,9 @@
|
||||
- 企业微信真机验收只覆盖工作台入口、绑定/免登录、移动布局、待办、详情、PDF 上传入口和通知 deeplink;当前 `oa_smoke_01 -> SMOKE002` 与 `oa_smoke_02 -> SMOKE101` 足够覆盖“提交人 + 审批人”的核心移动体验。
|
||||
- 负责人、财务、财务主管深层链路需改用当前 active 角色账号或新建带企微绑定的测试账号;旧 `SMOKE201/301/302` 只保留为 2026-05-10 自动化历史证据,不再作为当前验收入口。
|
||||
|
||||
### PC/自动化审批链验收矩阵
|
||||
以下账号、角色和结果为 2026-05 历史基线。新一轮必须按当前 Trellis task 重新核验账号 active、角色、绑定和可见范围,不直接复用“当前账号”结论。
|
||||
|
||||
### 2026-05 PC/自动化审批链历史验收矩阵
|
||||
|
||||
| 验收项 | 验收方式 | 账号角色 | 提交或处理 | 期望结果 | 结果 | 证据位置 |
|
||||
| --- | --- | --- | --- | --- | --- | --- |
|
||||
@@ -92,7 +101,7 @@
|
||||
| 系统管理员无业务审批权 | PC/自动化 | 当前 active admin | 尝试审批测试单据 | 不允许仅凭 `admin` 审批 | 需按 WOUA-FIX 后账号重跑 | 后续新证据 |
|
||||
| 财务复核与付款/导出 | PC/自动化 | 当前 active 财务角色账号 | 处理已批准测试单据 | 按财务与财务主管权限处理 | 需按 WOUA-FIX 后账号重跑 | 后续新证据 |
|
||||
|
||||
### 企业微信/移动体验验收矩阵
|
||||
### 2026-05 企业微信/移动体验历史验收矩阵
|
||||
|
||||
| 验收项 | 企业微信测试成员 | OA 账号 | 期望结果 | 当前结果 | 截图或录屏位置 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
@@ -135,6 +144,7 @@
|
||||
- 记录失败时间、账号角色、设备、企业微信版本、页面 URL、操作步骤。
|
||||
- 对 OCR 问题记录发票文件名、文件类型、上传时间、终态、耗时。
|
||||
- 对企业微信入口问题记录是否从工作台进入、是否已绑定、回跳 URL。
|
||||
- 记录预期来源 commit、`/ready` observed build SHA 和公网 bundle marker;通过结论只对实际核对的来源基线有效。
|
||||
|
||||
## 通过标准
|
||||
|
||||
@@ -143,3 +153,4 @@
|
||||
- 报销、票据、审批、我的、通知主流程可完成。
|
||||
- PDF 发票上传和真实 OCR 有明确状态变化和终态反馈。
|
||||
- 已知问题文案和原始码值不再出现。
|
||||
- 来源 commit、`/ready` build SHA 和公网 bundle marker 一致;缺失或不一致时不得给出当前候选通过结论。
|
||||
|
||||
+27
-14
文件差异因一行或多行过长而隐藏
+15
-8
@@ -2,9 +2,9 @@
|
||||
|
||||
**文档状态**:当前唯一文档入口。
|
||||
**分类**:入口索引。
|
||||
**适用时间**:DCL7 之后。
|
||||
**关联 Issue**:`GOV8`。
|
||||
**最近审计**:2026-05-18。
|
||||
**适用时间**:TRELLIS2 及 2026-07-16 状态收口之后。
|
||||
**关联治理**:当前 Trellis task;`GOV8` 只作历史治理来源。
|
||||
**最近审计**:2026-07-16。
|
||||
**不得误读**:本文只指示当前事实源和读取顺序;历史 Issue CSV 只能用于追溯,不直接生成新开发任务。
|
||||
**治理口径**:中文优先,物理精简,优先复用已有文档。已确认不用的历史文档不放 `docs/archive/`,直接从当前工作树移除;需要时从 git 历史恢复。
|
||||
|
||||
@@ -18,7 +18,14 @@
|
||||
- 新需求或试运行反馈:优先创建或更新当前同类型 Trellis task;只有跨业务域、跨风险等级或阶段收口后,才新建下一版 task。
|
||||
- 新增说明、方案、审计或证据:优先补充现有事实源、模块规约、操作手册、证据文档或当前 Trellis task;只有现有文档无法承载、需要独立审计证据或用户明确要求时,才新建文档并登记本索引和事实源矩阵。
|
||||
|
||||
## 最近事实源链
|
||||
## 当前可信基线(2026-07-16)
|
||||
|
||||
- 最后有部署和公网复检证据的来源基线为 `df26922`;这是一条历史部署来源证据,未做当前公网只读检查时,不据此断言服务器此刻仍运行该提交。
|
||||
- 当前本地 `main` 包含 7 月 P0 可信度修复和后续本地收口,尚未 push、部署或完成公网复检,不能视为线上已生效。
|
||||
- 旧 OAOPS1 7 天真实试运行只有 Day 1–Day 4,后续中断,缺 Day 5–Day 7、现场人工业务闭环和 Day 7 Go/No-Go;归档只表示生命周期关闭,不代表目标完成。
|
||||
- 下一轮真实连续试运行必须等待当前可信基线部署并完成公网复核,再新建 Trellis task,从新的 Day 1 连续启动。
|
||||
|
||||
## 历史事实源链(截至 2026-05)
|
||||
|
||||
R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> MIF7/MIF7T(公网部署与带凭据公网复检已收口) -> DG8 -> DG9 -> R7E -> FBA -> QAOPS9/P2D -> P2-ORG -> P2-FIN-DECISION -> P2-FIN-V1 -> P2-OCR-SAMPLE -> P2Q -> P2AUTO -> P2AF -> P2-FIN-LIVE-DECISION -> P2-FIN-LIVE -> PRELAUNCH -> CASHIER-VOUCHER-V1 -> LAUNCH-DEPLOY-FINANCE -> FIN-PROD-ENABLE -> ACCOUNTING-HANDOFF-V1 -> SYSTEM-COMPLETE-GATE -> LAUNCH-OPS-V1 -> REQ-COMPLETE-AUDIT -> ATTV1 -> LAUNCH-AUTO-OPS-V1 -> AUTO-REMAINING-CLOSEOUT -> HR-WECOM-DIRECTORY-V1 -> HRWD-CONTACT-LIVE-TEST -> WCFB -> WFOC -> DBWFOC -> WFDG -> WDRG -> WCP1 -> WCPC -> WHMS -> WHMSLIVE -> WOUA -> WAPI -> WRRA -> WOUA-FIX -> WRV1 -> WRA1 -> WMSG1 -> WAPC1 -> WAPC2 -> WPROC1 -> WPROC2 -> WAPC2F dry-run -> WAPC2FLIVE -> WCBK1 -> WEGOV1 -> WACP3/WACP3R -> WREAD1 自动汇总 -> WREAD1F 新样例 -> WREAD1 真机确认 -> WADM1 自建留存模型设计 -> WARCH1 最小审批历史留存 -> WARCH2 正式只读历史查询 -> WROAD2+OPS 受控上线与每日巡检 -> WARCH3 归档稳定化自动巡检 -> WCHECK1 打卡摘要留存 -> WEXT1 外出/加班 dry-run -> WOPS1 巡检告警降噪 -> WROAD2-CLOSEOUT 三天验收 -> WROAD2-BIZ1 三天业务冒烟 -> WAPPR1 审批规则规范化 -> WRULE1 审批链校验器 POC -> WAUTO1 自动证据汇总 -> WEXT1LD live 前 dry-run -> WFULLSMOKE1 三天全域最终目标测试 -> WROUTE2 测试号收口到最小镜像路线锁定 -> WTCLOSE1 小团队自动审批规则与测试号全域收口 dry-run -> WTCLOSE2 测试号最终收口与证据复核 -> WTCLOSE2F 远端可信 IP 执行口径修正 -> WREMOTE1 远端可信 IP 收口 -> WFULLSMOKE2 全域 smoke -> WEXT1-FORMAL/WEXT1F 正式模板外出/加班测试 -> OAOPS1 小团队全员真实使用稳定化 -> ASSET1 电子资产与固定资产统一台账 -> OSMOKE1 OA-only smoke 账号治理与公网自动化恢复 -> OALAUNCH1 最终启用前收口与 Go/No-Go 门禁 -> OMAT1 成熟度缺口审查 -> OPOLICY1 制度与 OA 对齐 -> OAFRONT6 前端成熟化小步收口(标题/资产/移动/合同/长编号已部署并公网复测通过)-> OAKISS1 全业务流程 KISS 审查 -> PCDESIGN1 PC 全页面设计审查 -> TRELLIS1 Trellis 主导开发流程迁移 -> TRELLIS2 官方 Trellis task 执行合同 -> 后续再按需问答 WREAL1/最小镜像。
|
||||
|
||||
@@ -81,7 +88,7 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
|
||||
- WARCH2 是 WARCH1 后的正式只读历史查询合同:新增只读 OA DB 查询 API 和 PC/移动历史页,只覆盖请假/补卡已归档历史;页面不提供审批动作,不进入待办语境;已完成 `SYNC_ENV=0` 公网部署、`/ready`、未登录 401 和远端离线归档复跑。
|
||||
- WROAD2+OPS 是 WARCH2 后的受控上线与每日巡检合同:范围固定测试账号 `SMOKE002 -> SMOKE101`,管理员观察和告警员工号使用 `HYD000006`(`wangshunli` 的员工号),3 天每日触发脚本;巡检可用 `WECOM_ARCHIVE_WRITE=1` 写 OA 自建留存库,不写企业微信、不创建模板或审批单。Day 0 公网报告 `/app/artifacts/qa-flow/wroad2-ops-20260520-041941/summary.json` 为 `PASS_WITH_FINDINGS`,主链路通过并保留可解释 finding。后续优先 WOPS1 告警降噪、WROAD2-CLOSEOUT 三天验收;验收后先问答是否进入 WEXT1-FORMAL 正式模板外出/加班测试,再由四类测试号证据决定是否询问真实小范围试用。
|
||||
|
||||
## 当前活跃治理流
|
||||
## 治理流台账(历史 Issue 只作追溯)
|
||||
|
||||
后续不再为每次聊天、小反馈或单点修正单独创建 Issue CSV。同类型、同目标、同风险域的任务优先进入同一个 Trellis task 或子任务,直到该治理流完成明确阶段。
|
||||
|
||||
@@ -168,10 +175,10 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
|
||||
| `WTCLOSE2F` | `issues/2026-05-22_11-10-06-wecom-test-account-closeout-remote-only-v1.csv` | 当前 WTCLOSE2 远端可信 IP 执行口径修正 | WTCLOSE2 真实运行命令改为 `bash scripts/qa/run-wecom-test-account-final-closeout.sh --remote`,由部署服务器 server 容器执行;本地直接执行默认拒绝跑企微链路 | 本地只做合同、语法、文档和静态门禁;此前本地缺 env/DB 的 WTCLOSE2 输出不作为企微业务阻断证据 |
|
||||
| `WREMOTE1` | `issues/2026-05-22_12-34-41-wecom-remote-closeout-and-full-smoke-v1.csv` | 当前远端收口、全域 smoke 和正式模板外出/加班测试路线 | WFULLSMOKE2 必须使用 `--remote` 在部署服务器执行;外出/加班使用正式模板由 `SMOKE002` 人工提交、`SMOKE101` 审批,系统只读补偿、归档和 WRULE1 | 允许 OA `TEST-SMOKE-WFULL` 测试数据;不写企业微信、不自动创建外出/加班模板或审批单;真实员工信息只通过 `/tmp/hyb-oa-wreal1.env` 临时文件 |
|
||||
| `WEXT1F` | `issues/2026-05-22_14-23-19-wecom-formal-outing-overtime-evidence-v1.csv` | 当前正式模板外出/加班证据脚本:人工提交后从部署服务器只读收证据 | 新增 `WEXT1F_MANUAL_CONFIRMATION=SMOKE002_SUBMITTED_SMOKE101_REVIEWED bash scripts/qa/run-wecom-formal-outing-overtime-evidence.sh --remote`;显式拉取 `outing/overtime` 且按 `creator=SMOKE002` 过滤,写 OA 留存仅限 `WECOM_ARCHIVE_WRITE=1` + `--persist-to-db`;随后做离线归档读取和 WRULE1 | 不创建模板、不自动提交审批、不写企业微信、不启用真实员工;未有人工作业或缺确认标记时只可得到人工缺口结论 |
|
||||
| `OAOPS1` | `issues/2026-05-22_20-09-22-oa-real-use-stabilization-v1.csv` | 当前 OA 主办域真实使用稳定化:7 天小团队全员边用边修 | 新增 `scripts/qa/run-oa-real-use-daily.sh`,每日只读核验公网 ready、live smoke、feature flag、报销/PDF OCR、审批、采购/费用、合同台账、项目、付款批次、AP、移动/企微入口和隐私边界 | 允许真实业务数据进入公网 OA 并按审计保留;真实写入由人工完成;涉密合同正文、敏感报价、成本细节、银行流水原件、未脱敏票面不进仓库/聊天/报告;图片 OCR、复杂 BPM、预算、ERP、银行流水导入、真实支付直连、企微 HR 深镜像、应急接管、恢复回写、RuleOps 继续冻结 |
|
||||
| `OAOPS1` | `issues/2026-05-22_20-09-22-oa-real-use-stabilization-v1.csv` | 历史运行中断:计划 7 天,实际只有 Day 1–Day 4,缺人工业务闭环和 Day 7 Go/No-Go;任务归档只表示生命周期关闭,不代表目标完成 | `scripts/qa/run-oa-real-use-daily.sh` 及 Day 1–Day 4 记录保留为历史证据;旧 runner 曾存在 `SKIP` 假绿风险,不能据此补证最终启用 | 未来由新的 Trellis task 在当前可信基线部署并复核后从 Day 1 连续重启;不得补造 Day 5–Day 7;冻结项继续冻结 |
|
||||
| `ASSET1` | `issues/2026-05-22_21-18-33-oa-asset-governance-v1.csv` | 当前统一资产台账 V1:电子资产 + 固定资产共用现有资产模块 | 扩展 `AssetCard` 为 `FA/EA-DOC/EA-SYS/EA-REPO/EA-BKP`,新增资产大类、敏感级别、负责人/保管人、归档位置、外部引用、hash、历史验证编号、最近验证时间和脱敏索引 dry-run;前端资产页支持类型/敏感级别/编号搜索 | 代码仓库仍由 Git 管理;`EA-ACC` 暂缓;不保存密码、token、Secret、源码包、完整配置、涉密正文、真实完整路径、敏感报价、银行流水原件或未脱敏票面 |
|
||||
| `OSMOKE1` | `issues/2026-05-23_13-59-52-oa-only-smoke-account-governance-v1.csv` | 当前 OA-only smoke 账号治理:恢复公网 OA 自动化高权限测试账号,不再额外申请企微账号 | 新增 OA-only smoke 修复脚本、企微/OA 一致性审计豁免 `oaOnlySmokeExempted`、公网角色 readiness 检查,并接入 OAOPS1 每日巡检 | 只处理私有 env、显式员工号 allowlist 或 `SMOKE*`/`smoke-*`/测试命名命中的 smoke 标识;默认 dry-run,apply 必须 `OA_ONLY_SMOKE_REPAIR_APPLY=1`;不写企业微信、不重置密码、不影响真实员工、不执行 EA-DOC live 导入 |
|
||||
| `OALAUNCH1` | `issues/2026-05-23_16-49-39-oa-final-launch-readiness-v1.csv` | 当前最终启用前收口与 Go/No-Go 门禁:在 OAOPS1/ASSET1D 之上增加业务闭环、权限、备份恢复、数据治理、培训和 Day 7 决策 | 新增 `scripts/qa/run-oa-final-launch-readiness.sh`,默认只读聚合 OAOPS1、ASSET1D、权限矩阵、备份恢复演练和人工 Go/No-Go 证据,输出 `PASS_OA_LAUNCH_READY` / `PASS_WITH_FINDINGS` / `PAUSED_MANUAL_CONFIRMATION` / `SKIP/BLOCKED_BY_EXTERNAL_CONFIG` | 不创建业务数据、不执行付款、不写企业微信、不恢复数据库;未达到 `PASS_OA_LAUNCH_READY` 前不得宣布最终正式启用完成 |
|
||||
| `OALAUNCH1` | `issues/2026-05-23_16-49-39-oa-final-launch-readiness-v1.csv` | 历史最终启用门禁来源:业务闭环、权限、备份恢复、数据治理、培训和 Day 7 决策要求仍可复用;未来实际执行由新 Trellis task 承接 | `scripts/qa/run-oa-final-launch-readiness.sh` 默认只读聚合相关证据,输出 `PASS_OA_LAUNCH_READY` / `PASS_WITH_FINDINGS` / `PAUSED_MANUAL_CONFIRMATION` / `SKIP/BLOCKED_BY_EXTERNAL_CONFIG` | 不创建业务数据、不执行付款、不写企业微信、不恢复数据库;未取得新任务完整证据前不得宣布最终正式启用完成 |
|
||||
| `OMAT1` | `issues/2026-05-23_17-20-00-oa-maturity-gap-review-v1.csv` | 当前成熟度缺口审查台账:按 MAGI 审视/执行/提升轮次,对标国内主流 OA、协同、低代码、财务和资产系统,记录每个问题或建议供用户逐项采纳、暂缓或否决 | 已登记最终启用、真实业务闭环、权限、备份恢复、运营支持、流程配置、报表、财务月结、合同、采购、资产、HR 镜像、移动体验、数据治理、SLO、集成、知识档案、主数据、UX、AI 边界、国内对标来源、小团队取舍原则、用户决策回填、成熟度证据视图和最低非功能基线等候选项 | 本台账只做审查和决策,不直接触发业务代码实现;采纳项必须另建或延续对应 Trellis task,并满足 OALAUNCH1 门禁 |
|
||||
| `OPOLICY1` | `issues/2026-05-24_01-20-52-oa-policy-system-alignment-v1.csv` | 当前制度与 OA 对齐合同:先把外部制度包裁剪为小团队 V1,再回写 OA 事实源和启用门禁 | 已固化制度参数、资料留存、用印台账、审批异常 SOP、制度签收和 P2 冻结边界;预算硬控、复杂招采、电子签章、完整电子档案系统、ERP/银行深集成和 AI 自动改规则不作为正式启用前置条件 | 本合同优先制度和事实源调整;现有合同台账/资产台账/公告能力可承载 V1,不立即做 schema 或业务代码改造 |
|
||||
| `OAFRONT6` | `issues/2026-05-25_12-29-03-oa-frontend-maturity-small-step-v1.csv` | 当前前端成熟化小步收口:承接 OAFRONT5 部署后 PC 硬问题清零和设计审计;审批规则路由标题、资产台账详情分区、移动视觉矩阵稳定等待、合同台账表单分组和长编号压缩均已实施部署,公网 PC 只读视觉矩阵复测 `PASS_PC_READONLY_VISUAL_READY` 且 `findingCount=0`;Portal 继续后置观察 | 页面改动使用 `frontend-design` 做视觉裁决,并读取 `docs/产品设计规则.md` 的产品体验事实和 OALAUNCH1 启用门禁;后续 Portal 仍需按真实使用反馈推进 | 不写公网业务数据;不替代真实业务闭环、备份恢复、7 天稳定化或 Day 7 Go/No-Go |
|
||||
@@ -236,7 +243,7 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
|
||||
|
||||
| 文档 | 边界 |
|
||||
| --- | --- |
|
||||
| [R7 扩大试运行草案](./trialrun/R7扩大试运行草案.md) | 只做 R7 准备草案;真实执行看 R7E 连续合同 |
|
||||
| [R7 扩大试运行草案](./trialrun/R7扩大试运行草案.md) | 只作历史准备材料;R7E 也已是历史证据,未来真实连续试运行由新 Trellis task 从 Day 1 承接 |
|
||||
| [OPS7 运维交接 Runbook](./trialrun/OPS7运维交接Runbook.md) | 不代表已执行生产配置变更、恢复演练或回滚 |
|
||||
| [R7 用户手册与 FAQ](./trialrun/R7用户手册与FAQ.md) | 只描述已实现能力,不承诺预算、ERP、AI、完整差旅或复杂 BPM |
|
||||
|
||||
|
||||
+23
-14
@@ -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。
|
||||
|
||||
在新工单中引用
屏蔽一个用户