droboticflow/docs/review-workspace-validation-2026-09-22.md

13 KiB
Raw Permalink Blame History

审查专注工作页实施与验证报告

日期:2026-09-22。产品实现、本地验证、双轴评审和公司部署已完成。11 票已完成;公司真实验收证据及执行边界见下文。

版本与范围

  • 实现基线:25ccd0bc2cd719e05526b6583b7e010bc1781f27。
  • 产品提交:a108e8f6;合入同事公司已上线版本 a3885d8a 后为 608480e75b56667cc94ccb130df432086652b6d6。
  • 当前分支:feature/local-dev-toolkit;已按用户要求提交 PR #10。后续合并与验收报告当前保持本地,未额外推送。
  • 公司现部署 5d5b4e98a5a07bc252f66f873bef16a6ca85601c:保留审查实现,并合入同事 e188e131、74125862 的项目删除性能修复;合并无冲突。
  • 同事的手机号登录、账号前后端、部署环境配置已保留,合并无文本冲突。
  • 需求来源:规格、任务索引。

已实现的用户行为

  1. 质检和最终验收均可进入同标签页专注工作页,最低网页内容区 1413×615;左、右、双目视图保留时间轴、问题编辑、保存及决定按钮。审查摄像机默认偏好独立保存。
  2. 每路实际画面下方居中显示 18–24px、最多两行的字幕。长文右侧看全文,JSON 按需展开;正常、空白、无效和舍弃分别显示,随实际播放头更新。
  3. 精简查看快捷键覆盖播放、逐帧、切片/动作导航、B 复查、Q 记录问题和 Ctrl/⌘+Enter 保存。导航到首尾停止;输入框保留正常文字、输入法和剪切行为。原标注编辑规则不变。
  4. Q 暂停在当前真实画面并定位对应问题对象。问题支持动作、切片、整体范围;列表回查恢复保存时的画面位置,避免跳到错误的动作开头。
  5. 草稿保存在服务端,刷新可恢复;账号、阶段、任务、被审版本和轮次隔离。普通 HTTP 下使用服务端编辑权控制,两页显式接管,旧页不能覆盖新稿。
  6. 正式通过/退回先确认实际范围,保留证据、归属、版本和问题校验;不增加逐段观看或语义填满门禁。质检退标注,最终验收退质检及实际聚合来源范围。
  7. 正式决定使用稳定操作标识和可恢复记录。浏览器没收到响应时核对原提交,避免重复审批;已保存的草稿操作也可在服务中断后恢复。
  8. 连续审查需手动开启:先本人最早领取,再公共池最早创建;一次一条,无缓冲池。成功决定后才下一条,空池等待;暂停、刷新、缩窗、接管及未知结果不自动恢复。
  9. 旧审核工作流通过服务端能力标识继续使用原正式提交路径,避免新回执协议阻断旧四阶段流程。

本地验证

使用本地快照 Mongo 27018、独立测试项目 project-review-focused-20260922,通过真实应用、解码视频和公开 API 验证。普通 HTTP 测试域名 review-session.test 映射到本机,实测没有 navigator.locks。测试不处理真实客户任务。

合并后启动补查发现旧快照 12 个账号无手机号,无法建立同事新增的 phone_unique 索引。验证时新建本地数据库副本 review_merged_20260922,仅在副本补充唯一的合成测试手机号;原快照与公司账号未修改。API 3008 / Vite 5181 启动后,两种审查的草稿回读、刷新、断网核对及接管再次通过;整段留空质检的真实批准及响应丢失核对再次通过。这是旧本地数据与新登录契约的兼容准备,不能以此前未启动的 API 作为测试通过证据。

