Cele 60 de semnale ON-SITE

Scop: Prima pagină explică platforma și permite inițierea unei căutări.

Conținut: H1, descriere, căutare, meniu, contact.

Unde: / și componenta homepage.

Cum: Leagă formularul de motorul de căutare real; nu afișa rezultate fictive.

Verificare: Testează HTTP 200, telefon, formular și rezultat real.

Fișiere: index.html, cautare/index.html

Scop: Vizitatorul știe unde se află și cum se întoarce.

Conținut: Meniu, linkuri interne, breadcrumb și etichete accesibile.

Unde: Header, pagini interioare, footer.

Cum: Construiește meniu coerent și breadcrumb specific fiecărei pagini.

Verificare: Testează linkurile și traseul în mobil, inclusiv paginile inexistente.

Fișiere: index.html, semnale/index.html

Scop: Cererea utilizatorului interoghează date reale, nu un demo.

Conținut: Formular, endpoint, rezultate, erori, paginare.

Unde: /cautare/ și /api/companies/search.

Cum: Conectează API-ul la baza autorizată; normalizează termenii și limitează cererile.

Verificare: Caută un nume existent, unul absent și un termen ambiguu.

Fișiere: cautare/index.html, backend/onsite.mjs

Scop: Rezultatele pot fi restrânse după criterii explicite.

Conținut: CAEN cu ediție, județ, localitate, activitate.

Unde: Pagina de rezultate și API.

Cum: Aplică filtre în interogarea bazei; arată filtrele active.

Verificare: Verifică fiecare rezultat față de criteriile selectate.

Fișiere: cautare/index.html, backend/onsite.mjs

Scop: Fiecare firmă publicabilă are URL stabil și pagină proprie.

Conținut: Nume, identificator, activitate, surse, actualizare.

Unde: /firme/{id}/ și generatorul de pagini.

Cum: Generează profiluri din baza de date; evită paginile goale.

Verificare: Deschide direct URL-ul și compară informația cu înregistrarea.

Fișiere: backend/onsite.mjs

Scop: Identificatorii firmei provin din surse admise.

Conținut: Denumire, identificator, stare, adresă, sursă.

Unde: Tabelul companies și profilul HTML.

Cum: Importă doar câmpurile permise; păstrează proveniența.

Verificare: Compară un eșantion cu sursa originală.

Fișiere: backend/onsite.mjs, source-provenance.json

Scop: Codul activității este legat de ediția sa corectă.

Conținut: Cod, denumire, revizie, rol principal/secundar.

Unde: Taxonomie și relațiile firmă–activitate.

Cum: Versionează CAEN Rev.2/Rev.3 și mapează explicit schimbările.

Verificare: Validează codurile și edițiile pe un eșantion.

Fișiere: taxonomy.json, backend/onsite.mjs

Scop: Nu deducem automat servicii din codul CAEN.

Conținut: Serviciu, descriere, firmă, sursă, stare.

Unde: Tabelul services și profiluri.

Cum: Publică servicii ca verificate numai cu dovezi suficiente.

Verificare: Controlează pentru fiecare serviciu linkul la sursă.

Fișiere: services.json, backend/001_onsite.sql

Scop: Firmele sunt evaluate după aceleași câmpuri.

Conținut: Tabel comparativ, valori lipsă și surse.

Unde: /comparare/ și API.

Cum: Construiește aceeași schemă de comparație pentru toate firmele.

Verificare: Compară două firme și verifică toate câmpurile.

Fișiere: comparare/index.html, backend/onsite.mjs

Scop: Utilizatorul descoperă firme fără nume exact.

Conținut: Pagini CAEN, industrie, județ, localitate.

Unde: /categorii/ și /localitati/.

Cum: Generează pagini utile, cu legături spre profiluri.

Verificare: Testează relevanța și evită paginile fără conținut.

Fișiere: categorii/index.html, localitati/index.html

Scop: Cititorul știe când a fost observată informația.

Conținut: Data colectării, verificării, versiunii.

Unde: Profiluri și metadate.

