droboticflow/docs/review-draft-conflict-recovery.md

1.8 KiB
Raw Permalink Blame History

审查批注冲突恢复与提示

2026-09-29,适用于质检与最终验收的共享批注组件。

已确认与未确认

线上指定任务存在已完成的保存回执和版本 1 的问题记录,而客户截图仍显示 0 个已保存问题。 提示来自服务端 review_draft_version_conflict,表示请求所带草稿版本不是当前版本;不是正式决定记录大小超限。 未采集到发生时的完整浏览器请求链,不能确定由多页面操作、重新进入、响应延迟或其他状态切换中的哪一种造成页面落后。

本地真实 hook 浏览器复现确认:首次保存收到版本冲突时,旧实现不读取最新草稿,继续保留旧版本和旧列表;自动读取只在未确认操作的重试分支执行。因此反复点击保存可能反复遇到同一冲突。

修复

  • 首次或重试保存遇到明确版本冲突,都自动读取最新列表。读取结果仍受任务、被审版本和页面代次保护。
  • 若相同问题 ID 与内容已保存,则按成功处理并清空输入,不重复新增。
  • 若有其他修改,只更新列表并保留输入,让用户检查后再次保存;不自动重发、不覆盖其他问题。
  • 最新列表读取失败或标注版本变化时,保留当前文字,给出明确的更新/重新打开操作。
  • 新版使用“更新问题列表”“查看提交结果”等操作文字;兼容显示旧版已持久化的错误提示。

验证

node tests/browser/review-draft-conflict.mjs 在修复前捕获旧版本仍为 0 的失败;修复后覆盖其他修改、同条已保存、读取失败、标注版本变化。 node tests/browser/review-decision-failure.mjs 覆盖质检/终审确认失败解除限制、成功结果恢复及未知结果保护。 本次不改变后端并发校验和客户数据,不自动部署或提交 PR。