🧭 Reconcile rework plan with current review contracts
This commit is contained in:
parent
f592586a5f
commit
ee82e73aee
@ -4,6 +4,8 @@
|
||||
|
||||
Status: implementing
|
||||
|
||||
> 2026-10-08 方案复核:返工、质检复审、终审复验及时间点意见见 [返工与复审工作流方案](../review-rework-workflow/spec.md)。当前有效意见规则以文首引用的唯一审核意见合同为准;本文保留旧轮讨论,不将旧多条/全列表导航规则恢复为现状,也不将新方案视为已实现。
|
||||
|
||||
## 目标与范围
|
||||
|
||||
修正审查批注抢焦点、保存后仍停留旧条、同对象无法新增及清除不等于删除的问题。应用于质检和最终验收,普通与专注两种布局,保持现有页面风格与1413×615底线,不大改结构。完整讨论为 [map](map.md) 的 Q1–Q9;用户明确要求 Pi 实施,主代理只协调、审查和必要复测。
|
||||
|
||||
68
.scratch/review-rework-workflow/audit-20261008.md
Normal file
68
.scratch/review-rework-workflow/audit-20261008.md
Normal file
@ -0,0 +1,68 @@
|
||||
# 项目现状与返工计划复核
|
||||
|
||||
日期:2026-10-08。性质:文档/源码核对,不是功能验收或线上诊断。
|
||||
|
||||
## 核对基线
|
||||
|
||||
- 本地 HEAD:`f592586a`,分支 `codex/plain-language-errors`。业务代码有其他工作中的未提交改动,未改写或暂存它们。
|
||||
- 核对结束时本地缓存 `origin/dev` 为 `bd253016`,已含 #34 生产总览/工作记录与 #35 首页统计加载改动。`git diff origin/dev -- internal src docs/workforce-statistics.zh-CN.md` 无差异:本轮检查的业务工作树与该缓存版本一致,Git 提交状态不同。
|
||||
- 没有运行远端 fetch/merge、线上查询或部署;不能据缓存分支推断生产版本。此前文档写的 `05f2dc14/88244784` 不是本轮核对基线。
|
||||
- 已核对 CONTEXT、相关 ADR、唯一意见规格及前后端实现、返工保存/重切、正式审核决定、抽样、版本清理、无损整理及统计。当前手册和部分代码注释仍有旧批注流程表述,实际有效行为以新合同与调用链共同核对。
|
||||
|
||||
## 需要纠正的计划问题
|
||||
|
||||
### 1. 唯一意见和快捷键被旧方案覆盖(阻断直接实施)
|
||||
|
||||
现行合同每个对象每轮一份有效意见;后端唯一键、ID 不得移动目标的校验已实现。Ctrl/⌘上下选择整体/当前切片/当前动作卡片,F 载入已有意见。旧计划写“同对象多条”“全问题列表导航”会倒退已确认行为。
|
||||
|
||||
证据:[唯一意见合同](../review-single-opinion/spec.md)、[后端目标校验](../../internal/api/review_opinion.go)、[前端意见模型](../../src/lib/review-opinions.ts)、[当前键位](../../src/lib/review-shortcuts.js)。已修订为沿用唯一意见,时间点身份和选卡扩展另行明确。
|
||||
|
||||
### 2. 时间点意见不能只增加 AtSeconds 或一个菜单选项
|
||||
|
||||
当前 scope 仅 task/slice/action;非整体规范化强制找到切片,Start/End 会被赋值为切片/动作范围。ViewAnchor 是书签。现有唯一键不含源帧,直接加入 timestamp 会把同一来源不同点归成同一对象;统计亦使用相同类型的对象键。
|
||||
|
||||
证据:[目标规范化](../../internal/api/review_draft.go)、[API 类型](../../src/services/api/review-draft.ts)、[意见身份](../../internal/api/review_opinion.go)、[问题统计](../../internal/workforcestats/calculate.go)。计划现已覆盖后端校验、身份、协议、正式汇总、历史和统计整条链路。
|
||||
|
||||
原时间点应固定在被审源视频坐标;移动外层边界只改变局部映射。撤回旧草案中默认时间段、移动原意见、新旧意见时间位置跟着结果变化等未确认要求。
|
||||
|
||||
### 3. 融合返工有服务器与媒体依赖,不能复用“重新切片”入口
|
||||
|
||||
现有描述保存要求 sliceWorkflow 已完成生成并在 annotate;重切接口建立的 resetDraft 明确将 segments 清空。页面还由 phase 控制切片和动作编辑能力。因此“同页同时改两层”需要完整的草稿/校验/物化设计,单纯放开按钮会丢动作或撞服务器门禁。
|
||||
|
||||
证据:[草稿与重切接口](../../internal/api/annotation_operations.go)、[工作台](../../src/components/CaptureAnnotationWorkbench.tsx)。已把统一返工草稿和失败恢复纳入实施阶段。
|
||||
|
||||
### 4. 合并有两种已存在的语义
|
||||
|
||||
普通取消切分清空判断;另一个显式“无效动作外层无损整理”保留动作数组和时间。旧计划笼统写全部合并清空会破坏新入口。
|
||||
|
||||
证据:[无损整理合同](../../docs/annotation-invalid-slice-consolidation.md)、[送检整理调用](../../internal/api/annotation_operations.go)。两种操作分别保留,拆分/合并关联必须记录真实操作,不能靠同名猜测。
|
||||
|
||||
### 5. 版本号、审核历史和旧草稿备份不等于完整结果快照
|
||||
|
||||
普通清理会移除旧切片/动作 revision 和旧物化目录;无损整理及舍弃历史有保留例外。reviewDraftArchives 备份的是旧意见转换,不是当时被审的标注结果。审核大回执曾因嵌套完整任务超过 BSON 上限失败。
|
||||
|
||||
证据:[版本清理](../../internal/api/annotation_current.go)、[旧意见兼容](../review-single-opinion/implementation.md)、[回执大小修复](../../docs/review-decision-size-hotfix.md)。计划增加独立基线记录、必要媒体引用保护、分块读取、失败前不释放任务及缺失提示,不逐轮复制整份视频或把历史重新塞回任务文档。
|
||||
|
||||
### 6. 终审来源意见和范围不能用兼容文字推断
|
||||
|
||||
聚合正式事件有结构化 problems;来源退回事件主要保存 comment 和流转信息。返工页当前 reworkNotice 也主要读取 comment/problemSliceIds。新全局高亮必须从正式决定按来源读取,不能仅解析文本。终审所有来源回质检不表示每个来源都被指出错误。
|
||||
|
||||
证据:[正式决定](../../internal/api/review_decision_plan.go)、[返工提示](../../src/pages/AnnotationOperations.tsx)、[part 独立 Run](../../docs/capture-delivery-directory.md)、[冻结抽样](../../internal/api/human_loop.go)。用户已确认本轮沿用当前终审任务关联批次,不扩大到同 Capture 全部 part。失败样本必查的新增要求仍待确认,不擅自重新抽签。
|
||||
|
||||
### 7. 历史意见、处理反馈与本轮有效意见必须分离
|
||||
|
||||
现行“本轮有有效意见不能通过”是正常校验。把原退回意见自动复制进复审草稿,会使保留历史和允许通过互相冲突;靠删除原意见才能通过也违背用户要求。
|
||||
|
||||
计划改为原意见只读、处理反馈单独存、复审确认另有记录;仍有问题才明确形成当前轮有效意见。同一新对象仍遵守唯一性。新增逐条回应/确认门禁保持待定,不以“更新计划”冒充用户批准。
|
||||
|
||||
## 修订后的交付顺序
|
||||
|
||||
1. 时间点意见从创建到正式退回、返工定位的完整闭环,包含协议与统计。
|
||||
2. 版本基线、媒体保护、处理反馈和复审确认闭环。
|
||||
3. 切片/动作融合返工、映射、生成与上下对比。
|
||||
4. 当前关联批次的终审退回/复验与多来源协调。
|
||||
5. 完整回归与发布兼容证据。每阶段已有自己的真实业务验收,不等最后才整合。
|
||||
|
||||
## 本轮验证与限制
|
||||
|
||||
只改本方案文档及旧文档的导航说明;核对本地链接、文件格式、Git 差异和引用路径。未运行产品测试、未修改业务代码、未读取/修改客户数据。新方案仍待 D1/D2/D4/D5/D6 确认,不宣称已经具备新功能。PR、推送和公司部署均未执行。
|
||||
36
.scratch/review-rework-workflow/map.md
Normal file
36
.scratch/review-rework-workflow/map.md
Normal file
@ -0,0 +1,36 @@
|
||||
# 返工与复审设计地图
|
||||
|
||||
Status: proposed
|
||||
|
||||
## Notes
|
||||
|
||||
2026-10-08 重新核对本地 `f592586a` 及工作树。没有远端同步或公司版本验证。此前 05f2dc14 方案中对“同对象多条意见”和列表快捷键的现状判断错误,已按当前唯一意见合同和代码修正。其他统计/仪表盘未提交改动不在本轮修改范围。
|
||||
|
||||
当前事实与证据见 [审查记录](audit-20261008.md),修订方案见 [spec](spec.md),实施顺序草案见 [ticket-breakdown](ticket-breakdown.md)。
|
||||
|
||||
## Decisions-so-far
|
||||
|
||||
### 用户已明确要求
|
||||
|
||||
- 同页切片/动作返工、定位意见、全局高亮、处理后减少强提示。
|
||||
- 质检复审及终审复验保留意见、对比修改前后、继续记录问题和退回。
|
||||
- 选定时间点可批注,覆盖质检、终审、返工及两类复审/复验的定位和高亮。
|
||||
- 保持页面风格和熟悉快捷键。
|
||||
- 2026-10-08:终审整批沿用当前终审任务关联来源批次,不扩到同 Capture 全部 part 或另选任务组成一批。
|
||||
|
||||
### 当前已有合同
|
||||
|
||||
- 同轮同对象一份有效审核意见;旧正式多条原文保持历史,不恢复新建多条规则。
|
||||
- 审查只改意见,标注员改结果;空白动作可提交;普通合并清空判断,显式无损整理保持原语义。
|
||||
- Ctrl/⌘上下选当前意见卡片;F 载入所选对象已有意见。
|
||||
- 原作者合格时质检退回原作者;终审退回原关联批次质检;权限、容量、轮次和升级处理沿用。
|
||||
|
||||
## Fog
|
||||
|
||||
待确认 D1/D2/D4/D5/D6 见规格第 9 节;D3 已确认。此前未答复的推荐不能写成已批准。
|
||||
|
||||
技术约束:源帧时间点固定;合并/拆分映射需可证明;返工不能借重切接口清空动作;版本快照不能嵌套进大任务或回执;聚合终审意见需要来源投影;统计要区分点与区间;旧客户端和清理逻辑必须兼容。
|
||||
|
||||
## Comments
|
||||
|
||||
本次撤回旧草案中的扩展假设:不要求首版支持时间段、不允许标注员改写原审核意见、不随返工移动原时间点、不默认重新抽样、不把当前关联批次等同整个 Capture。完整实施仍需需求定稿及逐阶段验证。
|
||||
159
.scratch/review-rework-workflow/spec.md
Normal file
159
.scratch/review-rework-workflow/spec.md
Normal file
@ -0,0 +1,159 @@
|
||||
# 返工与复审工作流方案(重新核对版)
|
||||
|
||||
Status: proposed
|
||||
|
||||
更新:2026-10-08。本轮核对本地 HEAD `f592586a` 及现有工作树;统计、工作量和少量页面接线有其他未提交改动。核对结束时已缓存 origin/dev 为 `bd253016`,业务工作树与该缓存版本一致(提交状态不同)。本轮只修订本方案,不改业务代码,不抓取或合并远端,不判断生产已部署版本,不推送 PR、不部署、不访问客户数据。
|
||||
|
||||
依据:当前代码、[领域词汇](../../CONTEXT.md)、[唯一审核意见合同](../review-single-opinion/spec.md)、[撤销边界](../../docs/adr/0001-annotation-undo-stage-boundary.md)和[连续动作裁决](../../docs/adr/0002-contiguous-action-coverage.md)。旧讨论中“同对象多条新意见”和旧列表快捷键已经被唯一意见合同取代。此次纠正详见 [现状与计划审查](audit-20261008.md)。
|
||||
|
||||
## 1. 已确认需求、建议与待确认规则
|
||||
|
||||
用户明确提出的目标:
|
||||
|
||||
- 标注返工同页修改外层切片与片内动作,保留已有工作,根据具体审核意见修改。
|
||||
- 意见定位到整体、切片、动作;问题全局可见,处理后取消强提醒。没有整体问题时不额外占用整体问题展示区。
|
||||
- 返工重提交进入复审,保留原意见,上下对比修改前后,问题和实际改动重点显示,允许继续提出问题并再次退回。
|
||||
- 质检与终审增加对选定时间点的批注;返工、质检复审及终审复验都能定位、处理和高亮这些意见。
|
||||
- 保持页面风格和熟悉的快捷键,不做大布局改造。
|
||||
- **2026-10-08 补充确认:终审退回范围沿用当前终审任务关联的来源批次,明确列出受影响任务;不扩大到同一 Capture 的全部 part 或人工另组的一批。**
|
||||
|
||||
以下章节的具体 UI、状态与技术安排为建议,尚未答复的业务项列于第 9 节。此前的推荐选项不是用户已经确认的决定。时间段批注、标注员新增正式审核意见、移动原批注位置均不属于已确认范围。
|
||||
|
||||
## 2. 当前实现:复用哪些、缺少哪些
|
||||
|
||||
| 能力 | 当前事实 | 本轮增量 |
|
||||
| --- | --- | --- |
|
||||
| 审核意见 | 新格式每轮每个整体/切片/动作对象一份有效意见;旧多条原文兼容 | 沿用唯一意见,新增独立时间点目标;不恢复同对象任意多条 |
|
||||
| 意见区和键盘 | 当前三张卡片;F 编辑目标已有意见;Ctrl/⌘上下选择卡片、不跳画面;切换对象串行保存 | 扩展时间点入口;另外设计返工问题总览与定位,不偷换原快捷键含义 |
|
||||
| 返工归属和阶段 | 质检退回 annotation_combined,原作者仍有资格则归还;终审退回 quality_review | 在既有阶段内增加返工/复审视图和关联数据,不新增工作流阶段或客户任务副本 |
|
||||
| 返工显示 | 页面已有返工状态、comment、problemSliceIds,部分显示仍解析文字 | 新增读取正式结构化意见及跨轮引用,不依赖解析文字定位 |
|
||||
| 两层编辑 | 保存描述要求切片生成完成;切片/标注由 phase 控制;重新切片清空动作 | 需要可持久化的融合返工草稿及服务端校验,不能只开放前端按钮 |
|
||||
| 合并 | 普通取消切分清空合并判断;另有用户显式选择的无效动作外层无损整理 | 两者语义分别保留,不把无损整理入口错误改成清空动作 |
|
||||
| 历史 | 已审核/已验收是本人正式操作的只读入口,不等于当时结果快照 | 增加冻结的被审版本与对比读取 |
|
||||
| 数据保留 | 普通清理会删旧 revision 及旧媒体;无损整理和舍弃历史存在保留例外 | 保护复审所依赖的快照及媒体引用,不宣称所有旧版本都还在 |
|
||||
| 终审来源 | 聚合正式事件保存 problems;来源退回事件主要保存兼容 comment | 增加正式终审决定→来源任务→具体意见的受权读取关系 |
|
||||
| 可靠性 | 版本校验、页面租约、可恢复正式决定、异步物化均已有 | 复用并覆盖新目标/新版本,不另造领取或后台队列 |
|
||||
|
||||
## 3. 融入现有主链路
|
||||
|
||||
```text
|
||||
初次标注 → 质检初审 → 按现有抽样策略进入终审或继续交付
|
||||
质检退回 → 同一任务的标注返工 → 新结果送检 → 质检复审
|
||||
终审退回 → 原关联批次回质检复审 → 必要时退回标注返工
|
||||
→ 来源任务重新质检通过 → 按现有规则恢复终审,进入复验视图
|
||||
```
|
||||
|
||||
- “复审”是页面及业务处理模式,继续使用 annotation_combined、quality_review、prepackage_acceptance。不要给现有严格识别三角色链路的阶段数组额外插入阶段。
|
||||
- 模式由最近正式退回决定、来源关联及本次提交确定;不能仅用 revision 大于 1 或 reviewRound 大于 0 推断发生返工。
|
||||
- 同一任务可以经历多轮;每轮记录准确的被退回版本、返工提交和后续决定,默认对比最近一次相关退回基线。
|
||||
- 终审退回给质检时,标注内容可能没有改变:显示“内容未修改,待重新核对”,不伪造改动或强迫标注员修改。
|
||||
- 保持原作者资格检查、供应商归属、任务容量、最大返工轮次及升级处理;不借模式切换绕过这些规则。
|
||||
- 送检异步完成才进入质检;仅收到后台接收响应不视为成功。失败保留草稿和原基线,未知结果核对原操作。
|
||||
|
||||
## 4. 时间点审核意见(首个可交付闭环)
|
||||
|
||||
### 4.1 用户操作与权限
|
||||
|
||||
- 质检初审/复审、终审初审/复验中:暂停或逐帧选定画面 → F 选择“时间点” → 填写或编辑该点意见 → Ctrl/⌘+Enter 保存 → 焦点返回工作台。
|
||||
- 返工页可看原意见、定位、按要求编辑结果和填写处理反馈;标注员不能改写、删除审核员的正式意见。本轮不授予标注员创建正式审核意见的权限。
|
||||
- 沿用本轮草稿清除确认、输入框原生键位、Esc 处理未发送输入及未知保存结果核对规则。
|
||||
- 同一点的唯一意见建议按“审核任务/阶段/轮次/被审版本 + 来源任务 + 规范源帧”识别;不同时间点可分别有意见,同一帧重复 F 编辑已有意见。一份意见可写多项要求。此建议待确认。
|
||||
|
||||
### 4.2 位置固定,不随返工漂移
|
||||
|
||||
- 明确新增时间点 scope 与协议能力,不能仅给 ViewAnchor 赋值:现有锚点是回看书签,现有非整体校验还强制要求切片且会重算 Start/End。
|
||||
- 每个点必须绑定受审来源和准确时间基准。终审多个来源相同的 10 秒是不同目标,不能串在一起。
|
||||
- 优先复用统一帧范围、硬件时间戳、源时间线指纹和左右帧映射;保存服务器核定的源坐标,显示可用相对秒。帧号必须带来源/时间线,不能取浏览器四舍五入时间或按固定 FPS 猜帧。
|
||||
- 旧 slice-seconds 按被审版本的切片起点换算;时间线/媒体变化无法可靠映射时提示重新核对,不悄悄吸附到新位置。尚未加载就绪的画面不能保存成精确时间点意见。
|
||||
- 例如原视频 10 秒被指出错误,返工将切片边界从 8 秒移到 12 秒:原意见仍在原视频 10 秒,只改变它在新切片中的归属和局部秒数。
|
||||
- 切片 ID/动作 ID 是当前定位辅助,不决定时间点身份。分割合并不删除意见,不把“时间点意见”改成“某片全部有问题”。
|
||||
- 最末端排他结束边界不是可见帧;边界命中和双目映射沿用统一帧协议,不能把末端标记定位到不存在的一帧。
|
||||
|
||||
### 4.3 显示与消费
|
||||
|
||||
- 原视频全局概览显示问题点;对应可见切片轴、动作轴映射到局部位置。不同来源使用各自概览,不能把多个来源的秒数拼成同一轴。
|
||||
- 播放头与问题标记采用不同样式;父切片只汇总数量,不把整片涂红。重叠标记可展开选择,点击后跳转并显示对应意见。
|
||||
- 返工保存、再次送检和复验后,原点、原文和原轮次仍可回查。标注员更正时间边界属于结果变更,不能移动已正式提交的意见锚点。
|
||||
- 新 scope 必须同步正式决定汇总、兼容 comment/问题切片派生、历史读取、导出和问题统计。不同点分别计问题对象;点没有持续时长,不按整片累加,也不因为 Start=End 就当作未定位。具体报表展示采用现有口径扩展。
|
||||
- 时间段、框选范围、按相机分别建立问题是后续可选能力,首版不默认纳入。
|
||||
|
||||
## 5. 标注返工与复审界面
|
||||
|
||||
### 5.1 返工页面
|
||||
|
||||
- 复用现有播放器、两条轴和编辑区;顶部简短显示“待处理/待复核”数量,整体问题仅在确有意见时展示。选择整体范围的入口仍可用。
|
||||
- 返工视图增加紧凑问题导航,与现有动作列表协调;问题较多时滚动或按需展开。正常初次审核继续以当前对象卡片为主,不重新常驻密集全量问题列表。
|
||||
- 切片/动作/时间点通过全局标记可发现,点击直达目标。全局可见不意味着把全部原文挤在同一屏。
|
||||
- 同页修改外层切片、舍弃原因和片内动作,但明确当前编辑层。C/G/Ctrl+X 作用于明确选中的层,不根据焦点落到哪个按钮隐式猜测。
|
||||
- 融合返工必须有独立编辑上下文、统一草稿版本和原子保存边界。不能调用现有重切重置接口作为入口,也不能靠伪造 phase 绕过“先生成再确认描述”的服务器校验。
|
||||
- 未受影响动作原样保留;外层边界穿过动作的处置待确认。普通合并仍清空合并判断,无损整理保留其显式选择和证据。
|
||||
- 有边界变化时生成所需的新媒体;无变化媒体仅在指纹、范围和产物校验一致时复用。失败不发布半套结果,不清空意见或草稿。仍可依照现有连续工作处理其他任务。
|
||||
- 撤销以本任务当前编辑阶段为界;生成、送检、切换任务仍遵循现有截断规则,不用撤销逆转审核决定。
|
||||
|
||||
### 5.2 原意见、处理反馈、本轮意见分开
|
||||
|
||||
1. 原正式意见不可变,包含决定 ID、目标、时间点、被审版本和作者。
|
||||
2. 标注员处理反馈/相关内容变更证据单独保存,指向原意见和当前草稿/提交版本。
|
||||
3. 复审员确认结果与本轮有效意见分别保存:旧问题待核对、确认已解决、仍有问题/新增意见。
|
||||
|
||||
这样保留历史原文不会自动成为本轮阻止通过的有效问题;“确认已解决”也不会删除历史。是否强制逐项确认才可提交/通过,属于待确认的新门禁。
|
||||
|
||||
高亮建议:原问题红色;关联结果实际变化且保存后改为“有修改,待复核”;确认解决后取消强提醒但保留历史。未保存、无关字段变化或改回原值不能视为已处理。纯时间点/整体问题不强迫虚构数据编辑,可用处理说明回应。高亮取消的具体触发规则仍待确认。
|
||||
|
||||
### 5.3 质检复审与终审复验
|
||||
|
||||
- 同一视频工作台,右侧上方原内容、下方新内容;重点比较切片定义、动作文字、无效/舍弃判断、起止帧。双视频常驻不作为首版要求。
|
||||
- 原批注区域及实际变更采用红色强调并加文字标签,避免把“已修改”误认为“仍有错”。没有原意见的新改动也列出,未变部分正常显示。
|
||||
- 对比基线精确到正式退回版本;终审涉及多个来源时为来源版本清单,不能假定一个 revision 覆盖全批。
|
||||
- 拆分/合并使用编辑操作记录建立多对多关联;无法证明映射时并列显示原位置和当前相关范围,由人核对,不按名称或时间相似度自动移植旧意见。
|
||||
- 复审可在本轮新增或编辑当前对象唯一意见;旧问题“仍有问题”须明确引用到当前目标,与新增意见按同一对象唯一规则处理。
|
||||
- 保留 F 编辑、Ctrl/⌘上下选卡、Enter 编辑选卡、Ctrl/⌘Enter 保存、Shift+Delete 清除本轮意见。时间点卡片怎样纳入选卡及问题跳转键位需确认;不能把 Ctrl上下再次改成全列表跳转。
|
||||
|
||||
## 6. 终审退回的批次处理
|
||||
|
||||
- 已确认沿用当前终审任务的 SourceBatchID 关联来源,不扩大为整个 Capture、项目、供应商或跨任务勾选批次。一个 Capture 可能有多个 part/Run,UI 必须列出真实关联清单。
|
||||
- 继续当前行为:关联来源回质检,明确问题任务标为“终审指出问题”,其余为“同批退回复查”,批次整体意见显示于批次层。
|
||||
- 终审员在共享验收池可能来自另一供应商;意见读取和再次领取依照现有组织/验收授权,不改变生产归属,不把共享终审权限扩展给标注或质检。
|
||||
- 正式终审决定的结构化意见通过来源 ID 投影到来源任务;来源事件的 comment 仅供兼容,不能解析文本猜绑定。批次整体意见显示一次为整体要求,不伪造成每个动作的独立错误。
|
||||
- 来源全通过后按既有恢复逻辑进入终审复验,冻结本次来源版本集合;任何来源又退回或版本变化,不能沿用旧的整批通过判断。
|
||||
- 当前源码有 Capture 冻结抽样及旧任务回退规则;不把退回当成重新抽签,不调整概率。建议复验必须包含原失败样本;这是新增明确复验要求,仍需确认。超出关联批次的抽查不在本轮范围。
|
||||
- “每个来源重新质检通过”与“每段都播放/逐条勾选”的门禁不同;首版沿用前者,不擅自增加后者。
|
||||
|
||||
## 7. 存储、兼容和性能约束
|
||||
|
||||
- 复用 ReviewDraft / ReviewOperation 的权限、CAS、租约、幂等、结果核对;新增时间点不能只改前端类型和 F 菜单。服务端、TS、目标唯一键、正式决定及所有读取方一起兼容。
|
||||
- 被审结果快照与处理反馈采用独立、可分页/分块的数据记录,正式事件和恢复计划持有引用。已有 reviewDraftArchives 只备份旧草稿转换,不是标注结果快照。
|
||||
- 快照应在正式退回发布前完成并绑定正确版本;失败不能先释放为可返工。重试复用原决定和快照身份,重启不产生不同基线。
|
||||
- 保护引用的源时间线、原结果和必要媒体,不默认逐轮复制整份视频。优先复用不可变源媒体及范围,必要产物按引用保护;数据库留引用不等于媒体仍可访问。保留期限待配置决策,保护期内空间不足应提示/暂停相关写入,不能删客户历史腾空间。
|
||||
- 不能把全部历史嵌套进 HumanItem 或 ReviewOperation:现有决定已因大历史超过 BSON 上限修复过。对比按选中来源/切片加载,列表只取摘要,避免全任务池扫描和 N+1 取历史。
|
||||
- 老正式记录、旧多条意见、comment-only 和旧在途操作保留读取/重放。没有旧结果时明确“历史对比不可用”;没有明确定位的文字不自动绑定对象,缺失不能显示成“无问题”。
|
||||
- 新目标使用明确协议版本/能力检查;旧前端不能保存时把时间点意见丢掉,旧后端不能把它误归整体/切片。回退须验证新格式读写及在途操作;不承诺任意旧镜像可直接接着写,必要时暂停受影响新功能写入并前向修复,禁止整库恢复覆盖后续客户工作。
|
||||
- 返工次数、首交产出、正式打回归属沿用现有事件口径;处理反馈和自动保存不重复计作正式提交/退回。时间点统计的去重键需增加来源帧。
|
||||
|
||||
## 8. 分阶段交付与验证
|
||||
|
||||
以完整可验证业务流推进,阶段是实现次序,最终覆盖全部已确认范围:
|
||||
|
||||
1. **时间点最小闭环**:质检/终审选点、保存、刷新、正式退回、标注返工只读定位;同步唯一性、来源隔离、统计与旧客户端保护,不等完整融合编辑页才做真实验证。
|
||||
2. **原基线和处理反馈闭环**:冻结结果、保留媒体、反馈保存、再次提交、复审读取与确认,覆盖中断恢复和旧结果缺失。
|
||||
3. **融合返工与对比**:保留动作的两层草稿、边界拆分合并关联、生成失败恢复、上下对比;普通首次编辑路径回归。
|
||||
4. **终审批次复验**:来源意见投影、原批次范围、全部来源完成及二次退回、共享验收权限和冻结抽样。
|
||||
|
||||
每阶段均验证质检/终审 × 普通/专注布局,返工和两类复验相关入口,1413×615、单/双相机、输入法与焦点。不把集成测试全部推迟到最后一票。
|
||||
|
||||
本地默认使用隔离副本及合成任务:同来源不同点不合并、不同来源同秒不串线;时间点落在边界/舍弃/无效/空白;旧批注不移动;多轮退回;点有定位但不虚增时长;断网、冲突、接管、重复请求、迟到响应、已保存未响应、后台生成失败与重启恢复。比较具体失败用例与基线,不能用历史报告代替本轮验证。
|
||||
|
||||
本轮是计划审查,不运行产品验收或客户写操作。实现后 PR、公司部署和测试对象写入各按届时授权执行。
|
||||
|
||||
## 9. 待确认的产品决策
|
||||
|
||||
| 编号 | 问题 | 当前建议 / 状态 |
|
||||
| --- | --- | --- |
|
||||
| D1 | 关联内容修改保存后是否自动取消红色,还是手动确认处理? | 自动显示“有修改,待复核”;整体/时间点可用处理反馈,不能自动判解决。待确认 |
|
||||
| D2 | 外层边界穿过已有动作时如何保留判断? | 未受影响保留,被穿过的按源位置拆分并标为待核对;普通合并仍清空。待确认 |
|
||||
| D3 | 终审“整批”是什么? | **已确认:当前终审任务关联来源批次** |
|
||||
| D4 | 返工送检/复审通过是否要求逐条回应/确认旧问题? | 与空白动作门禁分开讨论,不先实现硬拦截。待确认 |
|
||||
| D5 | 时间点唯一性与键盘入口 | 同来源同规范帧一份有效意见;F 增加时间点,Ctrl上下保持卡片导航,问题跳转另设。待确认 |
|
||||
| D6 | 终审复验是否明确必查原失败样本? | 推荐必查,保持现有冻结抽样,不额外重新随机。待确认 |
|
||||
|
||||
历史版本保留期限、对比媒体复用和容量需实现前评估;时间段批注仅为后续选项,不是本轮必须确认才能实现时间点的前置条件。
|
||||
17
.scratch/review-rework-workflow/ticket-breakdown.md
Normal file
17
.scratch/review-rework-workflow/ticket-breakdown.md
Normal file
@ -0,0 +1,17 @@
|
||||
# 返工与复审实施顺序草案
|
||||
|
||||
Status: proposed
|
||||
|
||||
基于 [重新核对后的规格](spec.md),2026-10-08 更新。以下是拆分草案,不是已批准实施票;业务决策确认后再建立 issues/NN 文件和验收合同。
|
||||
|
||||
| 阶段 | 交付内容 | 依赖 | 必须随阶段完成的验证 |
|
||||
| --- | --- | --- | --- |
|
||||
| 01 | 时间点最小完整闭环:质检/终审选点意见、服务端唯一性/定位、正式退回、返工只读定位;同步汇总、统计、旧协议保护 | D5;其余返工策略不阻塞此阶段 | 本地真实 API/浏览器保存回读和正式退回;同秒多来源、边界/舍弃、未决写入、点不虚增时长 |
|
||||
| 02 | 退回基线与处理反馈:独立快照/媒体引用保护、处理反馈和复审确认的读取写入契约,原意见只读 | 01;D1、D4 | 退回→反馈→再次提交→复审核对;CAS/重启/失败、旧版本缺失、大对象和清理保护 |
|
||||
| 03 | 切片/动作融合返工:统一草稿、边界映射、媒体生成/复用、上下对比及全局导航 | 02;D2、键位确认 | 两层编辑保存恢复;拆分/合并/撤销;普通合并与无损整理;故障不丢原动作;未改普通流程回归 |
|
||||
| 04 | 终审批次复验:正式终审意见来源投影、原批次复审队列、全部来源完成协调、再次终审对比 | 02、03;D3 已确认,D6 待确认 | 同批有问题/无问题、未改内容复核、再次退回、多来源版本变化、共享授权与冻结抽样 |
|
||||
| 05 | 最终完整场景复核、中文手册和发布兼容证据 | 01–04 | 五种工作模式 × 普通/专注、1413×615、双目/单目、键盘焦点、旧格式、回退写兼容和性能 |
|
||||
|
||||
每阶段即交付可操作闭环和相应验证,不将业务验收全部集中在最后。优先复用 ReviewProblemPanel/useReviewDraft、现有播放器及统一帧协议、ReviewOperation 恢复与已有限流处理器;不要新建平行任务池或扩大巨型页面的多套业务分支。
|
||||
|
||||
本地提交仅包含本任务文件。PR/推送、公司部署需具体授权;线上业务验证仅限明确授权的隔离测试对象,不用客户任务做写入测试。
|
||||
Loading…
x
Reference in New Issue
Block a user