SCARABY AIVENTUREÎnapoi la website ↗
SCARA VALORII · DOSAR TEHNIC ȘI COMERCIAL · 4 NOIEMBRIE 2026

Limitări. Decizii. Arhitectură. Realitate.

Documentație extinsă a tuturor elementelor identificate în conversație, fără confundarea funcționalităților efectiv realizate cu propunerile și obiectivele SCARA.

Document intern de lucru, accesibil prin adresă. Include cele zece trepte interne și considerații comerciale. Marcajul noindex nu controlează accesul; pagina poate fi citită de oricine cunoaște URL-ul. Nu distribui public înainte de revizuirea informațiilor confidențiale.
38 capitole detaliateImplementări, limite și costuriFără promisiuni neconfirmate

Separăm riguros: ce este scris în GitHub, ce a fost testat în browser și ce rămâne în arhitectura sau oferta propusă. Datele și costurile menționate în discuție sunt orientative, nu tarife garantate. Documentul este explicativ, nu un transcript literal caracter-cu-caracter.

01 / SCARA · DOCUMENTAȚIE

Ce este SCARA și ce nu este

SCARA este numele intern al value ladder-ului AiVenture. Generatorul produce site-ul, iar value ladder-ul descrie cum poate crește în timp valoarea relației comerciale după ce acel site a fost activat. Confuzia inițială, prin care generatorul era prezentat ca întregul proiect, a fost corectată explicit. Problema recunoscută imediat de antreprenor este: „Am înființat firma și vreau să pot trimite unui client un link care arată ce fac și cum mă poate contacta.”

Pe măsură ce firma își folosește site-ul pot apărea nevoi suplimentare: să fie descoperită, să primească solicitări mai clare, să răspundă la timp, să urmărească ofertele și să delege anumite operații către AI. Aceasta nu este o succesiune obligatorie de upgrade-uri. Clientul poate rămâne doar la site sau poate solicita funcții dintr-o treaptă ulterioară înaintea alteia.

Regula comercială: publicul vede prima treaptă și eventual următoarea, nu harta internă completă. Această documentație explică tot modelul, dar este un document tehnic, nu un mesaj comercial care trebuie plasat pe homepage.

02 / SCARA · DOCUMENTAȚIE

Treapta 1 — Prezență online

„Vreau să-i trimit clientului un link cu serviciile și telefonul meu.” Livrabilul proiectat este un site cu cinci pagini, găzduire, adresă de tip inweb.ro, servicii și zonă geografică confirmate. Rezultatul este un link funcțional, lizibil pe mobil și suficient de clar încât clientul să afle ce face firma și cum o contactează.

Limita de implementare: demo-ul SCARA existent nu constituie fabrica de site-uri pentru firme; previzualizarea din browser nu echivalează cu un website multi-page deja creat și publicat pentru acea firmă. Informațiile despre servicii și localitate trebuie aprobate înainte de publicare.

03 / SCARA · DOCUMENTAȚIE

Treapta 2 — Identitate extinsă

„Vreau adresa mea .ro și să pot arăta lucrările realizate de noi.” Funcțiile prevăzute sunt domeniul propriu, portofoliul real, pagini suplimentare și traduceri atunci când sunt necesare.

Trebuie verificată disponibilitatea domeniului, titularul juridic, cine suportă taxele de înregistrare și reînnoire, condițiile de transfer după încetarea abonamentului și drepturile de publicare asupra fotografiilor și testimonialelor. Domeniul propriu nu se confundă cu simpla folosire a unui subdomeniu al platformei.

04 / SCARA · DOCUMENTAȚIE

Treapta 3 — Vizibilitate

„Am site. Cum mă găsește cineva care încă nu știe numele firmei?” AiVenture poate livra pagini pe servicii și localități, structurare semantică, verificarea indexării, a descoperirii și a vizibilității în motoare de căutare și sisteme AI.

Dacă patronul spune „Nu mă caută nimeni”, se verifică întâi dacă site-ul este accesibil și indexat, dacă primește afișări și clicuri și dacă problema este lipsa cererii ori a conversiei. Nu poate fi garantată o anumită poziție în Google sau citarea de către modele AI. SEO, GEO/AEO, căutarea AI și conversia sunt concepte legate, dar nu identice.

05 / SCARA · DOCUMENTAȚIE

Treapta 4 — Captarea cererilor

