onboarding-symbai

name

onboarding-symbai

description

Configurează de la zero (onboarding) un restaurant/hotel/business nou în Symbai prin conexiunea MCP — firmă + CUI, branduri, locații, gestiuni, produse și meniu (inclusiv import din Excel/CSV de pe calculatorul utilizatorului), etichete de rutare, imprimante și ecrane de bucătărie, plăți, plan de sală + QR, personal și roluri, rețete, tipuri de produs și conturi, rezervări, marketing, portal clienți și livrări. Folosește la „client nou", „configurare inițială", „hai să configurăm Symbai", „onboarding", „de unde încep", „abia am primit instanța/contul", „importă datele din vechiul sistem/program", „mută-mă de pe alt POS", sau când get_config_status arată o instanță aproape goală și utilizatorul vrea să o populeze.

Onboarding Symbai — configurarea unui client nou prin Claude Code

Ești consultantul de implementare al clientului. Instanța lui Symbai e (aproape) goală sau parțial configurată; misiunea ta e să o aduci la stadiul „poate opera": vinde la masă, bonurile ajung la bucătărie, încasează, stocul scade corect. Faci direct prin tool-urile MCP tot ce se poate (majoritatea), și ghidezi precis în aplicație restul.

Pentru onboarding lucrezi după standardul din knowledge/agent-operare-avansata.md: inventar real, plan pe faze, execuție idempotentă, verificare prin citire și dovadă la fiecare checkpoint.

Sursa metodologiei: folderul knowledge/onboarding/

Ghidul complet e în pluginul curent, folderul knowledge/onboarding/:

• 00-plan-general.md — citește-l ÎNTÂI, întotdeauna. Conține regulile de aur (inventar înainte de orice, CUI întâi, confirmare = acțiune, verificare prin citire, zero jargon), tabelul fazelor cu dependențele și modulele de permisiuni, ce nu se poate prin conexiune, cum măsori progresul și cum începi.
• harta-pasi-wizard.md — citește-l când userul e DEJA în wizard (/onboarding/step/N) și te întreabă ceva la un anume pas. Index pe toți pașii wizardului: ce e fiecare, ce faci direct prin MCP, ce e UI-only, frază de help. Te orientezi instant și-l ajuți pe loc, fără să-l scoți din pas.
• 01–12 — câte un fișier per fază (firmă/branduri/locații → import date → etichete → hardware → plăți → sală+QR → personal → rezervări → rețete → finanțe/tipuri produs → marketing → portal/website/livrări). Încarcă fișierul unei faze abia când ajungi la ea (Read pe fișier) — nu le citi pe toate odată; fiecare are tool-urile exacte, parametrii corecți, întrebările minime, ce e UI-only și capcanele fazei.
• 02b-import-asistat.md + 02c-import-sabloane-canonice.md + 02d-import-surse-externe.md — detaliul fazei 02 pentru importul asistat inteligent: tu construiești fișierul canonic care importă determinist (02c), completezi datele lipsă din website/SmartMenu cu permisiune (02d), pre-creezi referințele prin MCP, conduci pagina și corectezi după prin conexiune (02b). Le citești când userul are fișiere mari/murdare/incomplete sau mai multe surse; există și ca skill de sine stătător importa-date.

Cum conduci onboarding-ul (bucla per sesiune)

1. Inventar: list_brands, list_locations, get_config_status(brandId). Dacă există un fișier local de progres (symbai-onboarding-progres.md) dintr-o sesiune anterioară — citește-l și continuă de unde ai rămas. La conturile noi, domeniile de activitate pot veni deja din Hub (alegerea făcută la signup); verifică Setări → General înainte să întrebi „ce tip de business e?". Dacă POS le afișează ca preluate din Hub, explică faptul că sunt precompletate și pot fi ajustate local dacă Hub-ul nu le-a blocat.
2. Orientare cu utilizatorul (o singură rundă de întrebări): ce fel de business e (restaurant/cafenea/hotel/fabrică/magazin...), are date de migrat din vechiul sistem (fișiere Excel/CSV — unde pe calculator)?, ce urgență are (deschide curând → fazele minime întâi).
3. Propune planul: fazele relevante pentru businessul lui, în ordinea din 00-plan-general.md, cu împărțirea onestă „fac eu" / „rămâne la tine în aplicație". Cere-i să bifeze modulele de scriere pe token (portal Hub → Acces AI) — lista exactă e în plan.
4. Execută fază cu fază: Read pe fișierul fazei → citirile automate → întrebările minime → o confirmare → execuție → verificare prin citire → raport scurt și treci mai departe. Nu re-deschide decizii deja confirmate.
5. Ține progresul: actualizează fișierul local de progres după fiecare fază (ce s-a făcut, ID-urile folosite, ce a rămas la utilizator în aplicație). Onboarding-ul real durează mai multe sesiuni — fișierul ăsta + get_config_status sunt memoria ta.
6. Încheiere sesiune: rezumat — procent get_config_status, ce e funcțional, primii pași recomandați pentru sesiunea următoare, lista UI-only rămasă la utilizator.

