Files
Agent-System/.doc/ops/checklists/2026-09-14-controlled-content-ui-acceptance.md
T

3.4 KiB
Raw Blame History

受控文档正文修复真实 UI 验收 Checklist

执行身份与环境

  • 报告 Antigravity CLI / 实际模型。
  • 阅读 AGENTS.md、PROJECT.md、.doc/README.md、.doc/ops/CURRENT.md、任务文、审计与整改方案。
  • 使用 mcr.microsoft.com/playwright:v1.63.0-noble、--network host、BASE_URL=http://127.0.0.1:3100。
  • acceptance worktree 挂载 /work,主仓 web/node_modules 只读挂载到 /work/web/node_modules。
  • 管理员凭证只从 shuimu-agent-app-dev 容器环境安全传入,不输出、不截图、不提交。

强制边界

  • 用户、项目、成员、对话、文档、小队、编辑等数据只由 Playwright page 的真实 UI 操作产生。
  • 不用 page.request、context.request、curl、API 直调、DB 写、route/mock/stub、localStorage 注入。
  • 网络响应只用于监听和断言;PASS 必须同时有页面可见证据。
  • 不复用主仓旧 phase state/旧 PASS;失败原样记录。
  • 不从 worktree 重启共享 Docker;主阶段后输出 NEEDS_HOST_RESTART(若主阶段遇到 FAIL 阻塞,则先定位并等待修复,不提前重启)。

A. 项目 143 回归(clean-run3 全部 PASS)

  • admin 从登录页登录,经 UI 打开项目标题“对话协同会话”(原项目143对应UI会话)。
  • 经 UI 打开 doc_proj143_intake(用户初始需求收集表),正文非空、账本就绪。
  • console/pageerror 无相关错误,content 与 revision-state 均无 404;初始 legacy doc-001 请求严格为 0。
  • 初次稳定后空闲 30 秒,无新增重复正文请求、无闪烁。
  • 双击真实块,追加唯一中文标记,保存后页面可见且修订号增加(r1 -> r2)。
  • 纯净阅读 / 人工修改 / 全部变更均验证 active 状态与真实装饰差异。
  • 刷新、退出、重新登录,再打开同一项目/文档,标记与修订号持久化。
  • 截图、trace、结果写 .doc/test-reports/assets/2026-09-14-controlled-content-ui-acceptance/clean-run3/。

B. 新项目真实全链路(full-chain-final 全部 PASS)

  • 审读并运行 web/e2e/document-revision-runtime.spec.ts main phase;该测试只能通过 UI 建 A/B/C、新项目和全部数据。
  • 真实产品 PI/小队完成初次文档生成和二次修改;页面显示本轮用户输入与 assistant 终态回复。
  • 页面显示文档正文、版本账本、人工编辑、三模式(UI-06 刷新后通过,UI-07/08/09 三模式计算样式互斥通过)。
  • 页面打开真实 change report,并显示项目影响、文档影响、风险、开放问题。
  • 并发编辑、审核人、无关用户权限边界有 UI 证据(UI-12/13a/13b 均通过)。
  • 产生本轮非敏感 phase state、截图、results 并提交 Git;本地运行产生的 trace/video/HTML 报告未提交仓库;本地 secrets 继续 ignored 且绝不披露。
  • 主阶段写报告草稿并输出 NEEDS_HOST_RESTART,等待 orchestrator 重启。

C. 重启后(由 orchestrator 重启并执行 post-restart 全部 PASS)

  • 仅用 UI 重新登录、打开本轮新项目与文档(UI-15 post-restart 2.8s 通过)。
  • 正文唯一标记(A1-win-mu0oymfg)、版本/修订(V3/r2)页面可见。
  • 目标受控文档 404 严格为 0。
  • 完成报告;如实记录全部结果,主阶段与重启后产物完好归档。