📋 Record resolved annotation workspace decisions
This commit is contained in:
parent
a313b22ae8
commit
b83e810ebf
@ -2,7 +2,7 @@
|
||||
|
||||
Type: grilling
|
||||
|
||||
日期:2026-09-18。当前阶段:所有需求边界与交互示意已确认;已整理[正式规格](./spec.md),未开始产品实现。
|
||||
日期:2026-09-18。当前状态:需求、交互示意和[正式规格](./spec.md)已确认;实施票 01–08 均已解决并分别独立审查通过。本文件保留设计阶段的讨论和示意记录,并在下方补充实施结果与验收证据。
|
||||
|
||||
## Notes
|
||||
|
||||
@ -10,6 +10,8 @@ Type: grilling
|
||||
|
||||
### 已有能力与本轮缺口
|
||||
|
||||
以下为设计讨论时的基线观察,描述的是实施前状态,不是当前工作台状态。
|
||||
|
||||
- 原规格 tickets 09–11 已完成同标签页独立工作路由、项目开始工作、连续接续、显式恢复和活动页面互斥。参见 [原规格](../annotation-keyboard-workflow/spec.md)、[现有使用说明](../../docs/annotation-keyboard-guide.zh-CN.md)。
|
||||
- 工作路由为 `/plugins/annotation-qa/workflows/:workflowId/work`,仍共用 `AnnotationOperations` 与 `CaptureAnnotationWorkbench`。原任务池入口与工作页并非两套独立编辑器。
|
||||
- 自动接续发生在审核数据准备完成、送检成功之后,不等待质检员审核通过。接续时优先本人已领取未完成任务,无待续任务才随机领取。
|
||||
@ -24,10 +26,23 @@ Type: grilling
|
||||
- 本地独立 Git 备份:`local-data/backups/annotation-keyboard-baseline-20260918.bundle`,约 44.6 MB,未跟踪;`git bundle verify` 通过,包含完整历史。
|
||||
- 该备份保存源码、已提交的快捷键行为及界面,不保存 Mongo 数据、下载视频、凭据、未提交改动或浏览器草稿。备份保留既有历史,按本地仓库访问范围管理,不另行公开上传。
|
||||
- 需要回到基线开发时,先保存当时未提交的改动,再从标签创建新的恢复分支,例如 `git switch -c codex/restore-annotation-baseline codex/annotation-keyboard-baseline-20260918`;不使用强制重置覆盖后续工作。
|
||||
- 若本地仓库丢失,可从 bundle 克隆代码;本地运行环境和业务数据另行恢复。第二轮已确认要在产品内支持切回旧布局;这仍是待实现的能力,不能只凭 Git 备份视为已具备。
|
||||
- 若本地仓库丢失,可从 bundle 克隆代码;本地运行环境和业务数据另行恢复。设计阶段确认要在产品内支持切回旧布局;该能力现已由 [01 专注工作视图与原布局无损切换](./issues/01-focused-view-and-legacy-switch.md) 交付,不能只凭 Git 备份视为已具备。
|
||||
|
||||
## Decisions-so-far
|
||||
|
||||
- **实施状态(当前)**:01–08 均为 `resolved`,并已逐票独立审查。产品已实现专注工作布局;本地浏览器/API 验收、操作说明、全套检查结果和执行记录分别见[整体验收报告](../../docs/verification/annotation-workspace-layout/acceptance-results.md)、[操作说明](../../docs/annotation-workspace-layout.md)、[全套检查结果](../../docs/verification/annotation-workspace-layout/full-suite-results.md)及[执行记录](../../docs/verification/annotation-workspace-layout/execution-record.md)。
|
||||
- [01 专注工作视图与原布局无损切换](./issues/01-focused-view-and-legacy-switch.md):`a5753731` 实现同标签页专注外壳和状态保留的原布局切换,`6acc5803` 补足连续工作选择跨布局切换验证。
|
||||
- [02 单屏切片](./issues/02-single-screen-slicing.md):`a3c780e8` 实现固定切片布局和双视频单屏操作,并完成五档内容区及真实生成验收。
|
||||
- [03 固定描述编辑](./issues/03-fixed-description-editing.md):`e462437a` 使描述编辑、保存、取消、历史与送检固定可达,并验证真实保存和 API 回读。
|
||||
- [04 分页选择导航](./issues/04-paged-selection-navigation.md):`94b238d5` 增加分页定位与历史目标显示,`e95adca8` 修复跨切片历史定位和页边拖动稳定性。
|
||||
- [05 内联字典与长文本](./issues/05-inline-dictionaries-and-long-text.md):`1de1d85b` 将字典和长描述置于固定编辑区,`6c76e5d2` 修复焦点离开后的字典关闭与按键归属。
|
||||
- [06 单路放大与比例适配](./issues/06-camera-inspection-and-aspect-fit.md):`ee3d6b16` 实现单路检查和等比显示,`af7df833` 修复画面遮挡及恢复双路状态。
|
||||
- [07 小窗口暂停与恢复](./issues/07-undersized-viewport-recovery.md):`cb74444e` 在低于最小内容区时暂停并协调在途请求,`972721e2` 修复本人任务晚到结果在恢复前进入工作页的问题。
|
||||
- [08 连续工作整体验收与操作手册](./issues/08-full-workflow-acceptance-and-guide.md):`89c9e168` 完成组合验收和中文手册,`ab89c63a` 修复最终工作流运行器并以单次完整三任务链退出 0 复验。
|
||||
- **当前已知验收限制**:未实测原生操作系统中文输入法、物理显示器与系统缩放;本地最终验收的媒体 members 为 0,因而没有宣称真实验收媒体的视频、姿态或文件完整性通过。未推送、部署或取得 QA 批准。
|
||||
|
||||
以下条目为设计阶段已经确认的选择;其“本轮”措辞不表示当前实施尚未开始。
|
||||
|
||||
- 沿用已确认的业务约束:项目内随机领取、不能领取前挑选视频、已领取任务优先、送检成功才接续;本轮尚未提出变更这些约束。
|
||||
- 当前快捷键和原界面行为需要可恢复;代码恢复点已建立并验证。
|
||||
- 第一轮 Q1 已确认:沿用同标签页独立工作页,进入后收起平台导航,保留原入口。
|
||||
@ -43,11 +58,11 @@ Type: grilling
|
||||
- 第四轮 Q11 已确认:首版自动分配区域空间,不加入可拖拽分栏;保留主动单路放大/恢复。
|
||||
- 第四轮 Q12 已确认:先看可切换内容区尺寸、阶段和字典的交互示意,再确认最终设计。
|
||||
- 视觉评审已接受:最低尺寸下视频面积和编辑区安排可用;单路放大可临时将详细时间轴收成进度条,返回双画面后恢复。
|
||||
- 设计讨论已收敛,已整理正式规格;没有开始改动产品代码。
|
||||
- 设计讨论当时已收敛并整理正式规格;当时尚未开始改动产品代码。
|
||||
|
||||
## 已确认的交互示意
|
||||
|
||||
设计问题已全部回答;以下记录示意范围与验证证据。
|
||||
设计问题已全部回答;以下为实施前示意的范围与验证证据,保留用于说明设计取舍,不替代当前产品验收。
|
||||
|
||||
示意保存在 [preview.html](./preview.html),作为可渲染片段;不接业务 API,不进行真实领取、保存或提交,原布局按钮也只说明回退状态,不伪装已实现原布局切换。
|
||||
|
||||
@ -63,8 +78,8 @@ Type: grilling
|
||||
|
||||
独立本地 Edge 无头实例检查五档内容区、两阶段、字典、三种比例、长文本、放大、确认弹层与小窗口恢复。27 个布局/状态检查通过,未见脚本异常,主要按钮未超出工作页边界,核心区域无内容溢出;截图已人工检查。
|
||||
|
||||
本轮只验证示意,不代表正式工作台已通过浏览器验收。正式功能仍沿用用户认可的真实浏览器操作、API 保存回读为主的边界,额外检查同步帧、草稿/撤销保留、原布局回退、视口变化和在途操作。
|
||||
当时只验证示意,不代表正式工作台已通过浏览器验收。后续实施已采用真实浏览器操作、API 保存回读,并检查同步帧、草稿/撤销保留、原布局回退、视口变化和在途操作;当前结果见[整体验收报告](../../docs/verification/annotation-workspace-layout/acceptance-results.md)。
|
||||
|
||||
本地验证记录在未跟踪目录 `local-data/verification/annotation-workspace-layout/`。当前原工作台及 5173 服务未修改。
|
||||
设计阶段的本地验证记录在未跟踪目录 `local-data/verification/annotation-workspace-layout/`。该阶段的原工作台及 5173 服务未修改;后续实现已修改产品工作台,验证期间仍只使用本地 5173/3001/27018。
|
||||
|
||||
当前没有新增 ADR:已确认的布局选择可逆,且继续沿用共享编辑状态与原有业务契约,不新增难逆转架构取舍。
|
||||
未新增 ADR:已确认的布局选择可逆,且继续沿用共享编辑状态与原有业务契约,不新增难逆转架构取舍。
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user