Stockout risk alerts

Stockout risk alerts are Rinvy's "you're going to run out" warning. Every morning the system projects current stock forward using your burn rate and supplier delivery schedule, and flags anything that won't make it to the next delivery. The alert shows up on the dashboard before service starts — early enough to do something about it.

When it fires

The check runs once a day at 6 AM local time. For every quantity-tracked product, it asks:

  • What's the current stock?
  • What's the daily burn rate? (averaged over the last 30 days from counts, receipts, prep, and waste)
  • When does the next supplier delivery land? (based on the supplier's delivery days and lead time)

If current stock ÷ daily burn rate is fewer days than it takes for the next delivery to arrive, the product is at risk. If the supplier doesn't have a delivery schedule set, the system uses a 7-day horizon.

Severity

Each alert shows days remaining until projected stockout:

  • Red — under 2 days. Urgent.
  • Orange — 2 days or more, but before the next delivery. Address before ordering.

The alert detail modal shows current stock, daily burn rate, days remaining, and the next delivery date so you can see the math.

Where alerts show up

  • Dashboard — under "Needs attention." Each alert is one row, with a tap-through to the detail modal.
  • Push notification — fires to Owners and Managers when new alerts are created. Title: "Stockout risk detected." Body summarizes how many products are at risk.

You won't get a separate alert for every product — the push is one notification per daily run, grouping that morning's new risks.

Dismissing alerts

The detail modal has a Dismiss button. Dismissing acknowledges the alert without taking action — useful when you've already placed the order, or you know the product is about to be deprecated.

A dismissed alert is sticky: it doesn't re-fire even if the next morning's check shows the same risk. But if the product stops being at risk (you received a delivery, burn rate dropped) and then re-enters risk later, a fresh alert is created.

Dismissed alerts are auto-deleted after 30 days, so the historical noise doesn't accumulate.

What doesn't trigger an alert

  • Products with no burn rate — if a product hasn't been consumed in the lookback window, the check skips it. You can't run out of something you're not using.
  • Status-tracked products (OK/Low/Out) — the alert math needs numeric stock, which status products don't have. Their low-stock state is surfaced separately.
  • Recipe-output products — their stock comes from prep, not deliveries. The check rolls them up into their source product's risk instead.
  • Non-inventoried products — skipped by design.

How this relates to the order list

The order list flags stockout risk too, but only when you open it. Stockout alerts run automatically every morning and push-notify, so you don't have to remember to check.

Think of it as: alerts tell you something is wrong; the order list tells you what to order to fix it. The alert is the trigger; the order list is the action.

What the operator should do

When an alert fires:

  1. Open the dashboard and read the affected products.
  2. Tap into the detail modal for context (days remaining, next delivery).
  3. Either:
    • Order more — go to Order list in Burn rate mode and the same product is flagged with a suggested quantity. The default Order to par mode won't surface a stockout-driven need on its own (it only refills below-minimum items) — it shows a "switch to Burn rate" nudge when fast movers are at risk.
    • Reduce usage — if reordering isn't feasible (no time, supplier closed), the kitchen needs to slow down on that ingredient until the next delivery.
    • Dismiss — if you know the risk is resolved (already ordered, product retiring).

Common mistakes

Dismissing alerts without ordering

Dismissing doesn't extend stock. It only silences the alert. If you dismiss without ordering, the next morning's check won't fire again — and you'll learn the hard way mid-service.

Ignoring alerts for items with low burn

A product with a low daily burn rate can still go red if stock is low enough. Don't assume "we barely use this" means "we can't run out of it" — the math doesn't care about absolute volume.

Forgetting supplier delivery days

If the supplier doesn't have delivery days set, the alert defaults to a 7-day horizon — which is conservative. Setting actual delivery days (under suppliers) tightens the projection.

Related