BrewKeeper workflow storyboard · 20 screens

Supplier-owned raw material locations

A walkthrough of ownership settings, stock totals, lot costs, transfers, returns and reclassification using dedicated local demo stock.

Captured 11 November 2026 · Local development · Saved results and pending forms labelled separately
OverviewArrow keys step through screens · Click an image to enlarge OverviewChecks
How it works

Ownership follows the location

Tick Supplier-owned stock on a raw-material location. Its current stock stays in physical inventory and lot history, while the raw-material ledger and panel exclude it from owned quantities, owned value and average unit cost. A supplier-owned location can be at the brewery or external.

Use separate logical locations

Each location has one ownership setting for every raw material held there. Keep mixed ownership in separate locations, even within one room.

Transfer or reclassify

Moving stock into an ordinary location includes it in owned totals. Moving it back excludes it. Saving a changed checkbox reclassifies all stock already there.

Physical records remain

Lots, receipts and movement history still include supplier stock. The On Premises and Off Premises history tabs describe physical location.

Current classification only

This setting does not record historical financial ownership, identify the owning supplier, create a payable, settle consignment or restrict production eligibility.

Follow the demo quantities

Costed malt stays at 285 kg physically throughout. Values below exclude tax. The separately demonstrated unpriced lot stays at 10 kg.

StageOwned on siteOwned externalSupplier-ownedOwned value
Baseline25 kg10 kg250 kg¥3,500
Take 50 kg into ownership75 kg10 kg200 kg¥13,500
Return 20 kg55 kg10 kg220 kg¥9,500
Untick external supplier location55 kg160 kg70 kg¥39,500
Final, external checkbox restored55 kg10 kg220 kg¥9,500
01 / 20 · Settings

Set up separate logical locations

Settings · Saved configuration

Open Production → Settings → Brewery → Locations. The demo has ordinary and supplier-owned locations both under brewery and under External. The badge identifies the ownership setting. Facility grouping describes where the material sits; the checkbox describes who owns it.

Open local screen ↗Captured 16:25:17 Perth · screenshot is historical evidence
02 / 20 · Settings

The ownership checkbox applies to the whole location

Settings · Saved setting shown in edit form

Edit a raw-material location and tick Supplier-owned stock. Every raw material held here is excluded from owned quantities and owned value. Use separate logical locations when brewery-owned and supplier-owned material share the same physical room. New locations default to unticked.

Open local screen ↗Captured 16:25:39 Perth · screenshot is historical evidence
03 / 20 · Balances

Read owned quantities and supplier stock separately

Balances · Saved baseline

Consignment malt starts with 25 kg owned on premises and 10 kg owned off premises. Another 250 kg belongs to the supplier: 100 kg at the brewery and 150 kg externally. Owned value is ¥3,500, calculated from only the 35 kg owned at ¥100/kg. The unpriced material has 10 kg supplier-owned, with no missing-cost warning.

Open local screen ↗Captured 16:26:06 Perth · screenshot is historical evidence
04 / 20 · Balances

Owned value help explains the exclusion

Balances · Live tooltip over saved baseline

Hover or focus the question-mark beside Total owned value. The help explains that supplier-owned quantities are excluded and that the current value excludes tax. The brewery setting determines whether lot contribution costs include tax.

Open local screen ↗Captured 16:26:06 Perth · screenshot is historical evidence
05 / 20 · Balances

The material panel repeats the same totals

Balances · Saved baseline

Click the material row. The panel shows owned stock split by premises, supplier-owned stock across both supplier locations, and ¥3,500 owned value. The average is ¥100/kg for the owned costed stock. Physical supplier stock is still available in the Lots and movement tabs.

Open local screen ↗Captured 16:26:30 Perth · screenshot is historical evidence
06 / 20 · Lots and history

Supplier lots remain visible with recorded costs

Lots and history · Saved baseline with demo costs

Open Lots. The supplier external lot still shows its 150 kg, physical location and ¥200/kg excluding-tax cost. Its ¥220/kg including-tax cost also remains recorded. That supplier stock does not contribute to the ¥3,500 owned value. The fixtures use manually supplied lot costs and have no supplier purchase order.

