✨ Add focused review workspaces and durable review drafts #10

Merged
longtao.wu merged 11 commits from feature/local-dev-toolkit into dev 2026-09-23 05:56:33 +08:00
Collaborator

质检与最终验收现在可使用同风格的专注工作页:每路画面下方显示大字幕,右侧查看完整标注并记录问题;增加精简查看快捷键、可恢复的服务端审查草稿、普通 HTTP 双页面接管,以及确认后通过/退回和连续审查。

正式决定通过稳定操作标识及回执核对,响应丢失时避免重复审批。审查保持只读原标注,不增加逐段观看或填满语义的门禁。已合入同事最新项目删除性能修复(74125862)。

验证

  • 公司 droboticflow-fanyu 已部署合并版本 5d5b4e98,API/标注处理器健康;仅使用新隔离项目,未处理客户任务。
  • 两阶段 × 普通/专注 × 左/右/双目、1413×615、字幕/全文、快捷键、草稿保存回读/刷新、两页接管及旧页拒写通过。
  • 真实通过/退回、空白送检、同名两片导航、成功后接续、空池暂停及丢响应核对通过。
  • 类型检查、Web/Linux API 构建及相关 API/存储测试通过。完整回归保留既有基线:前端 13 项失败、Go 107 个叶子失败,无新增失败族;高级接口竞争由本地真实 API/数据库回归补充。

完整范围及限制:docs/review-workspace-validation-2026-09-22.md。
操作说明:docs/review-workspace-guide.zh-CN.md。

最新提交 af9273d2 包含公司验收报告与全部 11 票完成记录。

质检与最终验收现在可使用同风格的专注工作页:每路画面下方显示大字幕,右侧查看完整标注并记录问题;增加精简查看快捷键、可恢复的服务端审查草稿、普通 HTTP 双页面接管,以及确认后通过/退回和连续审查。 正式决定通过稳定操作标识及回执核对,响应丢失时避免重复审批。审查保持只读原标注,不增加逐段观看或填满语义的门禁。已合入同事最新项目删除性能修复(74125862)。 ## 验证 - 公司 droboticflow-fanyu 已部署合并版本 5d5b4e98,API/标注处理器健康;仅使用新隔离项目,未处理客户任务。 - 两阶段 × 普通/专注 × 左/右/双目、1413×615、字幕/全文、快捷键、草稿保存回读/刷新、两页接管及旧页拒写通过。 - 真实通过/退回、空白送检、同名两片导航、成功后接续、空池暂停及丢响应核对通过。 - 类型检查、Web/Linux API 构建及相关 API/存储测试通过。完整回归保留既有基线:前端 13 项失败、Go 107 个叶子失败,无新增失败族;高级接口竞争由本地真实 API/数据库回归补充。 完整范围及限制:docs/review-workspace-validation-2026-09-22.md。 操作说明:docs/review-workspace-guide.zh-CN.md。 最新提交 af9273d2 包含公司验收报告与全部 11 票完成记录。
zhanghongming added 8 commits 2026-09-22 20:00:19 +08:00
zhanghongming added 3 commits 2026-09-22 22:44:46 +08:00
Owner

独立复核(在隔离 worktree 里实际跑过,不是照抄 PR 描述):

  • 与当前 dev(50683fc8,含最新性能修复)合并干净无冲突,go build ./... / go vet ./... 通过。
  • go test ./internal/api/... ./internal/store/...:与不含本 PR 的 dev 基线逐个测试名比对,失败集合完全一致(75个已知失败),review_draft/review_session/review_decision/review_continuation 相关代码零新增失败。
  • npx tsc --noEmit 通过;node --test tests/frontend/*.test.mjs 607 个用例中失败的 13 个与 dev 基线完全一致,新增的 review-captions/review-shortcuts 测试 5/5 通过。
  • 确认 74125862(项目删除性能修复)确实是本分支祖先,已合入。
  • Go 新代码(review_draft.go / review_session.go / review_decision.go / review_continuation.go):租户隔离检查到位(每个 handler 都过 ensureTenantAccess + canAccessHumanItem,且有审核员不能审自己提交的隔离约束);幂等决策回执用内容寻址 operationId + CAS 乐观并发,prepared→applying→completed 状态机设计谨慎,能安全应对响应丢失重放。
  • 前端 useReviewDraft/useReviewDecision/useReviewContinuation 三个 hook:loading/error 状态处理完整,用 epoch/generation token 防止旧请求覆盖新状态,decision 会先存 localStorage 再提交,很好地实现了“丢响应不重复审批”的要求。

次要保留意见(不阻塞合并):

  1. tests/browser/review-*.mjs 依赖本地固定路径的 Edge 可执行文件和未提交的 fixture,本次环境跑不了,建议确认 CI 或作者本地已过;
  2. review_continuation.go 里按 projectId 做 ListHumanItems 无上限扫描,和现有 human_loop.go 里的既有模式一致,不是本 PR 引入的新问题,项目变大后可关注;
  3. Mongo CAS 重试循环(最多8次)没有退避,高并发下可能短暂空转,风险低。

结论:可以合并。

独立复核(在隔离 worktree 里实际跑过,不是照抄 PR 描述): - 与当前 dev(50683fc8,含最新性能修复)合并干净无冲突,`go build ./...` / `go vet ./...` 通过。 - `go test ./internal/api/... ./internal/store/...`:与不含本 PR 的 dev 基线逐个测试名比对,失败集合完全一致(75个已知失败),review_draft/review_session/review_decision/review_continuation 相关代码零新增失败。 - `npx tsc --noEmit` 通过;`node --test tests/frontend/*.test.mjs` 607 个用例中失败的 13 个与 dev 基线完全一致,新增的 review-captions/review-shortcuts 测试 5/5 通过。 - 确认 74125862(项目删除性能修复)确实是本分支祖先,已合入。 - Go 新代码(review_draft.go / review_session.go / review_decision.go / review_continuation.go):租户隔离检查到位(每个 handler 都过 ensureTenantAccess + canAccessHumanItem,且有审核员不能审自己提交的隔离约束);幂等决策回执用内容寻址 operationId + CAS 乐观并发,prepared→applying→completed 状态机设计谨慎,能安全应对响应丢失重放。 - 前端 useReviewDraft/useReviewDecision/useReviewContinuation 三个 hook:loading/error 状态处理完整,用 epoch/generation token 防止旧请求覆盖新状态,decision 会先存 localStorage 再提交,很好地实现了“丢响应不重复审批”的要求。 次要保留意见(不阻塞合并): 1. tests/browser/review-*.mjs 依赖本地固定路径的 Edge 可执行文件和未提交的 fixture,本次环境跑不了,建议确认 CI 或作者本地已过; 2. review_continuation.go 里按 projectId 做 ListHumanItems 无上限扫描,和现有 human_loop.go 里的既有模式一致,不是本 PR 引入的新问题,项目变大后可关注; 3. Mongo CAS 重试循环(最多8次)没有退避,高并发下可能短暂空转,风险低。 结论:可以合并。
longtao.wu merged commit 1964582bea into dev 2026-09-23 05:56:33 +08:00
Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: longtao.wu/droboticflow#10
No description provided.