#moon-mrp

#三种工作流

1. 装配与共享子件：计划员输入第 5 期 9 套 KIT、期初 1 套库存、两层 BOM 与 MODULE 备件需求；计划补 KIT 10、MODULE 16，RAW 分别补 43 和 10。RAW 同时被 KIT 和 MODULE 使用，在所有父项贡献到齐后统一净算。
2. 门店/仓库补货：输入 LABEL 期初 3、安全库存 2、第 1 期需求 9、第 2 期需求 3、到货 2、最小订购量 10 且倍数为 4，得到第 1 期补货 12，结存继续覆盖后续需求。
3. 供应承诺变更重算：维修计划输入 PART 库存 2、第 3 期需求 8，计划补货 6；供应商确认第 2 期到货 3 后，使用同一 API 重算，计划补货降为 3。旧计划和输入保持不变，可由业务系统自行比较并审批。

#本地运行

git clone https://github.com/sun-zhao12/moon-mrp
Set-Location moon-mrp
moon check --deny-warn --target all
moon build --target all
moon test --deny-warn --target all
moon run examples/demo --target wasm --deny-warn
moon run examples/replenishment --target wasm --deny-warn
moon fmt --check
moon info

#API

let request : @mrp.Request = {
  horizon: 4,
  items: [{ sku: "PART", on_hand: 2L, safety_stock: 0L, lead_time: 1, lot: LotForLot }],
  bom: [],
  demands: [{ id: "repair", item: "PART", bucket: 3, quantity: 8L }],
  receipts: [],
}
let result = @mrp.plan(request).unwrap()
// quantity=6, receipt_bucket=3, release_bucket=2
println(result.to_json().stringify())

#计划语义

• 周期编号为 0..horizon-1，不隐含天、周、时区或工作日。on_hand 是第 0 期期初已有库存；receipts 在所属期可用，不可向前借用。
• 先验证全部输入与整个 BOM，再按父项优先的确定性拓扑序净算。即使暂时无需求，成环、自引用、非法数量或未知引用也不能被忽略。
• 每期 available = 上期结存 + 本期到货，net = max(0, 毛需求 + 安全库存 - available)；按批量规则求计划收货，然后扣毛需求得到结存。安全库存是每期期末下限，不是每期重复加入的毛需求。
• LotForLot 按净需求；Multiple(m) 向上取倍数；MinimumMultiple(min,m) 先满足最小量，再取倍数。净需求为 0 时不发单，即便有最小订购量。
• 计划收货提前 lead_time 期下达；只有新计划下达的父项数量按 BOM 生成子项毛需求。现货及已排定父项到货不再消耗一次子件。
• 如果任何计划下达早于第 0 期，返回 BeforeHorizon(item, receipt_bucket, release_bucket)，整次计算不返回部分计划；扩展前置空周期或调整已知到货后重新运行。绝不把负周期偷偷移到第 0 期。
• Peg 记录独立需求 ID 或父项计划订单（父项 SKU、收货期）对某个子项某期的毛需求贡献，其合计等于对应 gross。它不是安全库存分摊或逐个现货批次分配证明。
• 输出 SKU 与 ID 使用 UTF-16 字典序，订单按 SKU/收货期排列；行输入顺序不影响结果，不修改调用方数组。Cycle 的列表是拓扑中被阻塞的节点，可包含环的下游节点，不宣称每项都在环上。

#输入与数值边界

#发布到 Mooncakes

moon login                  # 用 sun-zhao12 登录 Mooncakes
moon whoami                 # 应输出 sun-zhao12
moon publish --dry-run      # 本地打包 + 对压缩包再跑一遍 check
moon publish

#实现与验证