droboticflow/docs/acceptance-supplier-priority.md

54 lines
7.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 临时供应商验收优先
#21,决策门 1 已批准方案 B。用途是先处理指定生产供应商的存量验收以便结算,不删除供应商或账号。初版已随 `ac1eddcc` 部署,配置读取阻塞尚未通过生产验收;下述 fix_a 修复仅本地完成,生产策略保存仍需另行执行。
## 管理入口与作用范围
平台管理员在账号管理中选择生产供应商,设置“验收优先”的适用项目与到期时间;不选具体项目表示组织内全部项目。可更新或取消。多个有效供应商策略属于同一优先组,不再互相排序。供应商管理员及验收员不能读取或修改这些配置。
配置存入独立 `acceptancePriorities` 集合,组织与供应商确定唯一 `_id`,版本 CAS 防止管理员互相覆盖,保留操作人、时间与每次范围/有效期。读取权威存储,不通过检索副本或跨请求权限缓存。到期由请求时判断,不依赖定时作业或写入。
管理员看到所选范围内该供应商未领取的待验收任务数;“归属待核对”是该范围内无法可靠归属的任务数,不表示它们已经归属此供应商。数量不是每位验收员的个人可领取数量,也不是源采集或视频文件数量。已领取任务不计入该数量。
## 领取顺序与权限
- 随机领取沿用项目、工作流及来源范围:跨页寻找合法优先候选,在首个含合法优先候选的页面内随机选择;确认优先组耗尽后,回到普通组的首个合法候选页。不是全池均匀随机。
- 连续审查先继续本人已领任务;领取新任务先遍历优先组,再遍历普通组;每组沿用创建时间顺序。原项目/全部项目范围、页面代次、未确认领取的恢复与决定回执不变。
- 随机候选接口为 `GET /api/acceptance-claim-candidates`,仅返回领取所需身份、版本、阶段、轮次与服务端 `canClaim`。不读取标注/视频证据正文或做展示补全,不返回生产供应商、来源归属或优先原因。质检与标注领取不切换到该接口。
- 优先策略不授予任何访问或领取权限。列表的服务端权限过滤及正式领取的账号、供应商共享授权、任务版本 CAS 检查仍生效。撤权阻止新领取,原轮次已领任务继续遵守原处理资格;取消或到期不撤回已领取任务及在途合法领取。
- 任务列表及计数接口不应用优先过滤,总数口径不变。源查询失败或候选扫描未完成返回错误,不能伪装成优先组耗尽并派普通任务。
## 来源归属与业务保护
经验收批次 `SourceBatchID` 读取来源批次和来源 HumanItem 的生产供应商;旧记录缺失时可用关联标注任务的稳定归属补足。按页批量只读取身份字段,不经当前员工或手机号推算。跨组织/项目、来源缺失、成员归属不一致或 HumanItem 与标注任务冲突时均视为“归属待核对”,不进入优先组,仍按既有权限留在普通组。不把生产供应商回填到匿名验收任务。
不改变聚合成员、冻结抽样、质检前置、审核决定/意见、生产归属、正式记录或交付结果。返工后重新进入验收仍按稳定来源匹配当时有效策略。只影响已进入验收池的任务,不能据此承诺未抽中或未质检通过的视频也全部经过人工最终验收。
## 启用与回退
无需回填客户任务或启动迁移;配置集合在管理员首次保存时创建,使用已有 `_id` 唯一性,不在启动时建新业务索引。生产尚未创建或保存任何本功能配置。
回退代码后新旧任务、意见和决定仍兼容,配置记录保留,但旧版忽略优先策略并恢复普通选择。回退不撤销已领任务。上线后由管理员选择实际供应商、项目和有效期另行启用;不能把部署成功等同策略已经生效。
本地验证及剩余发布事项见 [.scratch 任务记录](../.scratch/acceptance-supplier-priority/work.md)。
## 配置读取解耦修复(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 分钟。提前完成时,未用的时间留给后续组织。
一个组织完整处理后原子替换其汇总。读取失败或超时后继续处理下一个组织。窗口内重启可以参与尚未被领取的窗口,两轮均未完成时保留最近成功值,次日再试。完成日志记录候选条数和用时。统计反映扫描期间看到的数据,业务领取和配置保存按原流程实时处理。