„Când mă sună cineva, trebuie să aflu de la zero unde e lucrarea și despre ce e vorba.” Soluția este o cerere de ofertă cu serviciul solicitat, localitatea, metoda de contact și fotografia lucrării, când aceasta este justificată.

Valoarea se măsoară prin cereri complete, nu numai prin trafic. Un formular trebuie să livreze efectiv datele către firmă, să limiteze spamul, să protejeze fișierele și să colecteze numai datele necesare. În demo-ul actual nu există un proces operațional complet pentru acest flux.

06 / SCARA · DOCUMENTAȚIE

Treapta 5 — Asistent conversațional

„Sunt pe șantier și răspund seara la aceleași întrebări.” Soluția este un asistent text și, dacă este util, cu voce; răspunde din informațiile aprobate și escaladează omului solicitările care implică decizii.

SCARA AI Concierge a fost instalat ca demonstrație pe website-ul comercial. Acest chatbot cunoaște informații despre SCARA, nu date specifice fiecărui instalator. Nu trebuie să răspundă inventând faptul că o anumită firmă montează pompe de căldură într-o anumită localitate.

07 / SCARA · DOCUMENTAȚIE

Treapta 6 — CRM și memorie comercială

„Știu că mi-a trimis cineva poze, dar nu mai găsesc discuția și nu știu dacă i-am răspuns.” Livrabil: istoric per client și lucrare, cereri deschise, responsabil, termen și următoarea acțiune.

CRM presupune autentificare, autorizare, segregarea datelor firmelor, jurnal de audit și retenție, nu doar un tabel de contacte. Nu a fost construit un CRM operațional în actualul website SCARA.

08 / SCARA · DOCUMENTAȚIE

Treapta 7 — Ofertare și tranzacții

„Am toate detaliile. Vreau să trimit oferta și să văd dacă a fost acceptată.” Livrabil: ofertă, acceptare, eventual rezervare, avans și plată. Sunt necesare versiuni ale ofertei, dovada acceptării, proces de plată sigur și reguli contractuale de anulare și de facturare.

Un buton „Cere ofertă” sau o conversație AI nu reprezintă încă un proces contractual sau de tranzacție realizat. Această treaptă nu este operațională.

09 / SCARA · DOCUMENTAȚIE

Treapta 8 — Automatizări operaționale

„După acceptare, copiez aceleași date în calendar, în fișa lucrării și la facturare.” Livrabil: transferul datelor aprobate între CRM, calendar, documente și facturare, cu intervenție umană în excepții.

Automatizările trebuie să fie idempotente, auditate și reversibile unde este posibil. Un agent nu trebuie să emită facturi ori să modifice rezervări fără permisiunile și regulile aprobate de firmă. Aceste automatizări sunt încă o direcție de dezvoltare.

10 / SCARA · DOCUMENTAȚIE

Treapta 9 — Agenți AI / A2A

„Un partener vrea ca sistemul lui să verifice serviciile noastre și să ne trimită cereri direct.” Livrabil: catalog structurat, interfețe machine-readable și operațiuni permise agenților autorizați.

Accesul A2A implică identificarea agentului, drepturi, tokenuri, limite de utilizare, semantica operațiilor și jurnalizarea cererilor. Faptul că un site poate fi citit de un crawler AI nu demonstrează existența unei interfețe tranzacționale A2A. Acest modul nu este integrat în website-ul SCARA.

11 / SCARA · DOCUMENTAȚIE

Treapta 10 — Cockpit AI

„Ce lucrări așteaptă ofertă, ce bani avem de încasat și ce cere atenția mea azi?” Livrabil: indicatori, alerte, recomandări și acțiuni autorizate de conducere.

O recomandare AI și executarea unei acțiuni trebuie tratate diferit. Datele trebuie să fie actuale și verificabile, iar deciziile financiare ori contractuale cer controale suplimentare. Nu există astăzi un cockpit SCARA funcțional.

12 / SCARA · DOCUMENTAȚIE

Regulile comerciale și validarea valorii

Antreprenorul vede inițial doar site-ul, eventual următoarea extindere ca perspectivă. Nu i se prezintă un catalog de zece produse pe care ar trebui să le cumpere în ordine. Fiecare extindere pornește de la o nevoie observată, confirmată și acceptată voluntar.