Open local screen ↗Captured 16:28:06 Perth · screenshot is historical evidence
07 / 20 · Lots and history

On Premises describes physical holdings

Lots and history · Saved baseline

The On Premises tab includes both 25 kg in the brewery-owned malt room and 100 kg in the supplier location at the brewery. These cards and the stock-added timeline describe physical inventory, so they include supplier-owned material. The header’s On premises figure remains the owned 25 kg.

Open local screen ↗Captured 16:27:15 Perth · screenshot is historical evidence
08 / 20 · Lots and history

External supplier stock is also traceable

Lots and history · Saved baseline

The Off Premises tab includes the owned external 10 kg and supplier external 150 kg. Physical balances and receipt history remain visible even though the supplier quantity is excluded from owned quantities and value.

Open local screen ↗Captured 16:27:31 Perth · screenshot is historical evidence
09 / 20 · Transfer

Take ownership through a location transfer

Transfer · Unsaved form before recording

In Transfers, choose Record transfer, supplier stock at brewery as From, and the brewery-owned malt room as To. Enter 50 kg of the costed lot and 2 kg of the unpriced lot. Both logical locations belong to the same facility. This form records a movement already made; Plan for a date uses the separate receiving workflow.

Open local screen ↗Captured 16:28:56 Perth · screenshot is historical evidence
10 / 20 · Transfer

The saved transfer has a receipt

Transfer · Saved TO-3 and finalised D-2

The transfer detail shows 50 kg and 2 kg moved, zero remaining and receipt D-2. No fees apply to these demo locations, so the receipt is finalised automatically. This is the normal transfer audit trail; the ownership setting does not introduce a supplier settlement step.

Open local screen ↗Captured 16:29:39 Perth · screenshot is historical evidence
11 / 20 · Transfer

Owned quantity and value rise immediately

Transfer · Saved transfer result

Consignment malt now has 75 kg owned on premises, 10 kg owned externally and 200 kg supplier-owned. Owned value is ¥13,500: the original ¥3,500 plus 50 kg × ¥200. Physical total stays 285 kg. The unpriced material now has 2 kg owned, 8 kg supplier-owned and a missing-pricing warning.

Open local screen ↗Captured 16:30:07 Perth · screenshot is historical evidence
12 / 20 · Transfer

Only the owned unpriced portion needs costing

Transfer · Saved transfer result

Open the warning. The same 10 kg unpriced lot is split between 2 kg owned and 8 kg supplier-owned. The header says Not valued and 2 kg not yet costed. The supplier-owned 8 kg does not add to the costing warning. Unknown costs are not treated as zero-valued owned stock.

Open local screen ↗Captured 16:30:20 Perth · screenshot is historical evidence
13 / 20 · Transfer

A partial transfer preserves the original lot

Transfer · Saved split lot

The original 100 kg supplier lot is now held 50 kg in each logical location. It keeps its ¥200/kg excluding-tax cost and ¥220/kg including-tax cost. Only its owned 50 kg contributes to owned value. The material’s owned average becomes about ¥159/kg because the owned stock includes lots at ¥100 and ¥200/kg.

Open local screen ↗Captured 16:30:32 Perth · screenshot is historical evidence
14 / 20 · Transfer

The movement appears in physical history

Transfer · Saved audit trail

On Premises shows the recorded 50 kg movement between the supplier and brewery-owned locations, with user and time. It also retains the original additions. Both locations remain physically on site, while the ownership summary changes with the destination location.

Open local screen ↗Captured 16:30:45 Perth · screenshot is historical evidence
15 / 20 · Return

Move stock back to the supplier location

Return · Unsaved form before recording

Reverse From and To. Return 20 kg from the previously moved 50 kg lot and all 2 kg of the unpriced lot. There are two costed lots with the same displayed receipt date. This demo selects the 50 kg lot that came from the supplier, leaving the original 25 kg owned lot untouched.

Open local screen ↗Captured 16:31:15 Perth · screenshot is historical evidence
16 / 20 · Return

The return is another recorded transfer

