Stock

Stock

The Stock page is the front door: what is in the house, what is about to go off, and how it is spread across your storage locations.

Batches: the unit everything is built on

A batch is n packs of one item, in one location, with one best-before date.

Two jars of the same jam bought on different days are two batches if their dates differ — and that is deliberate. Only per-batch dates make it possible to warn you about the older jar while the newer one is still fine.

Booking the same item into the same location with the same date does not create a second batch; the quantity of the existing one goes up.

Expiring soon

The top section lists every batch whose best-before date is within the next 14 days, oldest first, with a coloured badge:

Badge	Meaning
red	already expired
orange	3 days or less
amber	within 14 days
grey	no best-before date recorded

Tap the name or picture to open the item, where you can correct or move the batch.

Best-before dates are optional. Tinned goods and drinks are usually fine without one; leave the field empty and the batch simply never appears in this list.

Storage locations

Below that, every active location with the number of packs it holds. Tap one to see its contents grouped by item, and from there:

• + / − change the quantity of a single batch by one, immediately. Reaching 0 removes the batch.
• Edit changes quantity and best-before date together. Setting the quantity to 0 here also deletes the batch.
• Move transfers a whole batch to another location, keeping its date. If the target already holds the same item with the same date, the two are merged.

Retired locations disappear from this page — see Storage locations.

Booking out and FEFO

Whenever something is booked out without naming a batch — the − button in the item list, a scan, a stocktake correction — Proviant takes the batch that expires first, across all locations (FEFO). Batches without a date go last.

If one removal spans several batches, the Journal records one line per batch, each with its own location. That way "which shelf did this come off?" still has an honest answer.

One deliberate exception: the − button in the delivery check undoes your last booking on that line and so takes the pack off that exact batch, not the one expiring first. You are correcting a mistake you just made, not consuming stock.

Where the numbers come from

The line under the heading counts packs, not grams or litres: 36 packs in stock, 175 items in the catalogue. The pack size on the item (500 g, 0.7 l) is what recipes use to work out whether you have enough.