标注任务
标注任务承载从数据到标注、审核、提交的完整过程，是平台标注与审核工作的基本单位。本页定义任务的字段、状态与操作；任务的创建与指派操作见 新建标注任务。
使用前提
| 项 | 内容 |
|---|---|
| 菜单入口 | 数据 → 标注 |
| 路由 | 任务列表 /tasks；新建 /tasks/new；任务详情 /tasks/{id} |
| 必需权限 | 「查看标注任务」 |
| 相关权限 | 「执行标注」、「审核标注」、「管理标注任务」 |
| 可见角色 | 管理员、项目经理、审核员、标注员。采集员的角色不在菜单允许列表 |
| 生效规则 | 管理员不受模块权限限制，全部为读写；其他角色按角色默认模板生效，用户级覆盖优先于角色默认；未配置的模块为禁止 |
模块权限的配置方式见 模块权限。各角色的模块默认级别：
| 角色 | 「查看标注任务」 | 「执行标注」 | 「审核标注」 | 「管理标注任务」 |
|---|---|---|---|---|
| 项目经理 | 读写 | 读写 | 读写 | 读写 |
| 审核员 | 只读 | 禁止 | 读写 | 禁止 |
| 标注员 | 只读 | 读写 | 禁止 | 禁止 |
| 采集员 | 只读 | 禁止 | 禁止 | 禁止 |
任务定义
任务字段
任务字段定义于 tasks 表。
| 字段 | 含义 | 约束 |
|---|---|---|
| 任务名 | 任务名称 | 全平台唯一 |
| 所属项目 | 任务归属的项目 | 由创建表单选择 |
| 标注员 | 执行标注的账号 | 必填，一人 |
| 审核员 | 审核标注的账号 | 可留空；留空时任务无审核人 |
| 创建人 | 创建任务的账号 | 记录为更改任务状态的关联人员 |
| 状态 | 任务当前状态 | 6 个取值之一，见「任务状态」 |
| 不通过原因 | 审核打回时填写的原因 | 状态为「检查不合格」时保存，最多 1000 字 |
| 创建时间 | 任务创建时间 | 用于列表排序与按日期筛选 |
任务状态
任务状态共 6 个，与界面显示的名称一一对应。
| 状态 | 允许的下一状态 |
|---|---|
| 待开始 | 工作中 |
| 工作中 | 待检查 |
| 待检查 | 检查合格、检查不合格、工作中 |
| 检查不合格 | 待检查、检查合格 |
| 检查合格 | 检查不合格、提交数据 |
| 提交数据 | 无，为终态 |
「允许的下一状态」决定任务详情侧栏「当前流程」下出现的操作项，取当前状态与该角色可设置状态的交集，另附「上一步」入口用于回退。
状态变更权限
状态变更受角色与身份两层限制。角色层决定谁可以把任务置为某个状态：
| 状态 | 可设置该状态的角色 |
|---|---|
| 待开始 | 管理员、项目经理、审核员、标注员、采集员 |
| 工作中 | 管理员、项目经理、审核员、标注员、采集员 |
| 待检查 | 管理员、项目经理、审核员、标注员、采集员 |
| 检查不合格 | 管理员、项目经理、审核员 |
| 检查合格 | 管理员、项目经理、审核员 |
| 提交数据 | 管理员、项目经理 |
身份层在角色层之外生效。管理员与项目经理不受身份限制；其他角色须为任务相关人员：
| 操作者 | 可设置的状态 | 说明 |
|---|---|---|
| 任务标注员 | 待开始、工作中、待检查 | 不能设置检查合格及之后的状态 |
| 任务审核员 | 检查合格、检查不合格 | 不能设置其它状态 |
| 任务创建人 | 与所属角色允许的状态一致 | 用于创建人代管任务 |
| 其他账号 | 无 | 接口返回 403 |
任务处于检查合格时，标注员不能变更状态，确保审核结论不被改写。
数据集与检查结果
任务通过 dataset_tasks 关联数据集，每条关联记录带一份检查结果。
| 字段 | 含义 | 约束 |
|---|---|---|
| 数据集 | 任务关联的数据集 | 一条数据集同一时间只归属一个任务 |
| 检查结果 | 检查合格（VALID）或检查不合格（INVALID） | 未判定时为空 |
| 数据不通过原因 | 检查不合格时填写的原因 | 最多 1000 字 |
注意
标注 员将数据的检查结果标记为检查合格时，服务端不记录该结果（写回空值）。数据的检查合格与检查不合格由任务的审核员、管理员或项目经理标记。
任务操作
列表与筛选
| 维度 | 说明 |
|---|---|
| 状态分组 | 顶部标签按状态分组并显示各状态任务数；「全部任务」显示合计 |
| 视图 | 全部任务视图提供横向视图（按状态分列）与纵向视图（统一列表） |
| 任务名 | 按名称模糊匹配 |
| 所属项目 | 按项目筛选 |
| 标注员 | 按标注员账号筛选 |
| 审核员 | 按审核员账号筛选 |
| 创建日期 | 按创建日期筛选，格式为 YYYY-MM-DD |
| 分页 | 底部显示每页条数与总条数 |
筛选条件写入 URL 查询参数，可直接分享带筛选条件的链接。
任务详情
任务详情页由侧边栏与四个标签页组成。
| 标签页 | 路由 | 内容 |
|---|---|---|
| 标注数据 | /tasks/{id}/dataset | 任务关联的数据集列表、检查结果与逐条操作 |
| 批量标注 | /tasks/{id}/repeats | 批量标注工作区 |
| 问题标注 | /tasks/{id}/invalids | 标记为无效的标注条目 |
| 标注统计 | /tasks/{id}/analysis | 任务内标注描述与统计 |
侧边栏显示任务封面、任务名、项目、标注员、审核员与进度，并提供以下操作：
| 操作 | 作用 | 约束 |
|---|---|---|
| 编辑任务 | 修改任务名、所属项目、标注员与审核员 | 需「管理标注任务」 |
| 删除任务 | 逻辑删除任务 | 需「管理标注任务」，删除后可在回收站恢复 |
| 当前流程 | 展示当前状态与可执行的下一步、上一步 | 按角色与身份过滤 |
批量操作
在任务列表勾选任务后，底部操作栏提供批量删除。删除逐个执行，采用逻辑删除，数据集本身不受影响；删除的任务进入 回收站 后可恢复。
任务列表右上角的「创建标注任务」按钮在账号具备 「管理标注任务」 写权限时显示，进入 新建标注任务 的表单。
批量标注
批量标注工作区提供三种模式。三种模式均在同一任务的数据集范围内生效。
| 模式 | 作用 |
|---|---|
| 快速标注 | 为任务内全部数据集添加相同的标注描述 |
| 批量复制标注 | 将样例标注按时间轴比例复制到其它数据集 |
| 批量替换标注 | 按规则批量替换描述、对象与目标等文案 |
工作区包含样本选择器、标注进度条与标注模式选择。
约束与限制
| 项目 | 取值 | 说明 |
|---|---|---|
| 任务名 | 全平台唯一 | 创建时若同名，系统追加序号（如「任务 (2)」）；编辑为已存在的名称时接口返回 400 |
| 数据集归属 | 一条数据集同一时间只归属一个任务 | 将数据集加入任务时，自动从其它任务中移除该数据集 |
| 不通过原因长度 | 最多 1000 字 | 超出部分截断 |
| 检查结果标记 | 检查合格仅由任务审核员、管理员或项目经理标记 | 标注员标记合格时服务端写回空值 |
| 状态变更 | 仅任务标注员、审核员、创建人或管理员、项目经理 | 其他账号返回 403 |
| 已检查合格的任务 | 标注员不可再变更状态 | 由审核员或管理员、项目经理操作 |
| 批量操作 | 仅支持批量删除 | 无其它批量操作 |
失败处理
| 现象 | 可能原因 | 处置 | 责任方 |
|---|---|---|---|
| 提示「任务名称已存在」 | 编辑任务时名称与其它任务重复 | 更换任务名 | 项目经理、管理员 |
| 提示「任务不存在」 | 任务已被删除，或任务 ID 无效 | 返回列表确认任务是否存在 | 标注员、审核员、项目经理 |
| 提示无权访问该任务 | 账号不在任务所属项目、不是任务相关人员、或任务所属项目非公开 | 由项目成员或管理员将账号加入项目并指派 | 项目经理、管理员 |
| 提示「任务已审核合格，无法修改」 | 标注员尝试变更已检查合格的任务 | 由审核员或管理员、项目经理变更 | 审核员、管理员 |
| 提示「标注员只能将任务状态修改为"工作中"或"待检查"」 | 标注员选择了越权状态 | 选择允许的状态 | 标注员 |
| 提示「审核员只能将任务状态修改为"检查合格"或"检查不合格"」 | 审核员选择了越权状态 | 选择允许的状态 | 审核员 |
| 提示「您的角色没有权限将任务设置为该状态」 | 账号角色不在该状态的允许列表 | 由具备权限的角色操作 | 项目经理、管理员 |
| 提示「状态参数不能为空」或「无效的任务状态」 | 请求未带状态，或状态值非法 | 从任务详情侧栏选择状态 | 标注员、审核员 |
| 提示「无权限访问」 | 在公开项目中创建任务，但账号不是项目成员 | 由项目成员创建，或请管理员加入项目 | 项目经理、管理员 |
| 提示「只有管理员可以修改公开项目任务的所属项目」 | 项目经理修改公开项目任务的所属项目 | 由管理员操作 | 管理员 |
| 提示无权将任务移动到该项目 | 目标项目不在账号可管理的范围 | 选择有权限的项目 | 项目经理 |
| 提示「非项目成员禁止修改结果」 | 非项目成员修改数据检查结果 | 由项目成员或管理员操作 | 项目经理、管理员 |
| 列表为空 | 筛选条件过窄、项目范围选择错误、或账号无任务可见性 | 重置筛选、切换项目范围，或确认项目成员身份 | 标注员、审核员、项目经理 |
相关页面
| 页面 | 用途 |
|---|---|
| 新建标注任务 | 创建任务、指派标注员与审核员的操作过程 |
| 数据管理 | 筛选并勾选待标注数据集 |
| 数据质检 | ROS 录制的自动质量检测规则 |
| 数据导出 | 导出标注结果用于训练 |
| 回收站 | 恢复已删除的任务与数据 |
| 模块权限 | 模块权限的配置方式 |
| 标注员操作指南 | 标注员的执行流程 |
| 审核员操作指南 | 审核与打回流程 |