| name | gestioneaza-etichete |
| description | Etichetele (tagurile) produselor — creare, asignare în masă pe secții/categorii, rutare către imprimante/KDS, taguri de marketing (Vegan, Picant, Nou), audit și curățenie. La „pune tag pe produse", „rutează la bucătărie/bar", „taguri pentru imprimante/KDS", „ce produse n-au etichetă", „marchează produsele vegane". |
Gestionează etichete (taguri) — corect, sigur, vizibil
Citește întâi knowledge/etichete-taguri.md (cele 3 scopuri ale tagurilor, tool-urile, capcanele) și secțiunea „⚠ De știut la scrieri prin MCP" din knowledge/tools-mcp.md. Pentru rutare în onboarding: knowledge/onboarding/03-etichete-rutare.md; pentru legarea tag→imprimantă/ecran: knowledge/echipamente-kds-imprimante.md.
Toate scrierile cer modulul produse_meniu pe token; lipsă → „permisiune insuficientă" (activare din portal Hub → Acces AI). Citirile cer grantul readModule aferent pe token.
Regula de aur
Niciodată nu scrii în masă fără dry-run. Înainte de orice bulk_assign_tag, rulează search_products_for_tagging cu EXACT aceleași filtre, arată utilizatorului numărul real de produse + 2–3 exemple, cere OK. Numărul real vine din dry-run, NU din productCount-ul lui list_menu_categories (acela numără articole de meniu și se dublează când un produs e în 2 meniuri).
Inventarul de pornire (citește înainte să întrebi)
list_brands → brandId. La create_tag e opțional: fără el eticheta se aplică în TOATE unitățile (corect pentru atribute — Vegan, Lactate, alergeni, TVA), cu el eticheta e a acelui brand (corect pentru rutare — fiecare local are barul lui). La multi-brand, dacă cererea nu spune al cui e eticheta de rutare → întreabă o dată. Pe restul filtrelor (list_*, bulk_assign_tag) trimite-l peste tot unde e acceptat.list_tag_summary(brandId) → ce etichete există + câte produse au. Refolosește etichetele existente (același nume, nu variante noi) — au deja reguli de rutare în spate. NU recrea „BAR" dacă există „BAR TERASĂ".list_menu_categories(brandId) → structura REALĂ (ierarhică, cu path complet). Orice filtru pe categorie pleacă de aici — nu inventa ramuri.list_untagged_products(brandId) → ce a rămas neetichetat.
Rețeta 1 — Etichete de rutare la secții (Bar / Bucătărie / Grătar)
Scopul: fiecare produs vandabil are o etichetă de secție, ca bonul să ajungă la imprimanta/ecranul corect.
- Întreabă scurt posturile fizice: „Ce posturi primesc comenzi — bucătărie și bar? Mai e grătar, pizzerie, patiserie? Fiecare cu imprimanta/ecranul lui?" → lista scurtă de etichete (2–4).
- Creează etichetele lipsă cu
create_tag(name, brandId, color) (idempotent pe nume+brand; reține id-ul). Aici brandId chiar contează: o etichetă de rutare aparține unui local — fără brand ar putea fi legată de imprimanta oricărei unități, cu brandul greșit nu poate fi legată de a ta. Culori sugestive: roșu bucătărie, albastru bar.
- Dry-run per secție:
search_products_for_tagging(brandId, categoryName:"BAR") (subtree rollup prinde toată ramura). Confirmă numărul cu utilizatorul.
- Asignează:
bulk_assign_tag(tagId, brandId, categoryName:"BAR") (sau categoryNames / categoryPath pentru ramuri exacte). Răspuns {assigned, skipped, total}.
- Rămășițe:
list_untagged_products(brandId) → bulk_assign_tag cu nameContains/entityIds, sau assign_tag pentru 1–2 cazuri.
- ⚠ Tag NOU = bonuri pierdute. Un tag de secție nou NU rutează nicăieri până nu există regula tag→imprimantă/KDS — produsele lui generează bonuri „unrouted" fără eroare. Regula NU se face prin MCP. Spune-i utilizatorului EXACT ce tag și unde trebuie să iasă, du-l în pagină (
gaseste_in_aplicatie("rutare etichete imprimante KDS")) și cere un bon de test. Etichetele puse pe etichete deja-rutate (refolosite) merg imediat.
Rețeta 2 — Etichete de marketing / atribute
Pentru filtre de meniu/portal/campanii: „Recomandat", „Nou", „Vegan", „Picant", „Happy Hour".
create_tag(name, color, description) — fără brandId: un atribut („Vegan", „Picant") descrie produsul, care e comun pe firmă, deci eticheta trebuie să se aplice în toate unitățile. Aici poți avea oricâte — nu afectează rutarea.- Asignează țintit: rar pe categorie (un atribut e per produs), de obicei cu
nameContains sau entityIds (lista de produse confirmată cu utilizatorul). Dry-run întâi.
- Atributele nu rutează bonuri — nu te complica cu reguli de imprimantă.
Rețeta 3 — Audit și curățenie
list_tag_summary(brandId) → vezi dubluri de nume („Bar" vs „bar" vs „BAR TERASĂ"), etichete goale (0 asignări), etichete fără brand asociat.list_untagged_products(brandId) → produse fără rutare (= bonuri care nu ies). Etichetează-le sau confirmă cu utilizatorul că intenționat nu se trimit nicăieri.- Scoate o etichetă greșită:
bulk_remove_tag(tagId, ...aceleași filtre) sau bulk_remove_tag(tagId, entityIds:[...]). (Pentru „scoate tagul de pe produse" NU e nevoie de ștergerea tagului.)
- Ștergerea tagului gol se face DOAR din aplicație —
gaseste_in_aplicatie("pagina de etichete produse"), dă-i link-ul.
- Redenumire / reculoare:
update_tag(tagId, name?, color?, description?) — singura cale (NU create_tag, care nu suprascrie).
Arată-i utilizatorului ce faci (extensia Chrome)
Clientul nu vede codul — vede aplicația. Dacă extensia Chrome e conectată, DESCHIDE pagina de etichete ca să vadă rezultatul:
gaseste_in_aplicatie("pagina de etichete produse") → ruta (de regulă /ai-tags).navigate(<link>) în tab-ul sesiunii (creează-l cu tabs_context_mcp{createIfEmpty:true} o singură dată).- După o scriere, re-
navigate (refresh) și confirmă vizual cu find("eticheta X") — datele apar în UI doar după refresh.
Fără extensie → dă-i link-ul și spune-i ce să vadă.
Verifică prin CITIRE (nu prin UI, nu cu get_product_details)
După orice scriere:
list_tag_summary(brandId) → eticheta există, are numărul de produse așteptat, fără dubluri.search_products_db(tagNames:["bar"]) → spot-check că tagul întoarce produsele corecte. Folosește asta, NU get_product_details — get_product_details întoarce un răspuns foarte voluminos care umple contextul degeaba.list_untagged_products(brandId) → gol (sau doar ce intenționat nu se rutează).
Interfața se actualizează abia după refresh — succes la tool = salvat, nu repeta scrierea.
Capcane (rezumat — detalii în knowledge/etichete-taguri.md)
- Numărul real de produse = dry-run, nu category counts (un produs în 2 meniuri se numără dublu).
categoryName face match parțial + subtree → prinde toată ramura ȘI nume duplicate sub părinți diferiți; dezambiguizează cu categoryPath (acceptă ›, >, / — lipește path-ul din list_menu_categories).bulk_assign_tag(tagId, brandId) fără alt filtru = TOATE produsele brandului. Confirmă scope-ul.create_tag re-creat = întoarce tagul vechi, ignoră noii parametri (folosește update_tag).assign_tag single nu e garantat idempotent; preferă bulk_assign_tag (idempotent + reversibil) peste 1–2 produse.- Tag nou de rutare fără regula tag→imprimantă = bonuri „unrouted" fără eroare.
- Dacă tot dai de un perete (ceva ce userul poate face în aplicație dar tu nu prin conexiune), raportează cu
trimite_ticket_symbai (tip „sugestie", cu dedupeKey).
