Components
Components are the parts your formulas and BOMs reference — the ingredients that go into the liquid, the vessel parts that hold it, and the case parts that ship it. The Components page is the single landing for browsing and managing those parts across the catalog.
What’s a Component?
A Component is any non-finished-good item the Spec layers depend on. Components fall into three buckets:
- Ingredients — what a Formula consumes. Grain, hops, water, flavorings, additives, and bulk bases. Stored as raw-material products with a vendor (the supplier) or as house-owned materials.
- Vessel parts — what a Vessel BOM consumes. The bottle or can itself, the lid or cap, the label, the neckband or shrink-sleeve.
- Case parts — what a Case BOM consumes. The box, tray, divider, caddy, shrink wrap, and the master case (outer shipping carton). You can rename any of these to match your floor’s vocabulary in Settings → Case components.
Components are the building blocks the three Spec layers reference. A Formula doesn’t consume “the can” — it consumes a liquid. A Vessel BOM consumes the can plus the lid. A Case BOM consumes the case-level packaging that holds the vessels. The split exists so you can swap one layer (a new can supplier, a new label run) without rebuilding the others.
Components page
The Components page sends you to the right place for each component type. Full in-page browsing for vessel parts and case parts ships in a later release.
The current entry points are:
- Ingredients & raw materials → Inventory · Lots — the lot-level catalog of every raw material. Browse by vendor, by status (available, on hold, quarantine), or by expiry. Receive new lots from the Receiving page.
- Vessel parts — coming soon. Today, vessel parts are stored as raw-material products and authored alongside ingredients. The dedicated browse-by-vessel-type surface is on the roadmap.
- Case parts — coming soon. Today, case parts are also raw-material products. The dedicated browse-by-case-type surface is on the roadmap.
Where Components are used
Each bucket maps cleanly to one Spec layer:
| Component bucket | Used by | What the BOM tracks |
|---|---|---|
| Ingredients | Formula (Spec A) | Quantity per baseline (absolute or % of baseline), loss model, lot consumption |
| Vessel parts | Vessel BOM (Spec B) | Quantity per vessel (1 bottle, 1 cap, 1 label) and the fill volume the vessel holds |
| Case parts | Case BOM (Spec C) | Quantity per case (1 tray, 4 rings) and bottles-per-case |
Editing a Component does not edit the BOMs that reference it. BOMs pin specific component lots at run time (lot genealogy), and component metadata changes propagate forward to the next BOM version — never retroactively to closed batches.
Compliance regime and how you author a Formula
You build a Formula the same way no matter the product’s compliance regime. You set a batch baseline volume, then express each ingredient line as either an absolute amount or a percent of that baseline, and the loss as a percentage. There is no separate “alcohol formula” or “THC formula” mode — the baseline, lines, and loss percentage work identically for TTB, THC, and non-regulated products.
The compliance regime decides which records a batch needs, not how the Formula is built:
- TTB · alcohol products require a Production Record, which carries the proof gallons (volume × ABV).
- THC products require a Certificate of Analysis, which carries the lab-measured potency.
The regime adds a compliance record at the batch level; it does not change the math you enter on the Formula.
Editing a Component
The right place to edit a Component depends on its type:
- Ingredients and raw-material parts — go to Inventory · Lots, find the product, and open its detail page. Vendor, unit of measure, default reorder point, and ownership all live there. Lot-level fields (lot number, supplier lot, expiry, status) live on each individual lot.
- Vessel parts and case parts — for now, edit them via the same raw-material detail page used for ingredients. Component-specific facets (vessel type filter, case-part filter) ship with the dedicated browse surfaces.
Components owned by a vendor use the vendor’s SKU prefix (VENDOR-RM-NNNN); house-owned components use HOUSE-RM-NNNN.
Cross-references
- Products — the SKUs that consume components via their Spec layers.
- Inventory — where component lots live and where receipts land.
- Vendors — vendors who supply most components.
- Company profile — your in-house company record.
- Purchasing — the purchase orders that bring vendor-supplied components into inventory.