Cum: Afișează data reală din pipeline, nu data renderului.

Verificare: Compară cu jurnalul de import.

Fișiere: data-freshness.json, backend/onsite.mjs

Scop: Fiecare afirmație importantă poate fi urmărită.

Conținut: Link, nume sursă, dată consultare, câmp susținut.

Unde: Profiluri și comparații.

Cum: Adaugă referințe lângă faptele relevante.

Verificare: Deschide sursa și verifică afirmația exactă.

Fișiere: surse/index.html, backend/onsite.mjs

Scop: Interfața poate fi folosită fără zoom și scroll lateral inutil.

Conținut: Viewport, CSS responsiv, controale accesibile.

Unde: HTML, CSS și componente UI.

Cum: Adaptează meniul, căutarea și tabelele la mobil.

Verificare: Testează pe telefon real și cu tastatură.

Fișiere: onsite.css

Scop: Conținutul apare repede și rămâne stabil.

Conținut: LCP, INP, CLS, cache, optimizare imagini.

Unde: Frontend și CDN.

Cum: Optimizează resursele și măsoară înainte/după.

Verificare: PageSpeed Insights și date reale când există.

Fișiere: performance-budget.json

Scop: Vizitatorul poate solicita informații sau corecturi.

Conținut: Formular, confirmare, protecție antispam, GDPR.

Unde: /contact/ și /api/contact.

Cum: Validează server-side și înregistrează solicitările.

Verificare: Trimite cerere de test și confirmă recepția.

Fișiere: contact/index.html, backend/onsite.mjs

Scop: Reguli publice pentru crawlerele care le respectă.

Conținut: User-agent, Allow/Disallow, Sitemap.

Unde: /robots.txt.

Cum: Publică reguli coerente cu politica de crawling.

Verificare: HTTP 200; verifică să nu blocheze profilurile.

Fișiere: robots.txt

Scop: Inventarul URL-urilor canonice publicabile.

Conținut: Elemente loc și eventual lastmod real.

Unde: /sitemap.xml.

Cum: Generează sitemap din pagini publice, nu manual.

Verificare: XML valid; fiecare URL este accesibil.

Fișiere: sitemap.xml

Scop: Ghid opțional în Markdown pentru consumatori AI.

Conținut: Identitate, descriere, linkuri, limite.

Unde: /llms.txt.

Cum: Elimină trimiteri greșite la alte domenii; descrie datele reale.

Verificare: HTTP 200; linkuri și afirmații corecte.

Fișiere: llms.txt

Scop: Documentație opțională extinsă a platformei.

Conținut: Metodologie, date, surse, limite, API-uri.

Unde: /llms-full.txt.

Cum: Scrie documentație consecventă cu funcțiile existente.

Verificare: Revizie factuală și linkuri valide.

Fișiere: llms-full.txt

Scop: Manifest propriu al identității digitale.

Conținut: Nume, URL, versiune, capabilități.

Unde: /digital-dna.json.

Cum: Generează din configurația oficială; nu inventa capabilități.

Verificare: JSON valid și identitate concordantă.

Fișiere: digital-dna.json

Scop: Date structurate în paginile HTML.

Conținut: Organization, WebSite, tipuri potrivite profilurilor.

Unde: În head sau body prin script application/ld+json.

Cum: Alege proprietăți corecte și valori susținute.

Verificare: Validator Schema.org; concordanță cu pagina.

Fișiere: schema-org.json, semnale/index.html

Scop: Indică URL-ul preferat al paginii.

Conținut: Link rel=canonical spre pagina corespunzătoare.

Unde: Head pentru fiecare URL.

Cum: Generează canonical per profil, nu spre homepage.

Verificare: Verifică URL, redirecționări și indexabilitate.

Fișiere: canonical-map.json

Scop: Export structurat al entităților.

Conținut: ID, nume, tip, sursă, paginare.

Unde: /entities.json sau API.

Cum: Construiește export din DB; paginează volumele mari.

Verificare: ID-uri unice și corespondență cu DB.

