Files
AM516/capabilities/am516-delivery-prediction/docs/production_quantity.md

2.8 KiB
Raw Blame History

交期预测数量传递规则

计算责任

AR51 于 2026-10-15 检查上游 API 的交期预测逻辑后确认:接口已核算可用库存;并明确取消机器人本地的扣库存、95% 合格率折算和向上取 5 台倍数规则。此确认是本次修正依据,不代表已经实时验证服务端或运行电脑。

D = 用户原始需求数量(正整数)
API quantity = D

每个型号只通过受控脚本查询一次,原型号和各候选型号都传原始需求 D。机器人保留型号推荐、结果整理和记录能力;库存扣减及交期测算由上游 API 处理。

示例与输出

原始需求 API 返回可用库存 API 查询数量 库存展示
12 10 12 部分覆盖,仍需补齐 2 台
8 5 8 部分覆盖,仍需补齐 3 台
24 0 24 需生产/采购
24 24 24 完全覆盖
24 30 24 完全覆盖

库存覆盖按原始需求与该型号 API 返回的库存比较,仅用于展示。展示差额不回传 API,不作为机器人计算的排产数量。每个候选展示自己的库存,不能沿用原型号或其他候选的库存。

库存缺失或无效时显示待复核,不视作 0;如果 API 已返回有效工作日交期和最终交货日期,机器人保留该交期并标明库存覆盖无法判断。缺失有效交期字段或请求失败时继续执行原有异常处理。

飞书报告展示需求数量、API 返回交期和库存覆盖情况。按 AR51 于 2026-10-16 的显示要求,首次及续查回复均不显示“数量传递规则”“库存覆盖口径”和各型号下的“API查询数量”,也不输出本地净需求或排产测算数量。内部记录仍保存数量规则、原始需求及每个型号实际 API 查询数量,历史记录不改写。

已取消的旧逻辑

  • 不再先读取库存、在本地扣减后发起第二次生产数量查询。
  • 不再按 95% 合格率放大需求或取 5 台倍数。
  • 不再根据“库存不足原需求、但足以覆盖本地排产量”拦截结果。
  • 不再要求接口为这个本地拦截增加“原始需求、排产数量”双参数。

运行电脑同步验收

运行电脑须拉取包含桥接代码、项目内 Skill、测试及说明的完整版本并重启交期回复机器人。本次无需新增依赖或配置。

先执行 python3 -m unittest discover -s tests -q。随后在既有 API 审批及功能测试授权范围内验证 eRob70F50I-FHM-18ET[V4] 12台,核对实际发送的 quantity 为 12,机器人显示的工作日、最终日期及缺料摘要与同一 API 响应一致。API 库存以验证时实时返回值为准,不能假定仍为 10 台。

分别报告本机验证、远端同步和运行电脑验证;本地模拟测试通过不代表服务端或运行电脑已验证,推送成功不代表运行端已生效。