droboticflow/docs/workforce-statistics.zh-CN.md

10 KiB
Raw Permalink Blame History

人员工作记录统计

本次修正人员仪表盘与标注中心的工作记录。项目生产进度仍按源采集的原有契约统计,不受影响。

显示与口径

  • 供应商按所属组织的目录解析名称,搜索同时支持名称和 ID。目录缺失显示“历史供应商(名称待核对)”,不误显示内部成员。
  • 首交任务数以成功送检的 part 任务为单位去重,归入首次提交发生的期间。送检次数包含首次提交和返工重提。未确认、处理中或失败的提交不计入。
  • 使用提交记录的业务标记判断首交/返工,不按版本号判断。旧记录优先使用对应标注版本的 IsRework/CountsAsOutput,再使用明确的事件类型及正向 outputDelta;缺证据单列待核对。
  • 视频时长分为首交、返工两项,不再显示成工时。从对应切片版本的区间并集或新提交保存的视频时长读取;没有可靠范围时单列待核对,不拿旧 durationSeconds 猜工时或视频时长。
  • 审查视频时长与标注员的首交/返工视频时长分开统计,归给作出决定的审核员本人,按决定完成时间入账。每次已完成的正式通过或退回决定都计入一次,复审重复计入;时长取被审那一版切片的区间并集,舍弃切片也计入,双路相机不重复计时。质检决定使用工作记录中的被审版本;终审按每个来源分别求并集后相加,退回与通过都取该来源在终审决定前最近一次质检通过的版本。返工送检后系统会清理被替换的旧切片版本,因此按以下优先级取被审版本的时长:决定提交时冻结的时长(质检记在该次工作记录上,终审按来源逐个记在审核操作上;2026-10-27 起的新决定)→ 该版本现存切片的区间并集 → 该版本送检记录保存的视频时长(2026-09-29 起的送检有此记录,为切片时长之和,同版本切片互不重叠时与并集相等)。三者都没有、来源无法关联或旧交付包验收路径的决定单列待核对,不计为 0;2026-09-09 至 09-29 间被替换的版本切片已被清理且无送检时长,属于无法恢复的历史缺口。调试任务与其他统计一样默认排除。
  • 审查产出按审核员作出的正式审查决定次数计:质检与终审的通过、退回都计入,复审重复计入;终审聚合决定按一次计,与来源数量无关。只含调试来源的决定不计入;旧交付包验收路径的决定计入次数,时长待核对。审查产出与标注员产出分开,不相加。
  • 审核员(质检、终审)本人看板的“产出”和“视频时长”卡片分别显示审查产出与审查视频时长,代替恒为 0 的标注员口径;团队表格与按天明细新增“审查产出”“审查视频时长”列。
  • 成员角色按账号目录解析,团队表格显示成员角色,按角色筛选只保留该角色成员。
  • “收到打回”与审核员的“审查操作”分列。质检打回归给当时的标注作者;终审打回归给被审来源版本的质检审核员。无法确认归属的记录单列,不按当前领取人分摊。
  • 打回次数按实际完成的正式决定计数;任务数按关联 part 去重。问题对象数、涉及切片数和覆盖视频时长按轮次累计。终审包含多个来源/审核人时,总计决定次数去重,不能简单相加各成员的次数。
  • 每次决定内,同一 scope/source/slice/action 的旧意见只计一个对象,展开仍完整显示每条原文,不解释句意或自动选最后一条。整体意见没有具体时间范围,不展开成整个视频。
  • 片内时间按来源及切片隔离,原视频时间按来源求并集,去除动作与外层切片的覆盖重叠;双路相机不重复计时。不能可靠定位的历史意见明确提示,不伪装成完整的零值。

主表保持精简,默认折叠,展开后按成员展示:成员、供应商、角色、产出、质量通过率、返工次数、视频时长、审查产出和审查视频时长;点击成员再加载按天产出/通过率/返工及分页打回意见。质量通过率只以已通过或退回的决定为分母,返工暂只显示次数,不推算返工率。评分、排名、结算公式仍未启用。

生产总览与供应商产出中的审核员