Fișiere: entities.json, backend/onsite.mjs

Scop: Catalogul serviciilor confirmate sau marcate ca neconfirmate.

Conținut: ID, nume, firmă, sursă, statut.

Unde: /services.json sau API.

Cum: Leagă serviciile de dovezi, nu doar de CAEN.

Verificare: Verifică status și sursa fiecărei relații.

Fișiere: services.json, backend/onsite.mjs

Scop: Acțiuni/intenții pe care sistemul le poate satisface.

Conținut: Verb, obiect, rută, exemple, stare.

Unde: /intents.json.

Cum: Mapează SEARCH/GET/COMPARE către funcții existente.

Verificare: Fiecare endpoint declarat răspunde corect.

Fișiere: intents.json

Scop: Clasificări semantice cu versiuni.

Conținut: CAEN/NACE, revizie, cod, denumire.

Unde: /taxonomy.json și DB.

Cum: Păstrează clasificări și conversii explicite.

Verificare: Testează coduri valide pentru fiecare ediție.

Fișiere: taxonomy.json, backend/onsite.mjs

Scop: Legături explicite între firme, activități și locuri.

Conținut: Subiect, relație, obiect, sursă.

Unde: /entity-relationships.json și DB.

Cum: Generează relații numai din câmpuri susținute.

Verificare: Verifică un eșantion de legături.

Fișiere: entity-relationships.json, backend/onsite.mjs

Scop: Fiecare fapt important are origine trasabilă.

Conținut: Claim ID, source ID/URL, dată, stare.

Unde: /source-provenance.json și DB.

Cum: Înregistrează proveniența la import și modificare.

Verificare: Reconstituie sursa unui fapt din profil.

Fișiere: source-provenance.json

Scop: Politica și istoricul actualizării datelor.

Conținut: Set de date, ultim import reușit, frecvență.

Unde: /data-freshness.json.

Cum: Actualizează metadatele numai după import reușit.

Verificare: Compară cu logurile pipeline-ului.

Fișiere: data-freshness.json, backend/onsite.mjs

Scop: Rezumate scurte bazate pe fapte verificabile.

Conținut: Entitate, rezumat, surse.

Unde: HTML și /ai-summary-blocks.json.

Cum: Generează din date și marchează incertitudinile.

Verificare: Fiecare propoziție are suport.

Fișiere: ai-summary-blocks.json, surse/index.html

Scop: Tabele semantice ușor de interpretat.

Conținut: thead, tbody, th, td, antete corecte.

Unde: Pagini HTML și /extractable-tables.json opțional.

Cum: Folosește HTML semantic, nu text aliniat vizual.

Verificare: Parserul extrage rânduri și coloane corect.

Fișiere: extractable-tables.json

Scop: Fragmente identificabile cu sursă și versiune.

Conținut: Chunk ID, URL, hash, poziție.

Unde: /rag-chunk-map.json sau index intern.

Cum: Segmentează documente și păstrează referințele.

Verificare: Recuperează chunk și verifică hash/sursă.

Fișiere: rag-chunk-map.json, backend/onsite.mjs

Scop: Reguli de atribuire a afirmațiilor.

Conținut: Tipuri de afirmații, surse cerute, tratarea lipsei.

Unde: /ai-citation-policy.json și serviciul AI.

Cum: Refuză sau marchează necunoscut faptele nesusținute.

Verificare: Testează afirmații fără sursă.

Fișiere: ai-citation-policy.json

Scop: Observă ce răspund și citează modelele AI.

Conținut: Întrebări, model, dată, răspuns, citări.

Unde: /ai-visibility-tests.json și results.json.

Cum: Execută teste comparabile per model și păstrează rezultate.

Verificare: Compară observațiile fără a le numi dovadă factuală.

Fișiere: ai-visibility-tests.json

Scop: Semnalează valori incompatibile între surse.

Conținut: Claim ID, surse, valori, stare rezolvare.

Unde: Motorul de audit și raport.

Cum: Compară valori normalizate și escaladează conflictele.

Verificare: Introdu contradicție controlată într-un test.