检查 结果与边界
TypeScript 通过
Vite 发布构建、Linux amd64 API 构建 通过;保留现有大分块构建提示
前端完整回归 607 项:594 通过,13 项既有失败,无新增失败
Go 完整回归 107 个既有叶子失败;与已上线同事基线相同。包含随机 ID 的子测试名按同一测试族比较,无新增失败族
新审查 API/存储用例 ^TestReview 通过;合并手机号登录后再次通过
草稿与决定并发的 race detector 通过
独立 Mongo standalone 接管/队列竞争及恢复 通过;使用临时测试库并清理
质检/验收 × 普通/专注 字幕、Q 目标、保存回读、刷新和问题回查通过
1413×615 × 两角色 × 左/右/双目 视频实际可用高度、两条时间轨、草稿输入/保存、决定按钮、字幕位置及无整页滚动通过
快捷键与鼠标后焦点 真实播放、逐帧、非循环导航、B 片尾停止、输入法/重复键防误操作通过
多来源及状态 同名片、重复动作 ID、长文、密集动作、空白、无效、舍弃的定位和显示通过
正式决定 两角色批准/退回的 API 持久结果通过;两角色真实浏览器确认、取消及批准后接续通过
全部动作留空 合并后的质检 qc-10 和最终验收 acceptance-06 真实批准通过;验收包含两个来源、28 个空白动作,正式回执 completed,原空白/pending/非无效结果保留
响应丢失 真实审批完成后丢弃浏览器响应,按原操作核对成功;只有一次正式 POST,暂停后不自动进入下一条
连续审查与接管 显式开启、刷新不自动开始、缩窗手动恢复、迟到启动响应不恢复、另一页接管后旧页停写通过
旧流程兼容 已取得页面编辑权的旧质检/验收,各自批准/退回四条路径通过

完整前端基线的 13 项失败集中在旧页面源码断言、自动化配置、工作流/项目字典及布局测试。Go 基线失败主要涉及旧项目成员/供应商角色夹具及工作流测试。没有通过降低产品权限或证据检查来消除这些历史失败。

新增浏览器测试也遵守画面就绪条件:切换验收来源后,等待新切片真实视频可解码、动作证据可见,再记录问题。未就绪时产品会阻止操作;测试不会把立即输入仍在旧问题上的文字误判为新来源已保存。

双轴评审与修复

规范轴没有发现文档规范违例,报告 3 处正确性问题;规格轴报告 4 处,其中有重复。合并去重后完成以下五类修复:

  • 正式决定取得写入权后重新读取并验证草稿,防止并发新增问题却仍被通过。
  • 普通草稿也记录可恢复的写入意图,避免服务中断留下永久锁;恢复与接管会阻止迟到的旧写入覆盖新文本。
  • 用服务端 decisionProtocol 区分新回执与旧流程,保留旧路径。
  • Mongo standalone 将具体队列受理记录与页面接管放在同一文档 CAS 边界;队列投影可恢复,无需不安全的事务降级或永久账号锁。
  • 解析真实时间进行领取排序;无效领取时间回退创建时间,再以稳定 ID 排序。

另外在真实浏览器整合测试中修复了书签/刷新进入错误任务池、新任务加载编辑权时误暂停、问题列表回查定位错误,以及队列发现接管后未立即同步草稿只读的问题。

公司部署与真实验收

入口 http://120.48.180.80,实际命名空间 droboticflow-fanyu。用户明确批准使用现有测试账号会话、新建隔离任务及部署;此前审批阻碍已解除。本次只处理新项目 project-review-focused-company-20260922 的任务,不处理真实客户任务、不修改账号权限。

首次部署 2a2b8c80 后完成大部分验收;期间同事发布 74125862,替换了 API 与前端,处理器仍是本次镜像。检测到版本变化后暂停新增验收写入,核对远端,取得用户再次明确同意后合并为 5d5b4e98 并重新部署。2a2b8c80..5d5b4e98 仅改变同事的项目删除代码和测试;审查实现未变。不同版本的运行记录分开保留,旧版页面超时没有计作审查产品失败。

最终 API、标注处理器均为以下镜像摘要,Ready 1/1;健康接口返回 5d5b4e98、status: ok。Worker 保持同事 d368d21b,没有修改其配置,因此平台可能继续显示“组件版本不一致”;这是实际组件提交不同,不代表审查 API 未更新。

sha256:c2726e53457f0f2e03bee48a00396b4e84471e0ec6f81d64983a5a3ccdcc3af4

已保存当前上线基线的回滚快照,部署使用模板和 resourceVersion 前置核对。镜像构建 Job、ConfigMap 和本次上下文包已清理;隔离验收任务、报告及证据保留。合并后审查/项目删除 API 与存储相关测试通过,Web 和 Linux API 构建通过。