/api/dashboard/annotation-output(生产总览、供应商产出)在原标注员区块之外,按同样的卡片和表格样式增加质检员、验收员区块;页面布局与原标注员口径不变,时长统一以小时显示并保留一位小数(不足 0.1 小时的非零时长显示“<0.1 小时”)。

  • 审查次数按正式通过或退回决定所涉 part 计:质检每次决定计一个 part;终审一次决定涉及多个 part 时按 part 分别计入,同一决定内同一 part 的多个任务只计一次。同一 part 返工后再次审查重复计入,并在“其中复审”中单列(同环节对该 part 已有更早决定即为复审,判断使用全部历史,不受所选期间影响)。草稿保存、未完成或失败的操作、调试任务不计入。
  • 审查时长取被审 part 的整段视频时长,与同页标注员各项时长口径一致;它与“人员工作记录统计”面板中按被审切片版本求并集的审查视频时长不是同一口径,两处数值可能不同。任一被审 part 缺少可靠时长时合计显示“—”,不按 0 计。
  • 审核员归属其账号所属供应商,不改变被审 part 的生产供应商归属;供应商管理员只看到本供应商审核员的审查。人员筛选同时适用于标注员与审核员。
  • 人均日产出/人均日审查=期间视频小时 ÷ 人天。人天为一名人员在一个本地自然日至少有一次本角色正式工作:标注员为成功送检(含返工重提,分子仍为首次提交视频小时),审核员为正式审查决定。它不是实际工时,平台没有记录登录或在线时长。
  • 这些事实随共享快照一起计算(每 2 分钟),查询只在内存中过滤与汇总;快照 schema 升至 annotation-output-facts/v2,发布后首次访问会重新生成一次快照。新增读取字段仅为审核员身份(reviewerUserId、userId、actorUserId),不新增集合、索引或写入业务数据。

接口、权限与兼容

/api/dashboard 和 /api/plugins/annotation-qa/workload-summary 共用 internal/workforcestats。新增明确命名的统计字段,旧字段保留;仪表盘首次请求可用 includeWorkforce=false 延迟工作记录,展开后使用 GET /api/dashboard/workforce,支持 projectId、supplierId、from、to、role、userId 和 groupBy=member|day。标注中心新增区间及总计,默认与仪表盘同为最近 30 天,支持 from/to,最大 366 天。旧的时长字段只为兼容保留,页面不再用于工时显示。

GET /api/workforce-returns 提供按成员、供应商、项目、模板和区间收窄的只读明细。管理员限所属组织;供应商管理员限本供应商;其他成员只能看本人。标注中心额外沿用项目可见性和有效成员授权。参数不能扩大权限。

正式决定只读取 completed 的操作快照;未完成/失败操作与可变草稿不入账。旧正式审核记录没有结构化快照时保留打回次数及原文,范围待核对,不猜问题数和持续时间。

新送检工作记录增加稳定提交 ID、首交/返工标记、视频时长;同一提交的工作记录使用固定 ID 并仅首次写入,重试保留原来的成功时间和归属。读取旧事件时批量关联相关任务的提交历史,同一任务、同一正式版本按最早成功事件去重,避免跨日期重试再次入账。

查询使用区间和组织/供应商/项目过滤、字段投影与批量关联,正文仅在展开明细时加载。本人范围只关联本人决定涉及的任务;切片区间只为送检提交、本人质检决定和终审来源读取,不随打回归属关联扩大。未增加线上索引或持久化统计表。 切片区间按计算器会使用的“任务+正式版本”分批读取:有可靠冻结时长时不再读取对应切片;旧提交按既有去重规则选择版本,历史终审仍按决定前最后一次质检通过的版本回退。不会为期间关联到的任务加载全部自动保存历史。

数据边界与回退

不迁移或改写旧意见、标注 JSON、媒体、任务状态、审核结果。原作者和来源使用正式决定冻结的证据;兼容已精简为并发检查用途的 BeforeItem,从同一决定保存的 Item 获取未变的作者/来源身份,再关联被审版本。当前草稿的清除不能抹去历史正式决定。

旧数据不足时显示待核对,新记录逐步补齐证据。同一来源混用片内与原视频时间而缺少可靠转换依据时,不盲目相加,相关范围标为待核对。新增字段为可选,回退应用不需要回滚历史数据;旧应用会重新显示旧报表口径。公司部署、线上验收、PR 或推送均需按仓库规则另获授权。

验证

回归覆盖高版本首交、返工、重复请求、跨时间区间、调试隔离、不同供应商/成员权限、正式与失败决定、轮次累计与任务去重、旧多条意见原文、区间并集、多来源片内时间、整体意见、历史归属和翻页。另在本地隔离 Mongo 合成库验证投影查询与内存结果一致,使用独立本地账号进行真实页面验收。

审核员进入仪表盘

质检审核员和最终验收员进入仪表盘时默认展开并加载“我的工作记录”,仍可手动收起;其他角色保留原展开策略。

生产质量总览(2026-10-29)

新仪表盘改用 ADR 0012 的首次送检批次口径,日期范围只筛数据,展示批次最新状态。上文按事件发生期间统计的接口仍保留兼容,不应用于新页面的质量比率。共享快照 schema 为 v3,更新周期仍为 120 秒。管理员、供应商和三种生产角色自动展示新面板;原监控面板按需展开。公式与实现说明不常驻业务页面。