foxxcyber/docsConsumable stores
Track bulk consumables — coal, oil, diesel, water, sand — buy them in, and draw them down when you fuel a locomotive.
Stores holds bulk consumables rather than countable parts: coal, oil, diesel, gas, water, sand, lubricants, and anything else measured by weight or volume. Purchases add to a stock; fuelling a locomotive draws it down. It sits under Operations in the sidebar.
The list
Each stock shows its Stock name, Kind, Unit, On hand, Reorder pt, On order, Unit cost, Value, and a Status badge — reorder at or below its reorder point, on order when open requisitions will cover it, ok otherwise.
Two figures sit in the page header:
- On-hand value — the quantity on hand multiplied by unit cost, summed across every stock.
- Fleet running cost — the total of every fuel and water fill ever logged, which is a different question from what is currently in the bunker.
When stocks are low, a banner counts them and offers Create requisition for N low items, the same as on Parts. See Requisitions & vendors.
Adding a stock
Click + Add Stock and fill in the Name, the Kind (coal,
oil, diesel, gas, water, sand, lube, or other), the
Unit you buy and issue it in, the opening On hand quantity, the
Unit cost ($), a Reorder point, and any Notes. Click Create
stock.
Set up every fuel and water supply you run on. Fills on an excursion are always drawn from a store, and the store is what gives the fill its unit and price.
Buying stock in
The best way in is a requisition: request it, get it approved, and receive it against the requisition when it arrives, so the purchase has an approval and an order behind it. Request more on the stock's page starts one.
For a purchase made outside a requisition, use the Record purchase panel on the stock's page: Quantity in the stock's unit, Unit cost ($) and Vendor (both optional), and the Date. Click Record purchase. The purchase is recorded and on-hand increased in the same step, and the stock's unit cost is updated to the price you just paid.
If an administrator has switched on Stock comes in only through requisitions, the Record purchase panel is replaced by the stock's open requisitions and a Request more button. See Settings & permissions.
The stock's page also lists Purchases and Fueling draws — the fills that have been taken out of this stock, with the locomotive each went to — and any open requisitions for it.
The link to fuelling
When you log a fuel or water fill against a locomotive or a run, you name the stock it came from. The fill takes its kind, unit, and price from the stock and reduces the stock by the quantity taken, so the same coal is not priced two different ways in two different places. The price follows the stock's latest purchase.
A fill is refused, with a note saying why, when the stock does not have enough on hand or holds something other than fuel or water. Record the purchase first.
Name the stock when the material genuinely came out of your own supply. On a locomotive, log the fill as not from a store when it did not — a diesel top-up bought at a pump on the road, or water taken on at a foreign railroad — and enter the price you actually paid. Both kinds of fill count toward the locomotive's running cost; only the first moves your inventory.
Correcting the count
After a stocktake, an administrator can use Correct the count on the stock's page to set on-hand to what was counted, with a reason. The change and the reason are kept on the record. A correction is not a purchase and never counts as spending.
Stores and Parts behave differently on purpose. Parts leave inventory through a work order, so each unit is tied to a job. Stores leave inventory through fuelling, so each unit is tied to a locomotive and a running day.