Exemplele din conversație sunt distincte: „Nu mă caută nimeni” sugerează un diagnostic de vizibilitate; „Mă sună, dar nu îmi trimit detaliile lucrării” sugerează formularul cu fotografie; „Primesc cereri, dar uit cui am promis ofertă” indică CRM. Un client poate avea nevoie de formular înainte de investiția în vizibilitate.

Prima plată după cele șapte zile validează oferta de intrare. Funcționarea value ladder-ului se validează abia când o firmă solicită ulterior o funcție și poate dovedi un rezultat: cerere completă, ofertă urmărită sau timp de muncă economisit.

13 / SCARA · DOCUMENTAȚIE

Pilotul CAEN 4322 / segmentul MM−1

Pilotul selectează firme nou-înființate din CAEN 4322 (instalații sanitare, de încălzire și climatizare), cu telefon publicat de ANAF și fără site activ identificat. Lipsa unui site este o evaluare, nu o certitudine, iar datele publice nu autorizează automat marketingul nesolicitat prin orice canal.

Fluxul propus este demonstrație privată → confirmarea serviciilor și a zonei → aprobare de publicare → activare → șapte zile gratuite → decizia voluntară de plată. Măsurătorile diferă în funcție de etapă: rată de aprobare, activare, conversie în plătitor, retenție la 30/90 zile și valoare activată ulterior.

În conversație s-a cerut respectarea unui proces de contact responsabil, inclusiv bazele legale și consimțământul unde este necesar. Identificarea unui telefon publicat nu elimină obligațiile privind datele personale și comunicările comerciale.

14 / SCARA · DOCUMENTAȚIE

Pachetele de intrare: Start 10 €, Cereri 15 €, Identitate 20 €

START (10 €/lună) a fost definit drept site profesional cu contact telefonic. CERERI (15 €/lună) include formular pentru solicitări de ofertă. IDENTITATE (20 €/lună) include domeniu .ro propriu. Acestea sunt variante de configurare ale primei oferte, nu primele trei trepte ale modelului intern.

Ulterior s-a propus ca pachetul CERERI de 15 € să includă și un asistent AI text + voce. A fost schițat un plafon comercial de aproximativ 500 de răspunsuri AI/lună/firmă, înaintea discuției despre RAG cu 1.000 sau 5.000 de întrebări. Aceste praguri nu au fost armonizate definitiv într-un contract și nu sunt impuse printr-un contor server-side.

Înainte de vânzare trebuie stabilite TVA, ce include efectiv fiecare pachet, titularul domeniului, costurile de înregistrare/reînnoire, clauzele de încetare, perioada de probă, volumul AI și responsabilitatea pentru costuri suplimentare.

15 / SCARA · DOCUMENTAȚIE

FirmsFinder în SCARA

Baza FirmsFinder poate adăuga valoare chiar și când site-ul unei firme nu primește vizite. Exemplul concret din discuție: un instalator identifică 20 de constructori locali ca potențiali parteneri. A fost evocată utilitatea unei baze extinse de firme și acces promoțional la căutarea lor.

Nu rezultă însă că website-ul SCARA actual este integrat cu API-ul FirmsFinder, că oferă automat acces autenticat sau că poate trimite cereri comerciale în numele clientului. Drepturile, limitele de rezultate, durata accesului și respectarea regulilor de prospectare trebuie definite și implementate separat.

16 / SCARA · DOCUMENTAȚIE

Website-ul luxury premium — design și pagini

Repository-ul privat GitHub este aipath512/scara-valorii, pe ramura main. S-a proiectat și creat site-ul comercial cu fundal negru profund, accente champagne-gold, tipografie Manrope/DM Sans, fotografie arhitecturală, interfață aerisită și navigare responsive.

Pagini: Acasă (/), Vezi site-ul tău (/demo/), Cum funcționează (/cum-functioneaza/), Prețuri (/preturi/), Creștem împreună (/crestem-impreuna/), Întrebări frecvente (/intrebari/), plus pagini juridice provizorii (/confidentialitate/ și /termeni/). Ecranele de aprobare, activare și mulțumire au fost discutate ca părți ale fluxului, nu confirmate ca servicii comerciale complete.

HERO comunică rezultatul site-ului, nu tehnologia. Demonstrația începe cu activitatea, numele firmei, localitatea și telefonul; imaginile vizuale trebuie să fie adecvate CAEN, optimizate și folosite cu drepturi de publicare corespunzătoare.

17 / SCARA · DOCUMENTAȚIE

Ce poate face /demo/ astăzi

