3.2 KiB
3.2 KiB
标注员按项目随机领取
使用规则
- 标注员先选择有标注权限的项目,再点击“随机领取任务”。领取前不展示可挑选的 Capture 列表或视频。
- 只在该项目、该账号有效供应商权限内的未领取标注阶段任务中随机选择。不会跨项目、跨供应商,也不会领取质检或验收任务。
- 领取成功后进入工作台;刷新、返回任务列表或退出登录不会解除领取关系。
- 标注员不能主动释放任务。隐藏按钮的同时,原按 ID 领取接口、未领取内容访问和释放接口在服务端受限。
- 原地调整切片结构(拖边界、合并、拆分、舍弃,含
E切片编辑模式)是既有编辑操作,不需要释放任务,不改变领取人;“重新切片”入口已删除(见 ADR 0007)。 - 不新增每人只能持有一条任务的限制;每次明确的新领取请求可再领取一条。当前未确认编辑仍受已有离开保护约束,不新增自动保存。
- 管理员、质检员、验收员原有权限保持不变。不迁移已有任务、不变更员工角色或供应商归属。
接口与并发
GET /api/plugins/annotation-qa/claim-projects:当前标注员可领取的有效项目。POST /api/plugins/annotation-qa/random-claims:{projectId, requestId},随机范围不受任务列表第一页限制。- 同一账号、组织、项目和 requestId 是一次逻辑请求。成功返回
item和关联task;无任务返回no_claimable_task。 - 浏览器将未确定结果的 requestId 保留在会话存储中;断网重试使用原编号,成功或明确无任务后才生成新编号。普通 HTTP 环境使用
crypto.getRandomValues,不依赖仅安全上下文可用的randomUUID。 - 副本集 Mongo 使用事务。单机 Mongo 使用持久化候选预约、HumanItem 版本比较更新及幂等记录同步;一次请求永久对应同一候选,不能因重启或重试变成另一条。
- 单机模式若候选被其他人抢先领取,返回
claim_candidate_taken,提示再次随机领取。此明确失败才允许下一次新请求;不将网络超时当作未领取。 - HumanItem 是领取关系的依据;关联任务、批次、尝试记录、审计记录同步完成才返回成功。中断后的同请求重试补齐原记录,不再次分配。管理员后续改派或提交不会被旧请求重新分配回来。
- 领取记录位于
humanClaimRequests;内部claimRequestId不输出到业务 JSON。已有单机数据库无需改为副本集。
验证
- API 单测覆盖重复/新请求、并发、项目/角色/供应商权限、空池、无效关联、禁止释放及管理员和质检员兼容行为。
- 旧版四阶段与合并标注生命周期继续覆盖,避免改变返工状态与产出统计。
TestHumanClaimMongoStandalone为显式启用的真实 Mongo 集成测试:MONGO_CLAIM_INTEGRATION=1,读取MONGO_URI,只在自动生成的random_claim_test_<timestamp>独立库内运行并清理。TestRandomClaimLocalPreview为显式启用的回环地址内存预览,不连接生产数据库。