# 交期预测数量传递规则

## 计算责任

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

```text
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 台。

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