72 行
4.0 KiB
Markdown
72 行
4.0 KiB
Markdown
# 遗留任务与运行手册收口设计
|
|
|
|
## 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 统一记录严重级别、证据、复现、影响、建议和是否需要用户决策，审查阶段默认不改业务代码。
|