Pagina demo actualizează o previzualizare vizuală locală, în browser, pe baza datelor introduse. Este utilă ca simulare a primei impresii, dar nu creează un profil de client în D1, nu verifică automat ONRC/ANAF, nu generează cinci pagini independente publicate, nu trimite date prin CRM și nu începe perioada de probă de șapte zile.

Publicarea completă necesită autentificare sau identificare adecvată, confirmarea datelor, stocare, administrarea stării draft/aprobat/publicat, configurarea domeniului, jurnal de audit, operații rollback și proces de contractare/plată. Demo-ul nu este dovada că această fabrică este operațională.

18 / SCARA · DOCUMENTAȚIE

GitHub, Cloudflare Pages și publicarea

Site-ul a fost creat în GitHub prin conexiunea din ChatGPT, apoi conectat la Cloudflare Pages. Configurația era un proiect static fără framework și fără comandă de build, cu branch main. Cloudflare gestionează clonarea codului, construirea Pages Functions și publicarea dacă compilarea trece.

În discuție s-au folosit adresele scara-valorii.pages.dev și, în capturi, scara.dev. Verificarea unui URL public și a unui deployment Success este diferită de verificarea existenței fișierelor în GitHub. O versiune veche a site-ului poate rămâne live atunci când noile deployment-uri eșuează.

Trebuie separate clar stările: cod salvat; build reușit; deployment reușit; funcționalitate testată în browser; serviciu pregătit pentru producție. Aceste etape nu sunt echivalente.

19 / SCARA · DOCUMENTAȚIE

Chatbotul SCARA AI: bubble, linie, închidere

A fost cerut un chatbot AI reprezentat printr-o bulă discretă care se transformă într-o interfață conversațională de tip ChatGPT și revine la bulă după închidere. S-au implementat bulă aurie flotantă, fereastră de conversație, câmp de introducere, sugestii de întrebări, răspunsuri afișate în mesaje și închiderea cu X sau Escape.

Fișierele inițiale au fost chat.css, chat.js și functions/api/chat.js. În încercările de a rezolva problemele de afișare s-au creat și variante de asseturi cu nume nou; ulterior codul vocal și stilurile au fost introduse direct în index.html pentru a elimina dependențele cache-uite. Clientul a raportat un răspuns chatbot în circa trei secunde; aceasta este o observație singulară, nu un SLA.

20 / SCARA · DOCUMENTAȚIE

Llama 3.1 8B pe Cloudflare Workers AI

Backend-ul SCARA AI folosește un binding Workers AI cu numele AI și modelul @cf/meta/llama-3.1-8b-instruct-fp8. Endpointul /api/chat trimite către model instrucțiunile SCARA, întrebarea și o porțiune din istoricul conversației. Nu există un server GPU propriu și nu este folosit un abonament ChatGPT pentru inferența chatbotului.

Instrucțiunile SYSTEM definesc comportamentul: română sau limba vizitatorului, răspunsuri concise, pachetele 10/15/20 €, perioada gratuită, limita demonstrației și obligația de a nu inventa disponibilități, activări, promisiuni SEO, contracte sau servicii încă neactivate.

Codul limitează întrebarea la 1.200 caractere, istoricul primit la ultimele opt mesaje și ieșirea cerută modelului la maximum 350 tokenuri. Browserul limitează local la 20 de întrebări per sesiune și are un timeout de aproximativ 25 secunde. Aceste limite client-side nu constituie protecție anti-abuz reală la nivel de server.

21 / SCARA · DOCUMENTAȚIE

Q&A, modificarea promptului și greșelile de copiere

Informațiile comerciale și Q&A-ul sunt în functions/api/chat.js, în const SYSTEM, nu în chat.js (fișierul pentru interfață). S-a furnizat un fișier complet pentru copy-paste cu întrebări despre: ce este SCARA; demonstrația înainte de plată; pachetele 10/15/20 €; extensii viitoare; portofoliu cu fotografii reale.

Un nou Q&A se adaugă ca referință în SYSTEM. Llama nu citește o listă fixă de răspunsuri; poate reformula conform întrebării. Pentru fiecare modificare de prompt se face un commit și deployment. Textul dintre delimitatorii șirului JavaScript trebuie păstrat corect.

Nu se copiază marcajele Markdown de prezentare, cum ar fi linia care începe cu trei backtickuri și eticheta javascript. Introducerea acestor marcaje în fișierul .js a provocat eroarea concretă de compilare care a blocat mai multe deployment-uri.