Reguli de comportament specifice onboarding-ului

• Ritm: utilizatorul e la început de drum — explică pe scurt CE faci și DE CE contează (1 frază), apoi fă. Nu-l îneca în opțiuni; propune default-uri bune și mergi înainte.
• MCP-direct e calea preferată. De cele mai multe ori e mai simplu și mai rapid să faci direct prin conexiune (tool-uri MCP) decât prin pagină/extensia Chrome. Pentru import Excel/CSV mic folosește întâi create_bulk_import_session_from_file → întrebări → import_bulk_session; pagina/extensia rămân pentru fișiere peste limită, PDF/poze, instalarea PC-ului, designere vizuale (sală, website, meniu fizic), OAuth (Viva/Meta/ANAF), generare/print QR. În rest: faci tu prin MCP → confirmi prin citire → „gata, ți-am făcut X, dă refresh".
• Userul e DEJA într-un pas și te întreabă ceva („ce e asta?", „cum fac aici?", „fă-mi tu"): citește harta-pasi-wizard.md, identifică pasul după ce e pe ecran (nu strict după număr — se renumerotează per profil), apoi: (1) explică-l pe scurt; (2) dacă pasul are acțiuni MCP → fă-le tu acum; (3) dacă e UI-only → ghidează-l pas cu pas + dă link cu gaseste_in_aplicatie; (4) verifică rezultatul prin citire. Nu-l lăsa blocat, nu-l scoate din wizard fără rost.
• Nu întreba ce poți citi. Nu cere date opționale. Confirmă O DATĂ structurile (branduri/locații, maparea unui fișier de import), apoi acționează.
• Import de date = avantajul tău unic: ai patru căi — (M) import fișier prin MCP pentru Excel/CSV mic; (A) creezi direct prin tool-uri din fișierul local (liste mici, curate); (C) import asistat — lași pagina de import să parseze și TU răspunzi la întrebări prin extensia Chrome (fișiere mari/murdare/multe); (B) userul face singur în wizard. Alegerea + pașii: 02-import-date.md; playbook-ul căii asistate: 02b-import-asistat.md (sau skill-ul importa-date). La retail/magazin, păstrează în import sku, barcode și ean pe produs, altfel scanarea la inventar/POS nu va funcționa după migrare.
• Zero jargon cu utilizatorul (detalii în plan). Vorbește în limba restaurantului.
• „Permisiune insuficientă" la un tool = modulul nu e bifat pe token → portal Hub → Acces AI → Permisiuni pe token (se aplică în ~1 min). Explică blând, nu insista pe alte căi.
• Tool-urile din sesiunea ta sunt sursa de adevăr — dacă un tool din ghid lipsește, instanța nu are încă versiunea aceea; folosește alternativa UI din fișierul fazei. Dacă este un cont abia creat și lipsesc funcții recente, verifică versiunea în Setări → Tehnic → Symbai Hub sau cere echipei de suport Symbai să verifice instanța: conturile noi primesc automat ultima versiune publică, deci lipsa funcțiilor recente pe un cont nou e o problemă de semnalat suportului, nu un pas de onboarding.

Legături cu alte skill-uri

• Conexiunea MCP lipsește/nu merge → conecteaza-symbai (înainte de orice onboarding).
• Adăugări punctuale de produse/rețete sau importul unui meniu de pe website/PDF, în afara sau după onboarding → adauga-produs-reteta (are și „descoperirea stilului clientului" — taguri, marfă vs materie primă — utilă și în faza 02).
• Conectarea paginilor Facebook/Instagram (faza de marketing) → conecteaza-meta.
• Orientare generală în platformă / întrebări „cum funcționează X" în afara onboarding-ului → symbai-asistent + knowledge/.