文件
hyb-oa/.trellis/tasks/07-16-legacy-task-runbook-closeout/design.md
T

4.0 KiB

遗留任务与运行手册收口设计

Safety Boundary

本任务只修正任务状态、验证证据和现行文档事实,不修改业务代码、数据库、权限、接口或页面设计。任何验证失败都作为后续 finding,不能通过扩大本任务范围来掩盖。

Execution Order

1. 冻结基线

  • 记录当前 main、工作树、活动任务和最后有证据的公网部署基线。
  • 确认本任务开始时没有未识别脏文件。
  • 不 fetch、push、部署或访问带凭据公网环境。

2. 收口已完成的业务编辑模板任务

  • 核对 1428cc4 实现提交、46fa609 部署证据及 PRD 全部验收项。
  • 运行 task validate 和静态入口复核。
  • 补齐 task commit/notes 后归档,不重跑公网部署。

3. 验收页面右上角操作区任务

  • 核对 dcf34d7 后相关实现是否发生变化。
  • 运行前端 typecheck/build、聚焦 r103-cross-page-ui-consistency Playwright、相关静态结构检查。
  • 复核采购、合同、项目、资产、付款、应付账款、票据标题区,至少确认“一主操作 + 最多一个更多”和列表级工具下沉。
  • 通过时回填 7 项验收、验证结果、实现提交和未部署事实并归档。
  • 失败时保留任务为未完成,记录页面、复现方式和影响,另建修复 task。

4. 关闭历史中断的 7 天试运行

  • 在旧 PRD/implement/task notes 中增加 closeout 结论:仅 Day 1–Day 4,缺 Day 5–Day 7、人工闭环和 Go/No-Go。
  • 记录旧 readiness 假绿风险,禁止将旧 findingCount=0 当作最终启用证据。
  • 明确后续必须在当前可信基线部署后新建连续 7 天任务,从 Day 1 重启。
  • 再归档旧任务;归档状态只表示生命周期关闭。

5. 同步现行运行手册

  • docs/试运行与自动化验证手册.md:入口改为 Trellis task,更新本地/公网/正式启用状态。
  • docs/文档索引.md 与 docs/文档事实源状态矩阵.md:登记 7 月 P0 本地可信基线、未部署事实和旧试运行关闭语义。
  • docs/trialrun/发布试运行准备清单.md:将历史 A1–R7E 内容降为背景,当前入口改为新发布/试运行流程。
  • docs/trialrun/真机公网测试清单.md:删除“R7 未启动”等过时现状声明,保留仍有效的真机验收步骤。
  • 不批量重写历史 Issue CSV、归档 task 或历史试运行报告。

6. 质量与复核

  • 运行三个遗留任务和当前任务的 validate(归档后按实际路径检查)。
  • 运行 Trellis governance、process baseline、文档 registry/full audit 和 git diff --check。
  • 清理本轮构建/Playwright生成物,不删除既有历史 output/ 或 artifacts/。
  • 启动独立只读 reviewer,检查状态语义、部署口径、历史证据边界和是否误报完成。

Validation Matrix

条件 预期
业务编辑模板任务 已完成证据完整并归档
页面操作区任务验证通过 PRD 回填、注明未部署并归档
页面操作区任务验证失败 不归档,保留 finding 并另建修复 task
旧 7 天任务 明确未完成和被替代后归档,不补造证据
现行手册入口 Trellis-first,不要求新任务读取最新 Issue CSV
部署状态 最后公网基线与 7 月本地未部署基线明确分离
生成物 不进入 Git,不破坏既有历史证据目录

Rollback

  • 文档和任务正文修改可从本任务提交父提交恢复。
  • 归档移动可通过反向移动任务目录并恢复 task.json 原状态撤销,不涉及业务数据。
  • 本任务不产生生产配置、数据库或公网回滚需求。

Follow-up Audit Contract

收口完成后创建独立多维系统审查 task。审查至少覆盖功能与业务闭环、页面信息架构、视觉/交互设计、PC/移动/企微一致性、权限/状态机/数据、安全/依赖、测试/性能/运维和文档培训;finding 统一记录严重级别、证据、复现、影响、建议和是否需要用户决策,审查阶段默认不改业务代码。