22 / SCARA · DOCUMENTAȚIE

În ce bază de date caută asistentul astăzi?

În versiunea descrisă în această conversație, chatbotul nu consultă nicio bază documentară SCARA. Nu face căutări în Cloudflare D1, R2, Vectorize, AI Search sau baza FirmsFinder. Răspunsul este generat din cunoștințele modelului, instrucțiunile SYSTEM și istoricul conversației.

Dacă cineva întreabă câte firme din Brașov au CAEN 4322, asistentul nu poate furniza un număr verificat prin interogare reală în baza FirmsFinder. Un răspuns probabilistic nu trebuie prezentat ca extras dintr-o sursă oficială. Simpla adăugare a unui fișier PDF în GitHub sau R2 nu îl face automat citibil de către Llama.

23 / SCARA · DOCUMENTAȚIE

Limită de text și context

Conținutul stocat în repository poate fi mai lung decât contextul pe care modelul îl poate primi într-o singură cerere. În aceeași fereastră de context intră sistemul, întrebarea, istoricul, eventual pasajele recuperate prin RAG și spațiul rezervat răspunsului.

În conversație a fost menționată aproximativ o fereastră de 32.000 tokenuri pentru configurația modelului; limita exactă trebuie reverificată în catalogul modelului activ. Corespondența între cuvinte, pagini și tokenuri nu este fixă, în special pentru limba română. Codul SCARA aplică în plus limite mai restrictive asupra întrebării și istoricului.

Ideea mutării textelor într-un knowledge.md separat a fost discutată, dar simpla existență a fișierului nu creează căutare automată și nici vectorizare.

24 / SCARA · DOCUMENTAȚIE

RAG, embeddings, indexare și căutare semantică

SCARA AI nu vectorizează astăzi datele. Arhitectura RAG necesită ingestia documentelor, extragere de text, fragmentare, calcularea vectorilor embeddings, indexare, căutare semantică sau hibridă, filtrarea după firma autorizată și introducerea pasajelor relevante în promptul Llama.

S-au comparat R2 pentru stocare, D1 pentru metadate, Vectorize pentru vectori și serviciul Cloudflare AI Search pentru un proces gestionat de indexare și recuperare. AI Search poate reduce munca de integrare, dar nu elimină necesitatea aprobării documentelor, verificării relevanței, izolării clienților și jurnalizării.

Un chatbot al instalatorului A nu trebuie să returneze informații sau documente ale instalatorului B. Recuperarea pasajelor fără surse relevante trebuie să conducă la un răspuns prudent, nu la inventarea de detalii. RAG nu a fost încă implementat în endpointul public /api/chat.

25 / SCARA · DOCUMENTAȚIE

Costurile Llama și condițiile gratuității

Interfața bubble, animația și comenzile vizuale nu generează ele însele tokenuri AI. Costul variabil apare când modelul procesează intrarea și produce ieșirea. În conversație au fost folosite tarife orientative pentru Llama 3.1 8B FP8 de aproximativ $0,152 per milion tokenuri de intrare și $0,287 per milion tokenuri de ieșire, alături de o alocare gratuită de aproximativ 10.000 Neurons/zi/cont.

Exemplul discutat: 1.200 tokenuri input și 150 tokenuri output ≈ $0,000225 pe răspuns, aproximativ $0,23 pentru 1.000 de răspunsuri, înainte de gratuități. Costurile cresc dacă instrucțiunile, istoricul ori documentele recuperate sunt mai mari. Cifrele nu sunt facturi reale și nu trebuie tratate drept tarife garantate fără verificarea documentației Cloudflare actuale.

„Pe zero lei” este posibil pentru un pilot care rămâne în alocările gratuite, dar nu înseamnă că toate resursele, înregistrarea domeniului, suportul, stocarea suplimentară, dezvoltarea și traficul nelimitat sunt gratuite. Alocările aparțin contului și sunt partajate între aplicațiile acelui cont.

26 / SCARA · DOCUMENTAȚIE

Contorul de consum și controlul costurilor

S-au identificat metricile Cloudflare Workers AI pentru utilizare/Neurons și secțiunea Metrics a proiectului Workers & Pages pentru trafic și erori. Primul tip de metrică descrie inferența AI, al doilea execuțiile aplicației. Facturarea reală trebuie reconciliată cu Cloudflare Billing.