公司真实入口检查 结果/证据(相对 local-data/verification/review-focused-20260922/company/)
质检/最终验收 × 普通/专注 × 左/右/双目 12 组合通过;quality-matrix.json、acceptance-matrix.json。实际解码视频、字幕 18–24px、画面内两行省略、右侧全文
专注最低 1413×615 与较大窗口 两角色三相机核心区、时间轴、保存/决定可见;缩窗暂停、手动恢复、返回通过。quality-focus-layout.json、review-focus-layout.json;草稿测试另覆盖 1600×1000
草稿与 Q 两角色实际画面定位、保存回读、刷新、问题回查、未保存切对象保护、保存响应故障保留与核对通过;review-draft-{quality,acceptance}-browser.json
普通 HTTP 双页 无 Web Locks 仍可显式接管,旧页只读、输入保留;质检旧页正式请求及缺少编辑权标识请求均 409,quality-session-browser.json;延迟启动响应不能恢复已暂停队列,quality-continuation-recovery.json
长文、密集、空白、无效、舍弃 两角色 16 动作中的半开边界字幕、舍弃 Q 归切片且回读通过;quality-dense-discard.json、acceptance-dense-discard.json
同一来源两片真实生成 qc03 真实退回→重新切片→C/F 命名→后台生成两片→空白送检→QC 领取;同名片 Ctrl 左右、上下、逐帧、B、边界不循环及只读快捷键通过。multislice-navigation.json,导航前后任务/修订无变化
全空白质检与响应丢失 qc-blank 只发一次正式 POST、回执 completed;丢失浏览器响应后核对成功,不重复审批、不自动下一条。quality-blank-decision-recovery.json
最终验收正式流转 02 批准;03 退回全部两个来源至质检;01 先保存旧草稿证据再清除测试问题,批准一次。三项均有唯一正式操作和 completed 回执,无观看门禁
最终验收空池 01 成功后 next 返回 waiting/空任务;页面等待、暂停、刷新不自动恢复通过。acceptance-final-continuation.json
质检成功后接续 qc02 唯一批准、completed 回执后自动进入最早领取的 qc01;取消确认不提交、暂停/刷新/缩窗后手动恢复通过。quality-continuation-browser.json、review-continuation-quality-decision.json

验收中的准备问题与边界

隔离夹具初始为 97 条记录、13 个独立媒体目录。准备阶段发现:审核 attempt ID 未符合服务端规范、人类门输入绑定缺少 targetPortId、扩展的验收03漏建来源 batch。均只修复本批隔离记录,并保留检查证据;没有绕过证据检查或修改真实源数据。输入映射缺失时质检确实阻止正式决定,没有放宽校验。媒体复制后的数据库上下文曾超时,经确认全部新 ID 尚不存在才重试写入。

普通布局使用相机复选框,专注布局使用放大按钮;测试已按真实界面操作。逐帧或切相机后必须等视频“定位中”结束再按 Q,避免把尚未就绪时的拒绝误报为快捷键故障。测试确实使用公司公开 API 和实际视频,没有替换业务响应;故障注入仅用于丢弃响应或延迟传输。

高级接口竞争(公共池抢占、版本变化、权限变化、Mongo standalone 原子性)按已确认测试边界由本地真实 API/数据库测试补充;没有把这些本地结果写成公司浏览器实测。公司验收使用现有测试账号和短合成视频,不能据此推断所有客户长视频、所有组织配置或大规模并发都已覆盖。

资料位置

  • 人用说明:质检与最终验收操作说明。
  • 执行记录:execution。
  • 未跟踪本地证据:local-data/verification/review-focused-20260922/,含截图、浏览器 JSON、基线/最终日志、回滚快照及发布包。会话文件仅在未跟踪目录,权限 600,不进入 PR。

关键证据包括 review-focus-layout.json、review-problem-workflow-{quality,acceptance}.json、review-continuation-browser.json、review-continuation-recovery.json、review-decision-recovery.json、review-anchored-backend.log、final-validation-summary.json、merged-blank-decision.log、merged-review-drafts.log 和 merged-acceptance-drafts.log。整段留空验收另有 all-blank-acceptance-browser.json 与 all-blank-acceptance-readback.json:一次正式操作,源动作修订内容及媒体元数据哈希均未改变。报告和任务票只引用路径,不复制登录 Cookie、密码或 kubeconfig。