Return · Saved TO-4 and finalised D-3

The return has its own transfer TO-4 and receipt D-3. It records 20 kg costed stock and 2 kg unpriced stock moving back into the supplier-owned location. No supplier invoice, payable or settlement is created by the ownership checkbox.

Open local screen ↗Captured 16:31:45 Perth · screenshot is historical evidence
17 / 20 · Return

Returned stock leaves owned value again

Return · Saved return result

Consignment malt now has 55 kg owned on premises, 10 kg owned externally and 220 kg supplier-owned. Owned value falls to ¥9,500 after excluding the returned 20 kg × ¥200. All 10 kg of the unpriced lot is supplier-owned again, so its owned missing-cost warning disappears.

Open local screen ↗Captured 16:31:46 Perth · screenshot is historical evidence
18 / 20 · Reclassification

Changing the checkbox affects existing stock

Reclassification · Unsaved form, checkbox unticked

Edit only Demo - Supplier external store and untick Supplier-owned stock. This location already holds 150 kg. Saving this form will reclassify that entire current balance as brewery-owned without moving it. The screenshot shows the pending edit before Save.

Open local screen ↗Captured 16:32:13 Perth · screenshot is historical evidence
19 / 20 · Reclassification

Saving reclassifies the entire 150 kg

Reclassification · Saved temporary setting

After Save, owned external quantity rises from 10 kg to 160 kg, supplier-owned falls from 220 kg to 70 kg, and owned value rises from ¥9,500 to ¥39,500. The extra ¥30,000 is 150 kg × ¥200. Physical total remains 285 kg. No transfer was needed for this setting change.

Open local screen ↗Captured 16:32:15 Perth · screenshot is historical evidence
20 / 20 · Reclassification

The demo is left ready to revisit

Reclassification · Saved final state

The external location has been ticked supplier-owned again. Totals return to 55 kg owned on premises, 10 kg owned externally, 220 kg supplier-owned and ¥9,500 owned value. The unpriced lot remains entirely supplier-owned with no missing-cost warning. The demo records and two transfer histories remain in local development.

Open local screen ↗Captured 16:32:51 Perth · screenshot is historical evidence
Evidence and limits

Verified locally

20 real browser captures, 11 November 2026. BrewKeeper 7.5.0, commit eaf6c178b with existing user edits, Rails development, local barcodes_development, schema public, facility 1. UI timestamps use the brewery’s Tokyo setting. Capture metadata uses Perth time. This report documents the local checkout, not a production deployment.

Verified saved TO-3 / D-2 and TO-4 / D-3, ledger and panel agreement, constant physical quantities, unchanged ¥200/kg cost for lot 142, warning appearance for 2 kg owned unpriced stock and disappearance after return, location-wide reclassification and restoration. Fixture preparation used RawMaterialsService.add_product_inventory; transfers were submitted through the current Transfers UI.

Exact final check, from the BrewKeeper checkout: RAILS_ENV=development mise exec ruby@3.2.8 -- bin/rails runner /tmp/supplier-owned-storyboard-20261111/verify.rb returned. Result: PASS. The same script passed at the taken and reclassified stages. No application code changed, so no test suite or build was needed.

The existing ownership regression tests and decision record were reviewed. Both tax modes, archived-location visibility and production consumption were not exercised in this walkthrough. Supplier columns appear when at least one current raw-material location is supplier-owned, even when empty; archived locations do not enable them. Separate transfer surcharges and invoice costing are outside this demo.

Local records left available

Products 167 and 168. Locations 19–22. Lots 140–144. Transfers 3 and 4, receipts 2 and 3. Both supplier locations remain ticked. No unrelated inventory or configuration was changed. The unused demo login created during preparation was deactivated.

Source reference: docs/decisions/2026-10-18-supplier-owned-raw-material-locations.md. Implementation: LocationsController, Production::RawMaterialsController, Production::RawMaterialPanelSummary, lot panel templates and physical movement timeline. Current transfers use PurchasingService.record_transfer.

This report is published for viewing. Editable sources, scripts and original captures are backed up privately.

Related storyboards

The report is public. Editable sources remain private.