droboticflow/docs/acceptance-supplier-priority.md

7.3 KiB
Raw Blame History

临时供应商验收优先

#21,决策门 1 已批准方案 B。用途是先处理指定生产供应商的存量验收以便结算,不删除供应商或账号。初版已随 ac1eddcc 部署,配置读取阻塞尚未通过生产验收;下述 fix_a 修复仅本地完成,生产策略保存仍需另行执行。

管理入口与作用范围

平台管理员在账号管理中选择生产供应商,设置“验收优先”的适用项目与到期时间;不选具体项目表示组织内全部项目。可更新或取消。多个有效供应商策略属于同一优先组,不再互相排序。供应商管理员及验收员不能读取或修改这些配置。

配置存入独立 acceptancePriorities 集合,组织与供应商确定唯一 _id,版本 CAS 防止管理员互相覆盖,保留操作人、时间与每次范围/有效期。读取权威存储,不通过检索副本或跨请求权限缓存。到期由请求时判断,不依赖定时作业或写入。

管理员看到所选范围内该供应商未领取的待验收任务数;“归属待核对”是该范围内无法可靠归属的任务数,不表示它们已经归属此供应商。数量不是每位验收员的个人可领取数量,也不是源采集或视频文件数量。已领取任务不计入该数量。

领取顺序与权限

  • 随机领取沿用项目、工作流及来源范围:跨页寻找合法优先候选,在首个含合法优先候选的页面内随机选择;确认优先组耗尽后,回到普通组的首个合法候选页。不是全池均匀随机。
  • 连续审查先继续本人已领任务;领取新任务先遍历优先组,再遍历普通组;每组沿用创建时间顺序。原项目/全部项目范围、页面代次、未确认领取的恢复与决定回执不变。
  • 随机候选接口为 GET /api/acceptance-claim-candidates,仅返回领取所需身份、版本、阶段、轮次与服务端 canClaim。不读取标注/视频证据正文或做展示补全,不返回生产供应商、来源归属或优先原因。质检与标注领取不切换到该接口。
  • 优先策略不授予任何访问或领取权限。列表的服务端权限过滤及正式领取的账号、供应商共享授权、任务版本 CAS 检查仍生效。撤权阻止新领取,原轮次已领任务继续遵守原处理资格;取消或到期不撤回已领取任务及在途合法领取。
  • 任务列表及计数接口不应用优先过滤,总数口径不变。源查询失败或候选扫描未完成返回错误,不能伪装成优先组耗尽并派普通任务。

来源归属与业务保护

经验收批次 SourceBatchID 读取来源批次和来源 HumanItem 的生产供应商;旧记录缺失时可用关联标注任务的稳定归属补足。按页批量只读取身份字段,不经当前员工或手机号推算。跨组织/项目、来源缺失、成员归属不一致或 HumanItem 与标注任务冲突时均视为“归属待核对”,不进入优先组,仍按既有权限留在普通组。不把生产供应商回填到匿名验收任务。

不改变聚合成员、冻结抽样、质检前置、审核决定/意见、生产归属、正式记录或交付结果。返工后重新进入验收仍按稳定来源匹配当时有效策略。只影响已进入验收池的任务,不能据此承诺未抽中或未质检通过的视频也全部经过人工最终验收。

启用与回退

无需回填客户任务或启动迁移;配置集合在管理员首次保存时创建,使用已有 _id 唯一性,不在启动时建新业务索引。生产尚未创建或保存任何本功能配置。

回退代码后新旧任务、意见和决定仍兼容,配置记录保留,但旧版忽略优先策略并恢复普通选择。回退不撤销已领任务。上线后由管理员选择实际供应商、项目和有效期另行启用;不能把部署成功等同策略已经生效。

本地验证及剩余发布事项见 .scratch 任务记录。

配置读取解耦修复(fix_a,本地待发布)

初版已随 ac1eddcc 部署,但管理员配置读取被全组织剩余量统计阻塞,生产策略未启用。决策门 1 已批准本次修复;本节不表示修复已上线。

  • 配置 GET 和保存/取消 PUT /api/suppliers/{supplierId}/acceptance-priority 仅返回已读取或已持久化的配置、版本和生效状态,不执行候选扫描或来源统计。保留原字段名,remainingCount / unresolvedCount 返回 null,附 statisticsStatus: not_requested;这些值未知,不是零。现有调用者仅管理面板及定向测试,随本次配套更新;旧页面可能显示空数字,应刷新页面加载新版本。
  • 管理员统计独立使用 GET /api/suppliers/{supplierId}/acceptance-priority/statistics?version=<配置版本>。服务端总预算 2 秒;完整计算且配置版本仍匹配时返回 status: completed 和数字(包括真实零)。预算耗尽、读取失败或配置已变更时返回 status: incomplete,两个计数均为 null,不返回部分总数。权限、版本参数及供应商边界错误仍返回相应 HTTP 错误。
  • 管理面板先展示配置,再独立加载统计;浏览器统计总预算 3.5 秒,离开或配置版本变化会取消旧请求并丢弃旧结果。统计失败显示“未完成”,可单独重试;不禁用保存或取消、不覆盖“已保存”状态。
  • 单项目统计将项目条件下推,多项目在关联来源前筛选;其余权威来源解析、归属待核对与完整计数规则保持不变。统计仍使用原权威算法,全组织大范围可能在预算内无法完成;本批解除配置阻塞,不承诺全量统计已提速。不引入后台作业、缓存、索引创建或客户数据回填。
  • 成功的 PUT 响应确认配置 CAS 已落库,不再附带可能失败的统计。传输中断仍需刷新核对结果,不能自动重放保存或把网络超时当作确定未保存。

随机领取、连续审查、服务端权限复核、匿名字段、任务版本 CAS 及原有列表/计数接口均不变。真实供应商、项目与有效期仍须管理员另行配置;管理入口修复与实际启用验收前,不得对外宣称优先验收已生效。

每日统计

管理员面板读取组织最近一次成功保存的汇总,按当前已保存配置的项目范围展示“待领取”和“归属待核对”,同时显示北京时间的统计完成时间。首次统计前返回 status: pending、两个计数为 null。配置变化可以直接用同一份分项目汇总计算对应范围。统计读取失败仍可重试。

API 实例在北京时间 01:00–01:30 首轮刷新,01:35–02:05 补跑。每轮由一个实例串行处理,每 100 条候选任务批量解析来源。每轮先筛出当天未完成的组织,再按剩余窗口时间和仍待处理的组织数分配预算,每组织最多 15 分钟。提前完成时,未用的时间留给后续组织。

一个组织完整处理后原子替换其汇总。读取失败或超时后继续处理下一个组织。窗口内重启可以参与尚未被领取的窗口,两轮均未完成时保留最近成功值,次日再试。完成日志记录候选条数和用时。统计反映扫描期间看到的数据,业务领取和配置保存按原流程实时处理。