企业官网建设流程全解析

Craftplan是一款开源、可自托管的轻量 ERP，专为手工烘焙、精酿、手工食品等 D2C 微型制造企业设计。它的需求预测（Demand Forecasting）与补货规划（Reorder Planning）模块，会根据未来订单和 BOM 配方自动推算每种原料"哪天用完、最晚何时下单、该买多少"，帮助你在缺货发生之前就创建采购单，而不是等到生产线停下来才发现面粉不够了。

本指南面向新手，带你快速看懂Usage Forecast（用量预测）与Reorder Planner（补货规划器）两大界面，并理解背后的安全库存、再订货点（ROP）等计算逻辑。

一、为什么手工小微商家也需要需求预测

很多手工坊的库存管理停留在"眼见库存"：

• 接到订单后翻 Excel 算原料用量，算错就缺料；
• 凭经验补货，旺季不够、淡季积压过期；
• 供应商到货周期不固定，"感觉快用完了才下单"往往太晚。

Craftplan 的预测逻辑把这三件事自动化：

1. 基于订单：读取未来已确认订单的交付日期和数量；
2. 基于配方：通过产品的 BOM（物料清单）展开出每种原料的单位用量；
3. 基于历史：结合过去一段时间的实际消耗，推算每日平均用量与波动，算出安全库存和建议采购量。

核心实现在 inventory_forecasting.ex，指标计算在 forecast_metrics.ex。

二、Usage Forecast：一眼看出哪天会断货

进入Manage → Inventory → Usage Forecast，你会看到一张"原料 × 日期"的需求矩阵：

• 每行是一种原料，每列是一天的预计结存余额（当前库存逐日扣除需求后的结果）；
• 右上角可切换预测范围：Today/Next 7 days等时间窗口；
• 红色数字表示预计库存为负——也就是说按现有订单，这一天开始会断货；
• 最右侧Final balance显示预测期末余额，绿色代表余量健康。

这个视图由 reorder.ex 所在的 Inventory 模块族与 forecast_row.ex 中的projected_balances（逐日余额投影）共同支撑。它回答的第一个关键问题很直接："哪种原料、哪一天会先用完？"

💡 实用技巧：把时间窗口拉长到 14 或 28 天，可以提前发现"下下个月才断"的慢性缺货，给采购留出提前量。

三、Reorder Planner：安全库存、再订货点与建议采购量

Manage → Inventory → Reorder Planner把预测结果转化为一套可以直接执行的采购建议：

界面顶部是计划控制区（Planning controls）：

展开Advanced settings还可以微调：回看天数（Lookback days，默认 42 天）、实际/计划用量权重（默认 0.6 / 0.4）、最小样本数（默认 10）。

下方指标表中，每个原料一行，关键列包括：

• On hand / On order：现有库存与在途采购量；
• Avg/day：混合日均用量 = 历史实际 × 实际权重 + 未来计划 × 计划权重（见 forecast_metrics.ex 的avg_daily_use/3）；
• Safety stock：安全库存 = 服务水平系数 z × 需求波动 × √提前期（safety_stock/3）；
• ROP（再订货点）：提前期需求 + 安全库存，库存低于它就应下单（reorder_point/2）；
• Cover：现有库存还能支撑多少天；
• Stockout / Order-by：预计断货日期，以及"最晚下单日"（断货日减去供应商提前期，order_by_date/2）；
• Suggested PO：建议采购量 = ROP −（现有 + 在途），并按包装规格取整。

三色风险标签：Balanced / Watch / Shortage

• 🟢Balanced：整个预测窗口内库存健康；
• 🟡Watch：窗口内库存会降到零——该开始规划补货了；
• 🔴Shortage：预计库存转负——直接点行末的Draft PO按钮，一键生成采购单草稿。

这个"预测 → 风险分级 → 一键开单"的闭环，就是"让缺货发生在它之前"的核心：你总是先看到红色预警，再在 Order-by 日期之前完成采购，而不是事后救火。

四、三步完成一次补货规划

1. 设定参数：在Manage → Settings中配置供应商默认提前期（lead time）与预测默认值（回看天数、服务水平、窗口等，见 form_component.ex）；在 Reorder Planner 页面按当前经营节奏切换 Service level 与 Horizon；
2. 看风险：优先处理红色 Shortage 行，其次黄色 Watch 行；确认 Stockout 与 Order-by 日期是否落在可执行范围内；
3. 开采购单：点击Draft PO生成采购单草稿，随后在Manage → Purchasing中确认数量与供应商并发送，收货时再登记批次与供应商批次号，形成完整追溯链。

完整的原料、批次与预测说明可参考官方文档：docs/src/pages/docs/inventory.md。

五、给新手的落地建议

• 先让数据跑起来：预测依赖订单与 BOM 数据完整。产品配方维护在Manage → Products的 Recipe 标签页，原料用量准确，预测才有意义；
• 服务水平从 95% 起步：小批量商家对少数关键原料（面粉、酵母）用 97.5%，周转快的配料用 90%，避免全线上调导致库存积压；
• 短历史期别调高权重：数据不足 10 个样本时系统会自动保守估计波动（demand_variability/3），经营时间越长预测越稳；
• 每周固定过一遍红色清单：把 Reorder Planner 当"采购晨检表"，10 分钟即可扫完所有风险行。

小结

Craftplan 的需求预测与补货规划把"要不要进货、何时进、进多少"从经验判断变成了透明可审计的计算：订单驱动需求、BOM 驱动用量、历史与计划加权驱动日均消耗，最终落到安全库存、ROP、断货日、最晚下单日和一键采购草稿。对追求"零停线"的手工小微商家来说，这是把缺货消灭在预测阶段的完整闭环。🛒