Fișiere: contradiction-rules.json, scripts/detect-contradictions.mjs

Scop: Manifestul de descoperire al agentului A2A.

Conținut: Identitate, endpoint, skills, securitate, versiune protocol.

Unde: Ruta well-known definită de versiunea A2A.

Cum: Publică Agent Card conform schemei versiunii alese.

Verificare: Validează schema cu SDK/client independent.

Fișiere: a2a-status.json, backend/onsite.mjs

Scop: Operatorul și versiunea agentului sunt identificabile.

Conținut: ID, operator legal, domeniu, versiune.

Unde: Configurația agentului și Agent Card.

Cum: Corelează identitatea tehnică cu operatorul autorizat.

Verificare: Verifică domeniul, versiunea și datele operatorului.

Fișiere: agent-identity.json

Scop: Agentul promite numai operațiuni implementate.

Conținut: company.search, company.get, company.compare.

Unde: Agent Card și registrul capabilităților.

Cum: Elimină skillurile care nu funcționează.

Verificare: Rulează teste pentru fiecare capabilitate.

Fișiere: agent-capabilities.json

Scop: Fiecare skill are descriere și exemple precise.

Conținut: ID, descriere, input, output, exemple.

Unde: Agent Card și contractele API.

Cum: Definește contractele fiecărei funcții.

Verificare: Rulează exemplele documentate.

Fișiere: a2a-contracts.json

Scop: Serverul primește și răspunde prin protocolul A2A.

Conținut: HTTPS, transport, metode și răspunsuri conforme.

Unde: Endpoint declarat de Agent Card.

Cum: Implementează transportul A2A, nu doar REST generic.

Verificare: Client A2A extern trimite cerere validă.

Fișiere: backend/onsite.mjs

Scop: Un client găsește cardul și endpoint-ul.

Conținut: Rută de discovery, card și adrese corecte.

Unde: /.well-known/ conform versiunii.

Cum: Configurează ruta de descoperire și cache adecvat.

Verificare: Clientul descarcă și parsează cardul.

Fișiere: backend/onsite.mjs

Scop: Parametrii cererii sunt validați strict.

Conținut: Tipuri, limite, câmpuri obligatorii.

Unde: Backend și validator JSON Schema.

Cum: Respinge input invalid și limite excesive.

Verificare: Testează valori lipsă, invalide și extreme.

Fișiere: a2a-input-schema.json, backend/onsite.mjs

Scop: Rezultatul are structură previzibilă și surse.

Conținut: Status, rezultate, proveniență, erori.

Unde: Backend și contracte.

Cum: Construiește răspunsuri conforme cu transportul.

Verificare: Validatorul acceptă răspunsul complet.

Fișiere: a2a-output-schema.json, backend/onsite.mjs

Scop: Verifică identitatea clientului pentru acces protejat.

Conținut: Token/OAuth sau mecanism adecvat; revocare.

Unde: Gateway și backend.

Cum: Configurează autentificarea fără a publica secrete.

Verificare: Cereri neautorizate sunt respinse.

Fișiere: authentication-policy.json, backend/onsite.mjs

Scop: Capabilitatea nu înseamnă permisiune.

Conținut: Roluri, acțiuni permise/interzise, scop.

Unde: Motorul de politici.

Cum: Aplică control per operațiune și client.

Verificare: Testează interdicția order.create pentru read-only.

Fișiere: agent-mandate.json, backend/onsite.mjs

Scop: Sarcinile au ID și tranziții urmărite.

Conținut: Task ID, status, erori, rezultate.

Unde: Backend A2A și stocarea taskurilor.

Cum: Implementează stările protocolului ales.

Verificare: Testează tranziții, eșec și anulare.

Fișiere: backend/onsite.mjs, backend/001_onsite.sql

Scop: Acțiunile sensibile așteaptă aprobare.

Conținut: Cerere, aprobator, decizie, timp.

Unde: Admin UI și motorul de politici.

Cum: Blochează execuția până la aprobare validă.

Verificare: Testează pending, reject și approve.