Un dashboard propriu SCARA a fost propus, cu: număr de întrebări, tokenuri prompt/completion, total Neurons, cost calculat, cost facturat, utilizare per firmă și pe zi/lună. Codul curent nu salvează aceste informații într-un registru D1. Câmpurile de usage returnate de model trebuie verificate după API și versiune.

Protecțiile discutate: limite server-side, rate limiting, WAF/Turnstile, buget per tenant, oprire la prag și alerte de cost. Cele 20 întrebări impuse de browser pot fi ocolite prin apel direct HTTP, deci nu reprezintă un plafon financiar real.

27 / SCARA · DOCUMENTAȚIE

AI Search / RAG: economie și praguri comerciale

S-au discutat alocări gratuite Cloudflare AI Search pentru căutări, indexare și stocare și un tarif orientativ pentru căutarea semantică peste pragul gratuit. Au fost prezentate exemple pentru 100, 1.000, 5.000, 10.000, 50.000 întrebări pe lună. Toate depind de planul contului, data facturării, tipul de căutare, ingestie, volumul stocat și modelul Llama folosit.

Propunerea utilizatorului a fost: RAG gratuit până la 1.000 întrebări/lună și +3 €/lună până la 5.000. Aceasta este o regulă comercială dorită, nu un mecanism de limitare deja implementat. Dacă 100 de firme folosesc același cont AiVenture, alocarea gratuită nu se multiplică de 100 de ori.

La 5.000 întrebări, o suprataxă de 3 € poate fi apropiată de costul brut al căutărilor, înainte de generarea Llama, indexare, suport și alte servicii. Trebuie simulată marja și verificat consumul real înainte de comercializare.

28 / SCARA · DOCUMENTAȚIE

Vocea — varianta A prin browser

S-a decis adăugarea gratuită din punct de vedere al inferenței vocale Cloudflare folosind API-uri ale browserului: SpeechRecognition/webkitSpeechRecognition pentru dictare și SpeechSynthesis pentru citirea răspunsului. Llama primește în continuare text, deci nu există un nou model vocal server-side.

Interfața include microfon lângă butonul ↑, transcriere în câmp, trimitere explicită, buton „▶ Ascultă”, opțiune „Voce automată: oprită/pornită” și „Oprește vocea”. Închiderea panoului oprește recunoașterea și sinteza. Vocea este opțională; textul trebuie să rămână funcțional când browserul nu suportă recunoașterea.

Limitări: experiența nu este full-duplex ca o conversație telefonică; româna și vocile diferă între dispozitive; browserul poate folosi servicii externe pentru recunoaștere; este necesară permisiune microfon și testarea pe Chrome/Android/Safari iPhone. Cost vocal suplimentar facturat de Cloudflare: 0 pentru această variantă; costul Llama rămâne.

29 / SCARA · DOCUMENTAȚIE

Vocea — varianta B cloud STT/TTS

A fost explorată și recunoașterea vocală pe server (de exemplu model Whisper) plus sinteză vocală neuronală. Aceasta ar necesita fluxuri audio dedicate, validarea formatului și calității pentru limba română, un model TTS disponibil, rate limiting și costuri suplimentare.

A fost oferit un exemplu de cost aproximativ $4,86 pentru 1.000 de interacțiuni vocale, pe ipoteze privind minutele audio și numărul de caractere sintetizate. Exemplul nu constituie o ofertă fermă și nici o măsurătoare reală. Varianta B nu a fost instalată; s-a implementat varianta A.

30 / SCARA · DOCUMENTAȚIE

EU AI Act: identificarea asistentului AI

S-a cerut și implementat textul exact „Asistent AI · Răspunsuri generate automat”, afișat sub „SCARA AI CONCIERGE”. Informarea utilizatorului că discută cu AI se referă la transparența reglementată, în situațiile aplicabile, de articolul 50 din Regulamentul (UE) 2024/1689.

Nu există o obligație universală de a afișa exact expresia în engleză „Generated by AI”; importanța constă în claritate, vizibilitate și momentul informării. Eticheta nu certifică singură respectarea întregului EU AI Act și nici GDPR. Sunt necesare clasificarea rolurilor, evaluarea prelucrărilor de date, condițiile de utilizare, eventuala procesare vocală și implementarea altor obligații aplicabile.

