Functional description — critical points

When a run is scheduled (from desktop or mobile), it is recorded but stock is not touched yet. If stock is insufficient at the time of scheduling, MakerStocks flags it but still lets the run join the queue — a forecast alert is generated. A scheduled run can be cancelled with no impact on stock.

An operator (from mobile, Manufacturing tab) or an admin (from desktop) taps "Start". The status switches to EN_COURS. At this point, MakerStocks checks stock availability again. The run is visible in real time on desktop.

On completion, three atomic actions are triggered simultaneously: (1) raw materials are deducted from stock using the FIFO method, lot by lot, with traceability recorded; (2) finished goods stock is credited with the number of units produced; (3) the run's actual COGS is calculated from the unit costs of the lots consumed. These three operations can only be reversed through a later manual adjustment.

If stock for one or more materials is insufficient at the time of execution, MakerStocks flags it in the run's detail (the "Shortages" tab) but still lets the run complete. Stock drops to zero for the affected materials — it never goes negative. An out-of-stock alert is generated.

A run with status PLANIFIE or EN_COURS can be cancelled. Cancellation is final. If the run was EN_COURS and materials had already been physically consumed, stock will not be automatically restored — a manual correction via stock adjustment is required.

Every stock entry (manual, supplier receipt, or import) creates a new timestamped lot with: quantity, unit cost at the time of entry (snapshot), optional lot number, optional expiry date. If the material is configured with "expiry date required," an expiration date is required on every entry.

An adjustment (+ or −) directly modifies the selected lot or the oldest lot (FIFO). The adjustment requires a mandatory reason (physical inventory, loss, breakage, correction…). The movement is logged in the history with type AJUSTEMENT.

From a material's lots view, it's possible to "write off" a specific lot (loss, breakage, quality control) by entering a quantity and a reason. The write-off targets precisely that lot, independent of FIFO order. This operation is irreversible.

Available from desktop only (Business plan). A lot can be transferred from a source warehouse to a destination warehouse. The lot keeps its number, expiry date, and original unit cost. The source warehouse's stock decreases, the destination's increases.

The total stock value of a material is calculated in real time: the sum of (remaining quantity × unit cost) for each active lot. This value is visible in the "Stock value" column of the materials table and used in the financial report.

The admin creates a purchase order by selecting a supplier, adding lines (material, quantity, unit price), and entering an expected delivery date. An order in Draft status can be freely edited and deleted.

By clicking "Mark as sent," the order switches to ENVOYE. It can no longer be edited. It becomes visible in the "Supply orders" tab on mobile, so operators can receive it on delivery. It's marked late if the expected delivery date has passed.

From mobile (or desktop), the operator enters for each line: the quantity actually received, the supplier's lot number (optional), the expiry date (required if the material demands it), and the destination warehouse. The quantity is credited to stock immediately upon confirmation. If not all lines are fully received, the order switches to PARTIELLEMENT_RECU.

An order can be received in multiple deliveries. On each partial receipt, stock is credited with the quantity entered. Receiving progress is shown as a percentage per line. The order switches to RECU only when every line has reached its ordered quantity.

Any alert can be acknowledged manually from desktop (the "Acknowledge" button). An acknowledged alert is archived and disappears from active alerts. It remains visible in the last 30 days' history. An acknowledged alert can reappear if the condition that triggered it is still unresolved (for example, stock is still low).

The mobile interface shows a persistent red banner at the top of every screen when there's at least one unacknowledged low-stock alert. This banner is visible from every tab, not just the dashboard. It disappears as soon as all urgent alerts are resolved or acknowledged.

The Alerts dashboard refreshes automatically every 30 seconds without reloading the page. The mobile dashboard refreshes every 60 seconds. A "Refresh" button allows an immediate manual refresh from desktop.

From the full COGS, MakerStocks can calculate a suggested selling price. This calculation factors in the target margin defined on the recipe. The recommended price is visible on the recipe's record and on the product's record. It is not automatically synced to BigCommerce or Shopify — it's advisory only.

Available from Management → Reports. Exports for the selected period: stock movements, FIFO valuation, detailed COGS per run and per product, cost summary. Structured format, compatible with common accounting software. Full-cost method, FIFO valuation, legal disclosure included.

Generates a complete document: executive summary (revenue, COGS, gross margin), cost breakdown per product, fixed cost structure, break-even point calculation, and a 12-month revenue/margin projection. Requires at minimum one completed run, an hourly rate, and configured fixed costs.

MakerStocks imports the product catalog from your BigCommerce or Shopify store: name, SKU, product ID, variant ID, selling price. This sync can be triggered manually from the Products & stock page. Products created in your store after installation must be synced to appear in MakerStocks.

When a sale is recorded on BigCommerce or Shopify for a product linked to a primary recipe in MakerStocks, raw material deduction is triggered automatically. MakerStocks calculates the number of batches consumed (quantity sold × batches per unit), then deducts materials using FIFO. This mechanism only works if the recipe is marked "primary" on the product.

MakerStocks maintains its own finished goods stock, independent of your BigCommerce or Shopify stock. Store stock is the stock available for sale, visible on the storefront. MS stock is the physical stock in the workshop, coming from production runs. These two stocks are not synced automatically — this is an intentional separation that lets you manage reserves, held-back lots, or delayed listing.

When linking a recipe to a product, the admin enters the "batches per unit sold" ratio. Example: if 1 batch produces 12 candles, and a candle is sold individually, the ratio is 1/12 = 0.0833 batch per unit. This ratio is used to calculate materials consumption on every sale. A misconfigured ratio causes an incorrect deduction.