fix: pass original demand to delivery prediction API

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

@@ -1,57 +1,43 @@
-# 交期预测数量规则
+# 交期预测数量传递规则
 
-可用成品库存已视为100%可用，只对需要新生产的缺口考虑合格率。
+## 计算责任
+
+AR51 于 2026-10-15 检查上游 API 的交期预测逻辑后确认：接口已核算可用库存；并明确取消机器人本地的扣库存、95% 合格率折算和向上取 5 台倍数规则。此确认是本次修正依据，不代表已经实时验证服务端或运行电脑。
 
 ```text
-D = 原始需求数量
-S = 该型号可用库存（API字段：可用库存(扣除了待产数量)）
-净需求 = max(D - max(S, 0), 0)
-最终排产测算数量 P = 5 × ceil(净需求 ÷ 0.95 ÷ 5)
+D = 用户原始需求数量（正整数）
+API quantity = D
 ```
 
-净需求为0时，P为0；固定不良率5%，对应合格率95%。先扣库存，再除以合格率，最后向上取5的倍数。使用整数运算，避免边界浮点误差。库存缺失或不是有效整数时不能视作0；负整数余额按无可用库存参与计算。
+每个型号只通过受控脚本查询一次，原型号和各候选型号都传原始需求 D。机器人保留型号推荐、结果整理和记录能力；库存扣减及交期测算由上游 API 处理。
 
-| 原始需求 | 可用库存 | 净需求 | 排产测算数量 |
-|---:|---:|---:|---:|
-| 24 | 6 | 18 | 20 |
-| 24 | 0 | 24 | 30 |
-| 24 | 24 | 0 | 0 |
-| 24 | 30 | 0 | 0 |
-| 25 | 6 | 19 | 20 |
-| 5 | 1 | 4 | 5 |
-| 95 | 0 | 95 | 100 |
+## 示例与输出
 
-每个候选使用自己的库存，不累计多个候选的库存。续批保留原始需求，对新候选重新读取库存及计算，不对已折算数量重复折算。
+| 原始需求 | API 返回可用库存 | API 查询数量 | 库存展示 |
+|---:|---:|---:|---|
+| 12 | 10 | 12 | 部分覆盖，仍需补齐 2 台 |
+| 8 | 5 | 8 | 部分覆盖，仍需补齐 3 台 |
+| 24 | 0 | 24 | 需生产/采购 |
+| 24 | 24 | 24 | 完全覆盖 |
+| 24 | 30 | 24 | 完全覆盖 |
 
-报告示例（需求24，可用库存6）：
+库存覆盖按原始需求与该型号 API 返回的库存比较，仅用于展示。展示差额不回传 API，不作为机器人计算的排产数量。每个候选展示自己的库存，不能沿用原型号或其他候选的库存。
 
-```text
-需求数量：24台
-扣库存后净需求：18台
-排产测算数量：20台
-可用库存/覆盖情况：整机可用库存6台（部分覆盖，仍需补齐18台）
-```
+库存缺失或无效时显示待复核，不视作 0；如果 API 已返回有效工作日交期和最终交货日期，机器人保留该交期并标明库存覆盖无法判断。缺失有效交期字段或请求失败时继续执行原有异常处理。
 
-库存覆盖始终比较原始需求，不能比较排产量。各型号排产量可能不同，报告顶部显示计算规则，各型号明细及新记录元数据分别显示数量；历史记录不改写，候选表列不改变。
+报告展示需求数量、API 查询数量、API 返回交期和库存覆盖情况，不再输出本地净需求或排产测算数量。新记录保存原始需求及每个型号实际 API 查询数量，历史记录不改写。
 
-## 受控API查询
+## 已取消的旧逻辑
 
-1. 先以D调用受控脚本，读取该型号库存。
-2. 库存足量：P=0，沿用第一次查询的现货交期；不发送quantity=0。
-3. 库存不足且P=D：第一次查询已符合排产数量，不重复查询。
-4. 库存不足且P与D不同：以P调用同一受控脚本，交期、缺料明细及主导因素取第二次响应。两次库存必须一致，否则结果不可用，需要重新查询。
-5. 第一响应无有效库存或必需工作日/日期字段时，结果不可用。
-
-低层脚本仍原样传递quantity。日期与工作日仍直接使用API返回值，不在本地推算。
-
-## 现有接口限制
-
-现有WithTransit交接口径中，quantity同时参与成品现货判断和本次生产/BOM数量测算。若 `0 < P <= S < D`，传P会误判现货。例如D=24、S=20，净需求4、P=5，但20台库存不能覆盖24台需求。此时本地能计算正确排产量，却不能从现有单数量参数获得可靠生产交期；明确报交期不可用，原型号停止出具报告，候选列入不可用清单。需要AR836接口支持分别输入原需求和排产量后解除该限制。
-
-不能改传S+P：这会使API按包含库存的数量测算物料和生产。也不能使用第一次D查询的交期充当P的交期。该限制依据既有接口交接说明，尚未完成当前服务端的实时验证；本次本机测试使用模拟响应。
+- 不再先读取库存、在本地扣减后发起第二次生产数量查询。
+- 不再按 95% 合格率放大需求或取 5 台倍数。
+- 不再根据“库存不足原需求、但足以覆盖本地排产量”拦截结果。
+- 不再要求接口为这个本地拦截增加“原始需求、排产数量”双参数。
 
 ## 运行电脑同步验收
 
-运行电脑须拉取包含桥接代码、项目内Skill、测试及说明的完整版本并重启交期回复机器人。无需新增依赖、配置或重装物料名称刷新服务。
+运行电脑须拉取包含桥接代码、项目内 Skill、测试及说明的完整版本并重启交期回复机器人。本次无需新增依赖或配置。
 
-执行 `python3 -m unittest discover -s tests -q`，并在既有API审批及功能测试授权范围内检查需求24/库存6、库存完全覆盖、不同候选库存、续批，以及部分库存误走现货分支样例。核对数量、实际API参数、库存变化处理与API最终日期。推送成功不代表运行电脑已生效。
+先执行 `python3 -m unittest discover -s tests -q`。随后在既有 API 审批及功能测试授权范围内验证 `eRob70F50I-FHM-18ET[V4] 12台`，核对实际发送的 quantity 为 12，机器人显示的工作日、最终日期及缺料摘要与同一 API 响应一致。API 库存以验证时实时返回值为准，不能假定仍为 10 台。
+
+分别报告本机验证、远端同步和运行电脑验证；本地模拟测试通过不代表服务端或运行电脑已验证，推送成功不代表运行端已生效。