Surse normative oficiale trebuie consultate la data operaționalizării: EUR-Lex pentru AI Act și textele GDPR.

31 / SCARA · DOCUMENTAȚIE

Incidente de deployment și diagnosticul real

După implementarea interfeței vocale, utilizatorul a trimis capturi în care microfonul nu apărea. Au fost încercate invalidări de cache, nume noi pentru fișierele JavaScript/CSS, un fallback injectat și integrarea directă a widgetului în index.html. Încercările anterioare nu rezolvau cauza reală, deoarece deployment-urile noi Cloudflare eșuau.

Capturile au arătat că versiunea veche, cu commit 1721b7c, avea Success, dar ultimele versiuni, inclusiv 3823060, erau Failed. Utilizatorul a furnizat logul exact: „Expected ; but found Ești” în functions/api/chat.js, linia 6, la compilarea Pages Functions.

Verificarea fișierului a demonstrat că marcajele Markdown din blocul de cod fuseseră lipite în fișier ca text literal. Corecția a eliminat delimitatorii Markdown și a păstrat instrucțiunile și Q&A-ul, prin commit b49ca42. Lecția: un commit acceptat de GitHub nu înseamnă deployment reușit; logul de compilare trebuie citit înainte de a presupune o problemă de cache.

32 / SCARA · DOCUMENTAȚIE

Cloudflare propriu pentru fiecare firmă — BYOC

Clientul poate avea propriul cont Cloudflare, propriul Worker, propriul binding Workers AI și propriile alocări gratuite și facturi. Modelul este numit Bring Your Own Cloudflare (BYOC), distinct de SCARA Managed, unde AiVenture operează infrastructura multi-tenant centralizată.

Dacă website-ul clientului este pe Cloudflare, dar endpointul AI apelează în continuare contul AiVenture, consumul AI rămâne la AiVenture. Pentru facturare directă pe contul clientului, executarea modelului și a eventualului AI Search trebuie realizată efectiv din infrastructura acestui cont.

Clientul trebuie să autorizeze deployment-ul prin mecanisme sigure și limitate. Nu se cere parola contului și nu se publică API tokenuri în repo sau în browser. BYOC simplifică separarea costurilor, dar complică actualizările, revocarea accesului, versiunea fiecărui deployment, suportul și monitorizarea centralizată.

33 / SCARA · DOCUMENTAȚIE

Deployment Manager: ce există în cod

La solicitarea de implementare s-au creat în repository deployment/manager.mjs, deployment/byoc/worker.mjs, deployment/tenant.example.json, deployment/README.md, .gitignore și un workflow GitHub Actions pentru verificarea sintaxei. Managerul are comenzi pentru planificare, publicare BYOC și interogarea existenței Worker-ului.

Un manifest declară numele Worker-ului, Account ID, referința clientului și aprobarea acestuia. API tokenul trebuie citit din variabile de mediu într-un mediu administrat securizat. Publicarea se face prin Wrangler și binding AI din contul autorizat.

Stare reală: este o fundație CLI pentru a publica demo-ul SCARA existent într-un alt cont, nu un dashboard SaaS, nu o instalație confirmată în alt cont, nu un registru multi-tenant D1, nu un sistem de plăți și nu un generator complet de site-uri distincte. Sunt necesare teste reale, verificarea permisiunilor, confirmarea că endpointul funcționează și reconcilierea costurilor cu contul corect.

34 / SCARA · DOCUMENTAȚIE

Fabrica industrială multi-tenant — arhitectura țintă

Modelul convenit anterior pentru SCARA prevede un Worker multi-tenant în locul unui commit GitHub pentru fiecare firmă. Fiecare client are o configurație în D1 cu CUI, CAEN, NACE, limbi, culori, imagini, titluri, CTA, date de contact și status draft/pending/approved/published/disabled. R2 stochează imagini pregenerate per CAEN, KV poate servi dicționare pentru limbi, iar site-urile au sitemap și robots corespunzătoare.

Testele de industrializare menționate includ 1.000 firme/oră, 100 site-uri în fiecare dintre cele 27 de țări UE, 24 de limbi și zero commituri per firmă. Acestea sunt criterii de acceptare discutate, nu performanțe măsurate și demonstrate în sistemul actual.

În BYOC trebuie adăugate operațiuni de distribuire a aceleiași versiuni de cod spre conturi autorizate, cu evidența versiunilor, rollback, gestiunea secretelor, observabilitate și izolarea datelor.

