This folder documents the product's domain surface, centered on the stock/inventory
accounting system — the perpetual ledger, scope axes, units, item policies,
costing, recipes/production, procurement, sales-consumption, period close,
fixed assets, the financial boundary, and the food-attribute layer (nutrition ·
shelf-life · allergens) — plus the catalog reference-data surface, the selling
surface (menus · storefronts · publications), and the labor domain
(shifts · timesheets · payroll · prime cost).
The double-entry stock-move journal that is the spine of the system — every receipt/sale/transfer/waste/count/production is one location-to-location move; on-hand is derived, never stored; and a close in force separates open facts from settled books.
The four orthogonal attribution axes — Company, Warehouse (the accounting contour where valuation, count and close sit together), Restaurant (P&L grain), Channel — the one family of item a warehouse admits, operating stock or the asset register, chosen when it is opened and fixed for its life, why every business therefore opens with two contours, why valuation strategy is chosen by how many warehouses a business creates rather than by a setting, the storage locations inside a warehouse whose quantities are counted one location at a time while value stays on the warehouse, and the restaurant consumption warehouse selection and commissary supply by explicit transfer.
The single measure-conversion model gated by physical dimension, with company-shared standards, per-item measures, the supplier-free bundle unit you buy in (a per-item unit with a barcode), and convert-to-base at the posting edge (no cross-dimension density conversion).
How an item's behavior (counted/valued, acquisition, recipe-capable, cost bucketing) routes off stable enumerated policy fields — never off category name, id, or "kind."
Weighted-average cost as one price per pool per accounting period, struck at the close, with a provisional figure inside the open period; deterministic recipe-cost points and build-specific matrix cost; the landed-cost waterfall; region tax (US sales-tax vs EU recoverable VAT); owed-vs-worth on every receipt; and value news that arrives about a period already closed.
The financial boundary — what the stock domain hands to the books: the fixed set of conceptual accounts (inventory value, food/packaging COGS, shrinkage, price-difference, input-VAT receivable, expense-on-receipt, depreciation, gain/loss on disposal) exported to the operator's accounting package.
The F&B layer above the generic engine — immutable-by-reference recipe versioning (with backdated scheduling), the recipe matrix and the concrete build a choice resolves, bill-of-materials explosion of that build to raw materials, prep-item production posted at the inputs the shift states it took, with emergent (not typed-in) yield, and repair of open-period journals after a recipe correction.
Nutrition, allergens, and shelf-life as food attributes that roll up the recipe tree, using a matrix recipe's base build as the stable product statement; the two-stage shelf-life advisor, leaf profiles sourced by barcode/label/public food database, and expiry and ordinary waste write-offs.
The arithmetic of cooked nutrition — one formula (nutrients entered ÷ weighed output), why un-listed water dilutes for free, why evaporation concentrates without taking nutrients, the consumed-mass cases where nutrients do leave (drained brine, absorbed oil, pasta-water salt), worked batch end to end.
The pre-ledger intent domain — the purchase order, suppliers and the supplier products that price an item in a chosen unit, per-(item × warehouse) min/max par levels, the goods receipt that puts goods into stock with a quantity and a cost (read off any supplier paper, or with no supplier at all), the order ↔ receipt match, and the stock-aware procurement plan.
How an externally-produced sale becomes a stock fact — the one-way sales boundary, the sales ticket, direct-stock and made-to-order behaviors, concrete and base recipe builds, station-based consumption routing, the €0 comp, internal consumption and its per-company categories, correction, and unmapped-name hold.
The selling surface over the ledger spine — channels as company vocabulary, storefronts as named selling points, menus frozen into immutable moment-timed publications, modifier choices that refer to catalog items without owning recipe quantities, the standard configuration and its food cost, placements and stops, and ticket→storefront attribution that never gates the ledger.
Period close — stock counts as observations, warehouse initial balances on one shared opening date, the full counts the accountant chooses, operational balances between closes, accepted differences, the period price that carries shrinkage into COGS, the self-check, controlled reopening with preserved history, and the restaurant P&L roll-up.
Fixed-asset (PP&E) accounting in a separate slim sub-ledger via the capitalize-and-depreciate treatment for durable assets — an asset register of what the company owns, fed by ordinary goods receipts, the placement that answers whose books carry each unit and where it stands from the day it is registered, straight-line depreciation, disposal, the dated transfer that moves a unit between warehouses, the register's own count where the serial roster is the whole form, and missing read cross-form off the walks a close trusts — never stored, and settled (found or disposed) before a period seals — and why a fixed asset is not inventory.
Worked time as cost — shifts, weekly timesheet approval, effective-dated pay, the gross-only payroll run, prime cost (food + labor) as the headline figure, and the single absorption seam where a production day's direct labor enters the value of the prep items it made (and why indirect labor never spreads to dishes).
The non-negotiable rules of the stock/inventory domain in one quick-reference contract — each with a one-line WHY and a worked example; if a change violates one, the change is wrong.