Stock Management

A stock is the physical thing you buy and cut: a specific sheet, a piece of hardware, a marble slab. It carries the manufacturing identity of a part - real dimensions, grain, cost and profit margin. A material in Cabybara is only the visual finish. The two are separate on purpose: you can restyle a kitchen without touching its costs or nesting, and reprice or restock without changing how anything looks. If a panel has a stock but no material of its own, it borrows the stock's catalog material for display.

Every panel and hardware piece references a stock by id, and that single assignment drives most of the plugin:

• Nesting groups panels onto sheets per stock, seeds the sheet sizes from the stock's size list, and takes the grain from the stock unless the panel has its own. A panel with no stock is not nested at all.
• Pricing costs each part by its stock's type: sheet goods and veneer per square meter, solid wood per meter, hardware per piece, marble per meter of longest side. Per-stock profit (percent or flat) overrides the global default. Parts with no stock, or a stock without a rate, are flagged as Unassigned/unpriced so a quote never silently under-bills.
• Cabinet generation pre-assigns stocks per part role from the catalog's role defaults, and needs hardware stocks (with a length) to generate legs, hinges, handles and drawer rails at all.
• Labels and reports show the stock name on part labels (the {stock} token) and group the production report by stock.

Stock types

Sheet Good, Solid Wood, Edge Banding, Veneer, Marble, and Hardware (with subtypes Drawer Rail, Door Handle, Hinge, Leg, Other - the subtype decides which hardware pickers offer the entry). Edge banding is cataloged but not yet priced per part.

How panels get their stock

1. At generation - the cabinet dialog pre-fills every part group from the catalog's role defaults; you can override per cabinet in its Materials, Tags and Stocks section.
2. Stock Painter - the hover-paint tool for changing assignments on existing panels, one click or a whole part type at a time. It can also adopt plain (non-Cabybara) components into the system.
3. Components Manager - bulk assignment over filtered selections.

Grain set manually (with the Grain Painter or in the Components Manager) survives any later stock swap; otherwise a panel's grain follows its stock.

Pages

• Stock Catalog - the dialog: entries, fields per type, costs and margins, role defaults, import/export/merge, backups.
• Stock Painter - the painting tool and its picker.

The catalog is stored once per computer (not in the model), seeded with sensible defaults on first use, and backed up automatically on every change. All dimensions are millimeters.