35 / SCARA · DOCUMENTAȚIE

Confidențialitate, legal, securitate și limitări publice

Pagini provizorii de Termeni și Confidențialitate există, dar nu înlocuiesc politicile juridice complete ale unui serviciu comercial. Mai trebuie stabilite identitatea furnizorului, temeiul și scopul prelucrărilor, destinatarii, perioada de păstrare, drepturile persoanelor vizate, gestionarea datelor vocale și eventualele servicii externe ale browserului.

De asemenea sunt necesare: politici pentru fotografii și portofolii, separarea tenanturilor, autorizarea conturilor Cloudflare, antifraudă și rate limiting, protecție pentru formulare și fișiere, contractarea pachetelor, facturare, reînnoiri de domeniu și un proces de suport cu escaladare umană.

Afișarea unei etichete AI, folosirea HTTPS, existența unui Worker sau starea Success a unui deployment nu demonstrează în sine conformitatea și securitatea completă.

36 / SCARA · DOCUMENTAȚIE

Măsurători și criterii de acceptare

Pilotul trebuie să măsoare separat conversia inițială (vizualizare demonstrație, confirmare date, aprobare, activare, plată după șapte zile) și rezultatul extinderilor (cereri complete, oferte urmărite, timp economisit). Un site frumos fără rezultate operaționale nu validează business modelul.

Pentru AI trebuie urmărite volumele, erorile, latența, acuratețea pe întrebări reale, escaladarea către om, tokenurile, Neurons, costul brut, factura și conversiile. Pentru voce: suport pe browsere, calitatea transcrierii, suportul ro-RO, citirea inteligibilă și oprirea la cerere. Pentru RAG: relevanța pasajelor, izolarea tenanturilor, actualizarea și ștergerea informațiilor.

Pentru BYOC: autorizare, scopuri minime ale tokenului, reproducerea deployment-ului, binding AI propriu, rezolvarea DNS, funcționarea endpointurilor, separarea facturării și posibilitatea revocării și recuperării după incident.

37 / SCARA · DOCUMENTAȚIE

Inventarul exact: implementat vs. propus

ElementStare
Site comercial SCARA premiumImplementat în GitHub
Demo vizual CAEN 4322Implementat local în browser, fără publicare client
Chatbot AI LlamaImplementat; utilizatorul a raportat test live
Eticheta AIImplementată
Microfon și voce browserImplementate în cod; compatibilitatea trebuie testată per browser
Q&A în SYSTEMImplementat
RAG / AI Search / VectorizeNeimplementat în chatbot
Dashboard de consum per firmăPropus, neimplementat
Limită server-side de întrebări per tenantNeimplementată
Generator complet cinci paginiArhitectură țintă, neconfirmată ca realizată
Activare comercială și plată după șapte zileNeimplementate
Deployment Manager CLI BYOCCod existent, fără test BYOC confirmat
Self-service BYOC, vault și multi-tenant D1Neimplementate
Conformitate juridică integralăNeauditată

Inventarul este fundamentat pe informațiile din conversație și pe fișierele repository-ului consultate la data redactării; nu reprezintă un audit independent complet al mediului de producție.

38 / SCARA · DOCUMENTAȚIE

Referințe, traseul modificărilor și caracterul documentului

Repository: aipath512/scara-valorii. Fișiere relevante: index.html pentru site și widget inline; functions/api/chat.js pentru prompt și endpoint; _redirects pentru rutele SPA; deployment/manager.mjs pentru CLI; deployment/byoc/worker.mjs, deployment/tenant.example.json și deployment/README.md pentru BYOC.

Repere de commit discutate: 1721b7c pentru eticheta AI; 3823060 pentru widgetul vocal inline, care a eșuat inițial la build din cauza unui fișier backend invalid; b49ca42 pentru eliminarea marcajelor Markdown din functions/api/chat.js; d28dd83 pentru documentația Deployment Manager.

Documentul explică fără scurtături toate temele identificate în această conversație, dar nu este un transcript literal, linie cu linie, cu toate capturile de ecran și metadatele mesajelor. Pentru reproducerea caracter-cu-caracter a conversației ar fi necesar exportul original al dialogului.

Capătul documentului.

Înaintea distribuirii externe sunt necesare verificarea prețurilor curente, validarea juridică, inventarierea funcțiilor reale de producție și protejarea materialelor interne.

Revenire la SCARA ↗