Skip to content

Journal

SirTobyB edited this page Aug 14, 2026 · 2 revisions

Journal

Every change to stock is recorded — who, when, what, how many, where and from which part of the app. The journal is the answer to "we had three of those yesterday".

What a line tells you

Column Content
left date, time and the user who booked
middle the item (clickable while it still exists), the booking type, the location, the best-before date and the source
right the amount, coloured by effect on stock

Booking types

Type Meaning Amount
Addition stock went up green, +3
Removal stock went down amber, −2
Relocation moved between locations grey, — the total is unchanged
Correction batch edited sign depending on the difference

A correction that only changed a best-before date shows BBD instead of +0.

Sources

Where the booking came from: Scanner, Stocktake, Delivery, Item list or Batch (the batch controls on the location and item pages). Without this you could see that two packs left the house, but never how.

One line per batch

A removal spanning several batches produces one line per batch, each with its own location and best-before date. FEFO can reach across locations, and lumping it into a single line would make "which shelf?" unanswerable.

Filters

Item, location, user and booking type, combinable. The filter state lives in the URL, so a filtered view can be bookmarked or sent to someone.

The location filter deliberately offers every location that appears in the journal, including retired ones — otherwise the history of a location you stopped using would become unreachable.

Older entries load 100 at a time.

Deleted items

Journal entries survive the deletion of their item: the name stays readable, greyed out and no longer clickable. The name is a snapshot from the time of booking.

Location names are not snapshotted, deliberately: renaming a location updates the history too, because it is still the same physical place.

Where it starts

The journal begins with the version that introduced it. Bookings made before that were never recorded and cannot be reconstructed.

Clone this wiki locally