#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。旧计划和输入保持不变。
4. 良率、损耗、小数用量与单位换算：PANEL 良率 95%，1 台用 2500 G 涂料、损耗 20%，涂料基础单位 KG。计划 PANEL 8.422，涂料需求 25.268 KG。
5. 期间订货量：PeriodOrder(3) 把随后 3 期的净需求合成一张订单，避免每期小单。
6. 提前期不足：默认严格策略拒绝整次计算；AllowLate 把下达钳到第 0 期，标记 late 并输出 incident 供加急决策。
7. 虚拟件、安全库存策略与再订货点：虚拟件透传展开；安全库存可选固定值、需求天数或需求百分比；ReorderPoint(level, quantity) 实现"再订货点 + 再订货量"；超过 max_stock 的结存进入 exceptions。

#本地运行

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

#API

let request : @mrp.Request = {
  horizon: 4,
  items: [{
    sku: "PART",
    unit: "EA",
    on_hand: @mrp.Qty::int(2),
    safety: @mrp.SafetyStock::Fixed(@mrp.Qty::int(1)),
    max_stock: @mrp.Qty::zero(),
    lead_time: 1,
    yield_per_mille: 1000,
    lot: @mrp.LotForLot,
    phantom: false,
  }],
  bom: [],
  demands: [{ id: "repair", item: "PART", bucket: 3, quantity: @mrp.Qty::int(8) }],
  receipts: [],
  conversions: [],
  policy: @mrp.Strict,
}
let result = @mrp.plan(request).unwrap()
// safety 1, on_hand 2, demand 8 at bucket 3, lead 1:
// net 7, quantity 7, receipt_bucket 3, release_bucket 2
println(result.to_json().stringify())

#计划语义

• Qty 是定点小数：Qty::int(2) 为 2，Qty::milli(250) 为 0.25，最小步长 0.001。
• 周期编号 0..horizon-1；on_hand 是第 0 期期初库存；到货只在所属期可用。
• 每期 available = 上期结存 + 到货，net = max(0, 毛需求 + safety(t) - available)；订单先按良率放大，再按批量政策取整，合格入库 received = floor(订单 * 良率 / 1000)。
• SafetyStock：Fixed(q)、DaysOfDemand(n)（全周期平均需求 × n）、PercentOfDemand(p)（当期满需求 × p%）。
• LotRule：LotForLot、FixedQuantity、Multiple、MinimumMultiple、PeriodOrder(n)、MinMax(min, max)、ReorderPoint(level, quantity)。
• 子件需求只由父项计划订单产生，并按 units_per * (1 + 损耗) 与换算因子折算，每个乘法向上取整到 0.001。
• phantom 物品不持有库存、不生成订单，其毛需求在同一周期直接展开给子件。
• 下达早于第 0 期：Strict 返回 BeforeHorizon；AllowLate 钳到第 0 期并记录 incident。
• Peg 记录独立需求或父项订单的贡献，合计等于对应周期的毛需求；超过 max_stock 的期进入 exceptions。
• 输出按 SKU/周期/来源确定性排序，输入行顺序不影响结果，不修改调用方数组。

#输入与数值边界

#实现与验证

#版本与升级

• Item.safety_stock: Qty → Item.safety: SafetyStock，新增 Item.max_stock、Item.phantom。
• 新增 LotRule::ReorderPoint(level, quantity)。
• Plan 新增 exceptions: Array[StockException]；JSON 升为 moon-mrp.plan.v3。

#许可证与来源