hyb-oa/.trellis/tasks/05-26-oaops1-seven-day-trial-prep/prd.md

OAOPS1 7 天真实试运行准备

Goal

为 OAOPS1 7 天小团队真实使用稳定化做好启动准备：确认公网只读基线、live smoke/OCR 条件、权限矩阵、人工业务闭环证据模板、每日巡检节奏和最终 OALAUNCH1 Go/No-Go 输入，确保后续启动窗口时不会把自动化通过误解为最终正式启用完成。

本任务只做准备和只读验证；不部署、不改生产配置、不写公网业务数据、不写企业微信、不执行付款、不做生产数据库恢复。

Scope

• 创建 OAOPS1 7 天真实试运行的 Trellis 执行合同。
• 汇总当前 OALAUNCH1/OAOPS1 已知缺口、启动条件和人工证据要求。
• 执行启动前只读预检，包括脚本语法、live smoke/OCR 条件、公网健康、企业微信配置和权限矩阵。
• 记录每日巡检、Day 7 汇总和 Go/No-Go 所需输入。
• 不进入真实 7 天计数，不执行业务写入或生产变更。

What I Already Know

• 当前没有活动任务，本任务从 Trellis planning 阶段创建。
• OALAUNCH1 最新结论仍是 PAUSED_MANUAL_CONFIRMATION，不是 PASS_OA_LAUNCH_READY。
• 仍阻断最终启用的关键门禁包括：
  • OAOPS1 真实业务闭环：报销/PDF OCR/审批/付款/AP、采购/费用/项目或合同、合同台账/归档/权限。
  • 连续 7 天稳定化起始日期和每日巡检证据。
  • 备份恢复演练或影子库恢复证据。
  • 数据治理培训和运营支持证据。
  • Day 7 人工 Go/No-Go 结论。
• 巡检脚本已完成改进：父级 summary 能传播子报告 finding，报告引用使用相对路径，隐私扫描不会打印原始敏感命中。
• 本机已有 live smoke env 文件；只读公网预检显示 live smoke、真实 OCR 样票、公网 /ready 和企业微信配置均满足启动前自动化条件。
• 本轮只读权限矩阵预检已通过：7 个角色、43 个正例、42 个负例，报告见 research/prep-permission-matrix/summary.json。

Assumptions

• 7 天窗口按自然日连续计算，必须由用户确认 OALAUNCH_STABILIZATION_START_DATE=YYYY-MM-DD 后才能进入正式计数。
• 真实业务写入只由人工在公网 OA 内完成；Codex 自动化只做只读巡检和证据汇总。
• 真实发票 PDF、合同/回单/归档资料只在 OA 或线下安全位置处理；Trellis task、docs、聊天和自动化报告只记录脱敏摘要、状态、数量和相对证据引用。
• 若某天出现 blocker，默认当天另建最小修复 Trellis task；不在 7 天窗口任务里扩大范围或临时绕过生产规则。
• 前端体验问题已确认需要治理，但不混入 OAOPS1 7 天试运行启动条件；试运行期间只记录真实用户卡点，试运行后另建前端体验成熟化 task 分批处理。

Requirements

• 固定 7 天窗口启动前输入：
  • 起始日期。
  • 当日负责人、问题登记负责人、暂停决策人。
  • 首批真实业务参与角色：员工、审批人、财务/出纳、管理员。
  • 每日巡检执行人和报告存放口径。
• 准备并确认人工业务闭环证据要求：
  • 至少 1 条真实报销 PDF OCR -> 审批 -> 付款批次 -> 银行回单 -> 已付款 -> AP 导出。
  • 至少 1 条采购/费用审批，并关联项目或合同。
  • 至少 1 条合同台账，记录归档位置摘要、权限边界和必要附件审计。
  • 资产台账 ASSET1D 后续抽查责任人或保管人。
• 每日巡检必须覆盖：
  • 公网 /ready。
  • live smoke 和真实 OCR 条件。
  • payment_batch_v1=force_on、erp_sync=force_off、冻结项未误开启。
  • 只读业务探针、移动入口、企业微信入口/渲染、隐私扫描。
  • 子报告 finding、SKIP、PARTIAL、PAUSED 均进入父级 summary。
• 最终 OALAUNCH1 输入必须能被 scripts/qa/run-oa-final-launch-readiness.sh 聚合：
  • OALAUNCH_STABILIZATION_START_DATE。
  • OALAUNCH_BACKUP_EVIDENCE。
  • OALAUNCH_PERMISSION_EVIDENCE。
  • OALAUNCH_BUSINESS_EVIDENCE。
  • OALAUNCH_POLICY_EVIDENCE 如需覆盖默认 OPOLICY1 证据。
  • OALAUNCH_MANUAL_ACCEPT 只能在 Day 7 人工决策后设置。
