Definirea rețetelor (BOM)

Cui vorbim:* producător / bucătar-șef / responsabil tehnic.

Ce este o rețetă (BOM)

O rețetă (Bill of Materials) descrie din ce este compus un produs finit — care ingrediente, în ce cantități, cu ce cost intern.
Exemplu — Pizza Margherita:

PIZZA MARGHERITA — 1 buc. (320g produs finit)
    250g blat (semipreparat propriu)        cost: 4.20 MDL
    80g  sos roșii                          cost: 1.50 MDL
    100g mozzarella                          cost: 12.00 MDL
    5g   busuioc proaspăt                    cost: 0.80 MDL
    10ml ulei de măsline                     cost: 1.10 MDL
    ──────────────────────────────────────
    Cost productiv:                         19.60 MDL
    Preț vânzare:                           85.00 MDL
    Marjă brută:                            65.40 MDL (77%)

Rețetele se definesc o singură dată și sunt folosite în:

HoReCa — la fiecare bon de producție (BOM auto-explodat).
Producție în loturi — pentru calculul ingredientelor totale.
Calcul preț de cost — automat actualizat când se modifică cost ingrediente.
Marja per produs — în rapoarte.

Cum se definește o rețetă

Pas 1 — Creezi produsul finit

În catalog, adaugi produsul "Pizza Margherita" (denumire, categorie, cod barcode dacă e cazul, fotografie pentru meniu).

Pas 2 — Adaugi rețeta

În tabul Rețetă al produsului, adaugi pe rând ingredientele:

Cauți ingredientul în catalog (trebuie să fie creat înainte ca produs).
Specifici cantitatea + unitatea (g / kg / ml / l / buc.).
Specifici cantitatea pentru 1 unitate de produs finit.

Sistemul calculează automat:

Costul total productiv (sum cost × cantitate per ingredient, la costul curent al ingredientului).
Marja vs. prețul de vânzare configurat.

Pas 3 — Definești sub-rețete (opțional)

Un ingredient poate fi el însuși un semipreparat — adică ceva ce produci tu intern, nu cumperi.
Exemplu:

SOS ROȘII (semipreparat) — 1kg
    1kg roșii pelati
    50g ulei
    20g usturoi
    10g busuioc uscat
    5g sare

Când Pizza Margherita are nevoie de 80g sos roșii, sistemul:

Verifică stocul "sos roșii" → dacă există, decrementează 80g.
Dacă stocul "sos roșii" e 0 → opțional: explodează automat sub-rețeta (decrementează ingredientele primare proporțional).

Configurabil per produs: explodare automată (recomandat pentru semipreparate cu shelf-life scurt) sau "se cere producție explicită" (recomandat pentru sosuri cu volum mare făcute o dată/zi).

Variante de rețetă

Pentru produse cu variante (ex. Pizza cu / fără ceapă, sandwich cu pui / vegetal):

Rețetă de bază + modificatori (adaugă X g, scade Y g).
Sistemul aplică modificatorul la momentul comenzii.

Exemplu:

PIZZA MARGHERITA — base
    [...]

Modificatori posibili la comandă:
    + Mozzarella extra (50g)        +6.00 MDL cost, +12 MDL preț
    + Pepperoni (40g)                +5.50 MDL cost, +10 MDL preț
    - Fără ceapă                     0 cost, 0 preț (informativ)

Reactualizare automată a costurilor

Când prețul unui ingredient se schimbă (ex. făina urcă de la 8 MDL/kg la 10 MDL/kg), sistemul:

Recalculează automat costul tuturor produselor care folosesc făină.
Marchează produsele cu modificare semnificativă (>5%) cu o etichetă "marja a scăzut" în dashboard.
Manager / proprietar primește alertă dacă marja unui produs scade sub un prag definit (ex. <40%).

Versionarea rețetelor

Rețetele sunt versionate — orice modificare păstrează istoricul:

"Pizza Margherita V1 (1 ian - 15 mar): 100g mozzarella"
"Pizza Margherita V2 (16 mar - prezent): 120g mozzarella"

Beneficii:

Calculele de marjă pe perioade vechi folosesc rețeta din acea perioadă (corect contabil).
Poți reveni la o versiune anterioară rapid.
Audit-ready (auditorul vede exact ce s-a vândut sub ce rețetă).

Import rețete bulk din Excel — ⚙️ la cerere

Pentru clienții cu zeci de rețete deja documentate, putem prelua importul bulk dintr-un fișier Excel ca serviciu separat, ofertat individual după evaluarea fișierului tău. Structura tipică așteptată:

Produs finit | Ingredient | Cantitate | Unitate | Notă
Pizza Margherita | Făina 550 | 250 | g |
Pizza Margherita | Mozzarella | 100 | g |
[...]

De ce ofertat individual: costul real al unui import bulk de rețete este curățarea datelor sursă (denumiri ingrediente neuniforme, UM-uri inconsistente, cantități fără unitate, duplicate, dependențe între rețete) — nu putem promite un preț fix înainte să vedem fișierul tău. După evaluare, dacă acceptăm cazul, primești apoi un video custom de validare (5-10 min) în care îți arătăm rețetele importate, ca să confirmi că totul e ok înainte de go-live.

Setup-ul standard inclus în pachetele cu producție acoperă adăugarea asistată a rețetelor (te ghidăm manual sau direct cu producătorul tău, fără import bulk).

Roluri & permisiuni rețete

manager_productie — poate crea / modifica rețete.
bucatar / producator — poate vedea rețetele, dar nu modifica.
auditor — read-only complet pe versionare.

Rețete sezoniere / promoționale — ⚙️ la cerere

Marcarea unei rețete cu interval de validitate (activă doar între date specifice) și recalculul automat costurilor la reactivare nu sunt accesibile în mod implicit la moment. Sunt ⚙️ dezvoltabile la cerere.

Tur vizual — Recipe Editor + BOM Cycle

Editorul de rețete + generatorul de ciclu BOM sunt integrate în tab-ul Settings al HoReCa Dashboard. Aceleași API-uri sunt expuse programatic prin applications/horeca/api.js (recipeUpdate, bomCycleGenerate) pentru integrări externe.
Settings tab — overview complet

Product Recipe Editor

Câmpul "Pick product" acceptă căutare după nume / MPN / SKU. Introducerea "1000" (Latte) declanșează suggestion cu preview thumbnail; click pe suggestion încarcă rețeta existentă (sau formularul gol pentru creare).

Structura rețetei încărcate:*

TYPE — production (rețetă care produce output) sau consumption (rețetă care consumă fără să genereze produs finit).
QUANTITY PER CYCLE — câte unități de produs se generează per rulare a rețetei (default 1).
AUTO (checkbox) — când e bifat, o vânzare la stoc insuficient declanșează automat un ciclu BOM (cascaded via productionAutoCycleParts API).
RECURSIVE (checkbox) — auto-cycle cascadează prin parts care au propriile recipe.auto (util pentru semi-preparate în lanț).
PARTS (consumed per cycle) — tabelă cu MPN + nume + qty/cycle + comentariu; buton "+ Add part" pentru extensie.

Recipe editor cu Latte încărcat

Generate standalone BOM cycle

Pentru cicluri de producție care NU sunt legate de o Comandă (ex: prep batch pentru service, restock la depozit). Câmpuri:

OUTPUT PRODUCT — produsul finit generat (același search-picker).
CYCLES — număr de cicluri (ex: 3 cicluri Latte = 3× parts consumate).
SOURCE POS — de unde se scade stocul (parts consumate).
TARGET STAGE — wip (no apply) (creează folder-ul dar nu aplică stock delta) sau ready (apply immediately) (delta aplicat instant).
APPLY STOCK DELTAS NOW (checkbox) — shortcut echivalent cu Target Stage = ready.
Buton Generate cycle — creează folder:invoice de tip BOM cycle.

Cycle-ul rezultat apare în arhiva de facturi (archive/__groups/Invoices/__groups/YYYY.invoices/__groups/MM/__groups/bom-cycle-<mpn>-uid-...) cu identificator B-<idno>-<timestamp>-NNNNN. Poate fi consultat prin storage-groups → Invoice Search.

Următorul pas

→ BOM explosion la producție sau Bonuri producție vs. consum.