cantare-catch-weight

name	cantare-catch-weight
description	Cântare și produse vândute la greutate variabilă (catch-weight) — înregistrezi cântarul de la PC-ul cu Print Agent, marchezi produse „la kg", citești greutatea live, cântărești la picking B2B; model nesuportat → ticket. La „conectează cântarul", „X se vinde la kg", „cât arată cântarul", „nu pot emite avizul, cere cântărire".

Cântare & catch-weight (greutate variabilă) — prin conexiune, nu prin click

Userul (proprietar/manager de fabrică sau magazin alimentar) vinde sau valorizează produse la greutatea reală cântărită — carne, brânză, pește, semipreparate de patiserie la kg — nu la bucată fixă. Asta se cheamă catch-weight: produsul e numărat în bucăți, dar prețul și valoarea ies din kg-ul cântărit efectiv. Tu faci configurarea prin tool-urile MCP (date live pe instanța lui), îi arăți rezultatul pe ecran când vrea, și — dacă are un cântar pe care platforma nu-l știe încă — îi deschizi un ticket de integrare la echipa Symbai.

Înainte de orice

1. Citește (la nevoie) knowledge/cantare-catch-weight.md (ce e greutatea variabilă, cum se conectează un cântar, fluxul cântărește→preț→etichetă, când ceri un model nou), knowledge/agent-operare-avansata.md (confirmare prin citire, dovadă) și knowledge/condu-chrome.md (MCP întâi, deep-link, screenshot = livrabil).
2. Context: cântarul fizic se leagă de PC-ul care rulează Print Agent (același calculator care vorbește cu imprimanta/casa). Ai nevoie de acel PC în listă — îl iei cu list_pos_devices. Brandul/locația se deduc dacă există una singură; altfel cere-le cu list_brands / list_locations.
3. Suportat sau nu? Înainte să adaugi un cântar, verifică cu list_scale_models dacă modelul lui e printre driverele suportate. Majoritatea cântarelor de bancă vorbesc protocolul ASCII standard → merg cu driverul „generic-ascii" fără nimic special. Dacă modelul are protocol propriu și nu e suportat → request_scale_integration (vezi mai jos).

Fluxul: ce tool pentru ce cere userul

Userul spune…	Tool MCP
„ce cântare suportați", „e suportat cântarul meu X", „ce am cerut să integrați"	list_scale_models
„ce cântare am configurate", „cât a citit cântarul de la bucătărie", „e online"	list_scale_devices
„adaugă/conectează cântarul de la recepție"	create_scale_device (nume + driver + conexiune serial COM/baud SAU rețea IP/port + deviceId = PC-ul cu Print Agent)
„pune modelul X în catalog" (model suportat, înainte de a adăuga aparatul)	register_scale_model
„produsul X se vinde la kg", „pune greutatea pe bon pentru Y", „activează catch-weight"	set_product_catch_weight (productId, nominalWeight kg/buc estimat, pricePerWeight + pricingMode:"per_weight" dacă prețul e pe kg)
„oprește catch-weight pe produsul Z"	set_product_catch_weight (enable:false)
„cât arată cântarul X", „citește greutatea"	capture_weight (scaleDeviceId)
„cântarul meu Y nu e suportat, cereți integrarea", „vreau să folosesc cântarul Z"	request_scale_integration (vezi secțiunea dedicată)

