store-replenishment

Run the reorder subcommand with a store ID, for example replenish reorder --store STORE-01 --dry-run. The script compares current stock against min/max levels and reorder points, then outputs proposed order quantities rounded to the configured order multiple.

Use the allocate subcommand with a SKU and total quantity, optionally specifying a cluster. The allocation engine distributes stock proportionally to demand rather than equally, so high-volume stores are not penalized when supply is constrained.

It requires a database connection via REPLENISH_DB_URL, a clusters.yaml file defining store clusters with safety stock and lead times, and a minmax.yaml file defining per-SKU minimum, maximum, and reorder point quantities.

Static min/max levels cannot absorb demand spikes from seasonality or promotions, which can raise demand three to five times. Use seasonal adjustment factors or dynamic min/max based on rolling 12-week sales, and raise levels two weeks before promotions.

Avoid it for new stores without historical data; use cluster averages for the first eight weeks instead. It also does not cover warehouse internal operations, which belong to a warehouse-distribution workflow.