Fișiere: human-approval-policy.json

Scop: Controlează consumul și abuzul.

Conținut: Cereri/minut, rezultate, cost, client.

Unde: Gateway/Worker și DB.

Cum: Implementează rate limits și cote.

Verificare: Depășirea limitei este tratată corect.

Fișiere: rate-limit-policy.json, backend/onsite.mjs

Scop: Păstrează trasabilitatea interacțiunilor.

Conținut: Event ID, task, agent, versiune, rezultat.

Unde: Jurnal D1 sau echivalent.

Cum: Înregistrează evenimente fără date excesive.

Verificare: Reconstituie o cerere și răspunsul.

Fișiere: audit-policy.json, backend/onsite.mjs

Scop: Un client A2A independent folosește agentul.

Conținut: Scenariu, transcript, versiuni, rezultat.

Unde: Suita de teste end-to-end.

Cum: Testează cu client extern compatibil.

Verificare: Păstrează transcript și raport reproductibil.

Fișiere: interop-test-plan.json

Scop: Fiecare obiectiv are ID și acceptanță.

Conținut: ID, descriere, responsabil, criteriu.

Unde: Registrul de cerințe.

Cum: Asociază cerințe cu teste și controale.

Verificare: Orice cerință poate fi testată.

Fișiere: requirements.json

Scop: O regulă tehnică aplică cerința.

Conținut: Control ID, cerință, implementare, test.

Unde: Cod, configurație, procedură.

Cum: Implementează și documentează controlul.

Verificare: Testul confirmă aplicarea regulii.

Fișiere: controls.json

Scop: O afirmație poate fi urmărită la origine.

Conținut: Claim ID, source ID, dată, stare.

Unde: Registrul de proveniență.

Cum: Leagă afirmația de dovada exactă.

Verificare: Sursa chiar susține afirmația.

Fișiere: source-provenance.json

Scop: Detectează modificarea octeților unui artefact.

Conținut: Fișier, hash, versiune.

Unde: Manifest de dovezi.

Cum: Calculează SHA-256 după finalizare.

Verificare: Recalcularea produce același hash.

Fișiere: proof.json

Scop: Documentează existența unui artefact la un moment.

Conținut: UTC, hash, dovadă OTS dacă există.

Unde: Manifest și timestamp service.

Cum: Ancorează hash-ul când este justificat.

Verificare: Verifică timestampul și dovada OTS.

Fișiere: timestamp-policy.json

Scop: Datele sunt utilizate conform temeiurilor și licențelor.

Conținut: Categorii date, surse, temei, retenție.

Unde: Registru de conformitate.

Cum: Evaluează datele personale și drepturile de reutilizare.

Verificare: Revizie juridică și teste de rectificare.

Fișiere: data-rights-register.json

Scop: Previne accesul și manipularea neautorizate.

Conținut: AuthN, AuthZ, validare, rate limits, secrete.

Unde: Gateway, Worker, backend.

Cum: Aplică controale și rotește secretele.

Verificare: Teste negative și scanări de securitate.

Fișiere: security-controls.json, backend/onsite.mjs

Scop: Identifică exact codul și datele folosite.

Conținut: Commit, versiune dataset, API, deployment.

Unde: GitHub și manifest.

Cum: Înregistrează versiunile în fiecare execuție.

Verificare: Poți reproduce rezultatul din versiuni.

Fișiere: version.json

Scop: Repetă testele și detectează regresii.

Conținut: Semnal, verdict, timestamp, delta, dovadă.

Unde: Sistem de audit periodic.

Cum: Automatizează execuția și păstrează istoricul.

Verificare: Compară rapoarte și alerte.

Fișiere: monitoring-plan.json, scripts/verify-live.mjs

Scop: Evaluator separat reproduce testele.

Conținut: Validator, metodă, rezultate, discrepanțe.

Unde: Registru de validare.

Cum: Solicită reproducerea fără a te baza pe auto-declarații.

Verificare: Raportul conține probe și limitări.

Fișiere: independent-validation.json