Citirile (list_*, capture_weight) și request_scale_integration cer grantul readModule aferent. Scrierile cer un modul pe token: create_scale_device / register_scale_model → Setări & Configurare; set_product_catch_weight → Produse & Meniuri (vezi „Permisiune").

Rețete (cele care contează)

• Conectează un cântar de bancă. „Am un cântar la recepția de marfă, e legat pe serial la calculatorul cu Print Agent." → întâi list_pos_devices ca să afli care e PC-ul; apoi create_scale_device(name:"Cântar recepție", scaleDriverType:"generic-ascii", deviceId:…, connectionType:"serial", serialPort:"COM3", baudRate:9600). Dacă e pe rețea: connectionType:"tcp", ipAddress:"192.168.1.50", port:…. Confirmă cu list_scale_devices.
• Marchează un produs ca „la kg". „Ceafa de porc se vinde la kg, 38 lei/kg, o bucată are vreo 1,2 kg." → set_product_catch_weight(productId:…, nominalWeight:1.2, pricePerWeight:38, pricingMode:"per_weight"). Tool-ul confirmă prin re-citire (vezi în mesaj că e acum catch-weight, preț pe kg). nominalWeight ajută la estimări înainte de cântărire; greutatea reală vine de la cântar.
• Greutatea pe etichetă (cod de bare GS1). Catch-weight pune greutatea reală în codul de bare al etichetei de produs (formatul GS1 cu greutate + lot + termen de valabilitate), ca să fie scanabilă la casă/recepție. Designul etichetei se face în „Materiale grafice" (skill-ul materiale-grafice / etichete-productie); aici tu doar marchezi produsul ca la-kg și pui prețul pe kg.
• Citește greutatea. „Cât arată cântarul?" → capture_weight(scaleDeviceId:…). Încearcă citire LIVE prin Print Agent compatibil; dacă agentul este offline/vechi sau cântarul nu răspunde, întoarce ultima stare raportată. Citirile live sunt puse la coadă pe același PC cu Print Agent, deci nu porni tu mai multe citiri paralele pentru același operator; spune-i că sistemul le procesează pe rând.

Catch-weight în comenzile B2B (en-gros) și pe telefon

• Cântarul la picking B2B. La pregătirea comenzilor en-gros (fabrici care vând carne/brânză la kg), produsele cântăribile se cântăresc LA PICKING: în pagina de pregătire (web) sau pe telefon, în Symbai Staff → „Pregătire comenzi (picking)" — butonul „Citește cântarul" ia greutatea live de la cântarul depozitului, iar greutatea din eticheta GS1 scanată se pre-completează singură. Manifestul de încărcare al cursei arată apoi greutățile reale per linie și per oprire. Prețul pe kg poate fi CONTRACTUAL per client (în catalogul B2B al clientului; bate prețul general al produsului).
• Întâi cântărești, apoi facturezi. Avizul și factura pe produse cântăribile REFUZĂ cantitățile necântărite: o linie „la kg" fără greutate cântărită la picking (sau fără preț/kg) blochează generarea documentului, cu mesaj clar — valorizarea pe bucăți ar fi greșită. Coada de pregătire arată „N de cântărit" pe fiecare comandă, ca depozitarul să știe ce mai are.
• Etichete GS1 pe containere. Etichetele containerelor de producție poartă codul de bare GS1 cu greutate + lot + termen de valabilitate — scanabile la picking, la încărcare și la recepția clientului. Regula „cântărire obligatorie la produsele la kg" (cu toleranță) face parte din regulile de manipulare a containerelor, pe preseturi: Control maxim / Echilibrat / Rapid.
• Cântarul telefonului (Symbai Staff). Pe telefon, sursa de citire se alege per aparat din „Setări cântar": manual (tastezi gramele — merge cu orice cântar), prin PC (cântarul serial/USB/rețea legat de PC-ul cu Print Agent) sau Bluetooth direct pe telefon (fără PC; cântare cu profilul standard „Weight Scale" sau care transmit ASCII — le scanezi și le împerechezi din aceeași pagină). Folosit la cântăririle din telefon, de ex. inventarierea cu scăderea automată a recipientului.

Cere integrarea unui cântar NOU (când modelul nu e suportat)

Dacă userul are un cântar cu protocol propriu pe care driverele actuale nu-l acoperă, nu-l lăsa blocat — deschide-i o cerere la echipa Symbai:

1. Adună: producătorul și modelul exact, cum se conectează (serial/rețea + baud dacă știe), și — foarte util — o mostră de ce trimite cântarul (ex. textul care apare pe portul serial). Cu cât e mai completă mostra, cu atât se integrează mai repede.
2. Întreabă-l dacă vrea să fie anunțat pe email când e gata.
3. request_scale_integration(manufacturer:…, model:…, protocol:…, sampleOutput:…, useCase:…, contactEmail:…). Tool-ul deschide un ticket (sugestie) la echipa Symbai și îți dă o referință (ex. SYM-00042). Re-cererea aceluiași model se adaugă la ticketul existent, nu face duplicat.
4. Anunță-l: „Am cerut echipei Symbai integrarea cântarului «X Y» — referința SYM-NNNNN, te anunță pe email." Între timp, dacă cântarul vorbește ASCII standard, sugerează-i să încerce driverul „generic-ascii".

Reguli (cele care contează)

• Tool MCP întâi, click rar. Configurarea (cântare, catch-weight pe produs) are tool — folosește-l, nu reproduce prin click. Chrome e doar pentru a arăta rezultatul pe ecran.
• Confirmă prin citire, nu „pare bine pe ecran". Tool-ul întoarce success + un rezumat — ăla e adevărul. Re-verifici cu list_scale_devices / re-citire produs.
• Nu inventa cifre. Prețul pe kg, greutatea nominală, portul serial — le iei de la user. Ce nu știe, îl ajuți să afle (ex. portul COM îl vede în setările Windows ale PC-ului cu Print Agent).
• Ștergerea nu e prin conexiune. Dacă userul vrea să șteargă un cântar sau un model, ghidează-l în aplicație (Setări).
• Permisiune: create_scale_device / register_scale_model cer modulul Setări & Configurare; set_product_catch_weight cere Produse & Meniuri. Citirile și request_scale_integration cer grantul readModule aferent pe token. „Permisiune insuficientă" → portal Hub → Acces AI → bifează modulul.

Legături

• Concepte catch-weight (greutate variabilă, conectare cântar, flux, model nou) → knowledge/cantare-catch-weight.md.
• Etichete de producție cu greutate + cod de bare → skill-ul etichete-productie + knowledge/etichete-productie.md; design etichetă → skill-ul materiale-grafice.
• Producție pe loturi (de unde vine greutatea la ieșirea din producție) → skill-ul productie-flux.
• Comenzi B2B la kg (preț contractual/kg, picking, aviz/factură) → knowledge/b2b-comenzi-wholesale.md; skill-ul gestioneaza-comenzi-b2b.
• Doctrina Chrome (deep-link, screenshot = livrabil) → knowledge/condu-chrome.md.
• Blocaj sau cântar nesuportat → request_scale_integration (aici) sau, pentru altă lipsă, trimite_ticket_symbai.