• 前端体验治理按后续独立 task 处理，初步分四类：
  • 减噪音：删除或弱化啰嗦说明，保留状态、下一步动作和异常原因。
  • 减步骤：前置常用动作，折叠低频配置，用默认值和自动带出减少跳转。
  • 重排信息架构：按员工、审批人、财务、管理员角色重排入口和首屏任务。
  • 视觉统一：统一间距、字号、按钮层级、卡片密度、表格和移动布局。

Acceptance Criteria

• 当前任务记录 7 天真实试运行的启动条件、边界和证据要求。
• 当前任务记录本轮只读准备预检结果和证据引用。
• 明确哪些事项启动前已具备，哪些仍需用户人工确认或执行。
• 明确每日巡检命令、最终汇总命令和预期状态解释。
• 明确不得自动执行的操作：部署、生产配置变更、真实业务写入、企业微信写入、真实付款、生产数据库恢复。
• Trellis 任务校验和治理检查通过。

Definition Of Done

• PRD 与准备清单完整。
• 只读预检结果保存在当前任务 research 下，且不含密码、token、Secret、完整账号、完整本地路径、合同正文、银行资料、原始票据或 raw payload。
• 用户拿到清楚的下一步人工输入清单：起始日期、负责人、每日问题登记方式、备份恢复证据计划、业务闭环样本安排。
• 不把本任务误归档为 7 天试运行完成；本任务只是启动准备。

Out Of Scope

• 不启动真实 7 天计数，除非用户明确确认起始日期。
• 不创建、提交、审批或付款真实单据。
• 不部署、不同步远端文件、不改公网 .env。
• 不写企业微信消息、通讯录、审批或回调数据。
• 不做生产数据库恢复、重置或迁移。
• 不启用图片 OCR、复杂 BPM、预算、ERP 写入、银行流水导入、真实支付接口、企业微信 HR 深镜像、应急接管、恢复回写或 RuleOps。
• 不在本准备任务中重构或美化前端页面；前端体验改进另建任务，避免干扰 7 天试运行启动判断。

Test Plan

• bash -n scripts/qa/run-oa-real-use-daily.sh
• bash -n scripts/qa/run-oa-final-launch-readiness.sh
• 只读公网条件预检：LIVE_SMOKE_BASE_URL=https://oa.hyinda.com node scripts/qa/check-live-smoke-env.mjs --json
• 只读权限矩阵预检：LIVE_SMOKE_BASE_URL=https://oa.hyinda.com OA_PERMISSION_MATRIX_REPORT_DIR=<task-research-dir> node scripts/qa/check-oa-permission-matrix.mjs
• python3 ./.trellis/scripts/task.py validate 05-26-oaops1-seven-day-trial-prep
• node scripts/qa/check-trellis-governance.mjs
• git diff --check

正式启动后每日命令另按用户确认执行：

bash scripts/qa/run-oa-real-use-daily.sh

Day 7 汇总命令另按证据路径补齐后执行：

OALAUNCH_STABILIZATION_START_DATE=<YYYY-MM-DD> \
OALAUNCH_BACKUP_EVIDENCE=<redacted-evidence-ref> \
OALAUNCH_PERMISSION_EVIDENCE=<redacted-evidence-ref> \
OALAUNCH_BUSINESS_EVIDENCE=<redacted-evidence-ref> \
bash scripts/qa/run-oa-final-launch-readiness.sh

Technical Notes

• 试运行事实源：docs/试运行与自动化验证手册.md、docs/管理员手册.md。
• live smoke 条件：docs/trialrun/公网LiveSmoke准备清单.md。
• 发布/试运行边界：docs/trialrun/发布试运行准备清单.md。
• 真机和企业微信人工验收：docs/trialrun/真机公网测试清单.md。
• Trellis spec：.trellis/spec/hyb-oa/deployment-trialrun.md、.trellis/spec/hyb-oa/docs-and-evidence.md、.trellis/spec/hyb-oa/security-privacy.md。
• 上游证据：
  • OALAUNCH1 closeout：.trellis/tasks/archive/2026-05/05-26-oalaunch1-final-readiness-closeout/research/initial-readiness/summary.json。
  • OAOPS1 巡检改进后验证：.trellis/tasks/archive/2026-05/05-26-oaops1-patrol-feature-review/research/oaops1-after-patrol-fix-final/summary.json。
  • 本任务权限矩阵预检：research/prep-permission-matrix/summary.json。
• 前端体验后续任务建议：试运行后创建 oa-frontend-experience-maturity，先覆盖首页、报销、审批、移动入口和财务/AP 高频页；低频后台页和合同/项目/资产页面放第二批。