# Editable brewing conversions after usage

This is a separate storyboard for the pending changes that allow conversion settings to change after recorded use. It preserves the earlier feature report at its original local folder and public URL.

Open `index.html`. Its 17 screenshots are embedded; filters, enlargement and keyboard navigation work without a web server. The report is an uncommitted local preview, not a deployed release announcement.

## What changes

A product setting can change after use. Completed additions keep the conversion used when they were recorded. Notices explain recorded/current differences without changing historical warehouse depletion, quantities or costs. Future execution uses the current rate. The default-unit toggle retains conversions and existing saved units.

The main example records 500 mL at 0.8 L/kg as 0.625 kg. Changing the product to 1 L/kg moves no stock; a later 500 mL use consumes 0.5 kg. An amendment to 0.5 kg recalculates the earlier dose to 400 mL using its recorded 0.8 L/kg. To change stock without changing the dose, record a separate warehouse adjustment.

The browser shows the material form, affected references, historical brewhouse records, Linked Records, warehouse event, MRP, amendment dialog, new execution, preserved recipe units, cellar addition, brink feed and consumed purchased yeast. Preparation and purchased-yeast knockout use application services; the other principal mutations are submitted through browser forms.

## Verification

- Browser: 4 scenarios, 113 assertions; all passed.
- Focused regression: 269 tests, 1,675 assertions; all passed.
- JavaScript was rebuilt before capture.
- Fixtures use the isolated agent test database. Development and production customer records are not edited.

Exact commands and output are in `verification.json` and `logs/`. The existing migrated test schema is supplied through `/tmp/brewing_snapshot_structure.sql`; it is not a repository schema-dump change.

## Reproduce

```sh
mise exec ruby@3.2.8 -- yarn build
mise exec ruby@3.2.8 -- env BK_TEST_DATABASE=agent PARALLEL_WORKERS=1 SCHEMA=/tmp/brewing_snapshot_structure.sql BK_CONVERSION_STORYBOARD_OUTPUT=/Users/paul/src/kbc/brewkeeper/docs/reports/brewing-conversion-edits-2026-11-09 bin/rails test test/system/production/brewing_conversion_edits_storyboard_test.rb
python3 docs/reports/brewing-conversion-edits-2026-11-09/build.py
mise exec ruby@3.2.8 -- bundle exec ruby docs/reports/brewing-conversion-edits-2026-11-09/verify_gallery.rb
```

## Publication

New S3 prefix: `reports/brewkeeper/brewing-conversion-edits-2026-11-09/` in `brewkeeper-files`, region `us-west-2`. Upload with `bin/bk-files`, including `public=true` tags and `Cache-Control: no-cache` for every object. Supporting evidence and original captures accompany the HTML.

Previous report, preserved: https://brewkeeper-files.s3.us-west-2.amazonaws.com/reports/brewkeeper/brewing-units-2026-11-08/index.html
