SCARABY AIVENTURE
AiVenture • Referențial unic • Documentație V1.0

SESSION SHA SSOT™

Ciclul de viață al referențialului economic comun: entități, relații, sesiuni numerice, istorizare H, lucru T, SHA-256, GitHub și Cloudflare.

8 scheme și flowchart-uri10 exemple concrete5 perspective organizaționale49 termeniReguli și anexe
LOCAL SRCOm / AIGITHUBSSOTSHA-256ComparațieCLOUDFLAREsession + KVFOOTERH + UTC local
Arhitectura surselor și a versiunii publicate

Diagrame vectoriale explicative, adaptate pentru desktop și mobil. Specificație conceptuală, nu certificare de implementare.

DOCUMENTAȚIE • CAP1

01 · Viziune și metamodel

FIRMĂEntitate AOFERĂRelațieSERVICIUEntitate B
Model economic — Entitate • Relație • Entitate

Referențialul AiVenture este unic logic la nivelul întreprinderii. El cuprinde date economice, proiecte, utilizatori, website-uri, agenți AI, entități, atribute și relații, cu proveniență și evoluție temporală.

Entitate–Relație–Entitate: FIRMĂ → OFERĂ → SERVICIU; FIRMĂ → DEȚINE → WEBSITE; SERVICIU → ARE PREȚ → BENCHMARK LOCAL. Relațiile sunt obiecte tipizate, cu identitate și istoricul lor.

Două dimensiuni temporale: timpul de validitate economică și timpul înregistrării în referențial. Datele unui fapt pot fi diferite.

FirmsFinder identifică entități, HOLMES.AI cercetează piețe și surse, SCARA generează website-uri, iar RRVI furnizează documentație demonstrativă de guvernanță AI.

DOCUMENTAȚIE • CAP2

02 · Identitatea SESSION

0009Luni0010Marți0011Miercuri0012Joi
Cronologia zilnică fără FREEZE — nu se creează H

SESSION identifică generația curentă a referențialului; nu este nici commit Git, nici deployment, nici copie fizică integrală.

CURRENT este numeric și unic global: 0009, 0010, 0011. Litera C este opțională și nu se afișează implicit. După 9999 se continuă cu 10000.

H este starea logică globală istorică și imuabilă, de forma 0009H; T este o ramură modificabilă care derivă obligatoriu din H.

O rotație zilnică incrementează CURRENT cu 1 fără să creeze automat H. Sesiunea veche se închide fără istorizare.

DOCUMENTAȚIE • CAP3

03 · Local, GitHub și Cloudflare

LOCAL SRCOm / AIGITHUBSSOTSHA-256ComparațieCLOUDFLAREsession + KVFOOTERH + UTC local
Arhitectura surselor și a versiunii publicate

Mediul SRC este local: dezvoltarea poate fi realizată manual sau cu AI. Reluarea lucrului începe cu descărcarea/sincronizarea versiunii autorizate din GitHub.

GitHub este autoritatea numărului SESSION și a registrului global. Mai multe uploaduri în aceeași zi nu incrementează CURRENT dacă nu există un alt eveniment.

Cloudflare exploatează aplicațiile și datele. Worker-ul comun session și KV reflectă sesiunea efectiv publicată, nu inventează numere globale.

Footerul fiecărui site integrat afișează versiunea publicată și timestampul în ora locală. Exemplu fictiv: SESSION 0009H · 07.11.2026 11:30 EET.

DOCUMENTAȚIE • CAP4

04 · FREEZE, H și T

0009CURRENT0009HImuabilă0010CURRENT
FREEZE: sesiunea curentă devine H, iar exploatarea continuă
0009HReferință imuabilăTMediu de lucruCURRENTNeafectat
T provenită obligatoriu din H — H rămâne nemodificată

FREEZE poate fi cerut de orice membru autorizat pentru un motiv propriu. Înghețarea privește întregul referențial chiar dacă folosește H un singur membru.

FREEZE: 0009 → 0009H + 0010. N devine NH imuabil și noul CURRENT devine N+1, fără întreruperea exploatării sau afectarea funcțională a celorlalți.

La FREEZE se păstrează solicitantul, motivul, autorizarea, UTC, baza și DELTA. Nu se copiază obligatoriu fizic întreaga bază.

Un membru poate lucra într-o T derivată din H fără a modifica H sau CURRENT; delegarea către un alt membru necesită aprobarea administratorului global.

DOCUMENTAȚIE • CAP5

05 · SHA-256 și transfer

SHA candidatversus publicatIDENTICNO-OPDIFERITValidare + transfer
Decizia SHA: identic → NO-OP; diferit → transfer reușit

Pentru fiecare țintă se compară SHA-256 al manifestului publicabil candidat cu manifestul versiunii deja publicate. Commit SHA singur nu este suficient.

SHA identic: NO-OP — fără transfer, fără H nou, fără incrementare suplimentară a CURRENT.

SHA diferit: validare, deployment și confirmare. Numai transferul reușit produce H de publicare, incrementare suplimentară și actualizarea Worker session/KV.

Un deployment eșuat nu poate fi prezentat în footer ca publicat. Operațiunile GitHub/Cloudflare trebuie să fie idempotente și recuperabile.

DOCUMENTAȚIE • CAP6

06 · DELTA, reconstrucție și MERGE

HReferințăTDELTAMERGEArbitrajCURRENTAprobat
Fluxul de corecție și integrare

STATE(H) = BASE ⊕ DELTA. Se persistă diferențele necesare și se păstrează o bază reconstructibilă imuabilă; un commit nu poate reproduce singur datele D1/R2 externe.

DELTA descrie operațiuni CREATE, UPDATE, DELETE, LINK, UNLINK asupra entităților, atributelor, relațiilor și artefactelor.

MERGE(BASE, CURRENT, TEST) integrează schimbările independente și trimite conflictele la arbitraj explicit.

ROLLBACK poate fi global sau selectiv și nu rescrie H. Ștergerea H este logică, apoi fizică controlată, protejând T dependente.

DOCUMENTAȚIE • CAP7

07 · SCARA — generatorul de website-uri low-cost

CUI + CAENFirmăETALONServiciiPREVIEWinweb.roPUBLICDomeniu propriu
Generatorul industrial de website-uri low-cost

CAEN + CUI + ETALON → entități și relații economice → website preconfigurat. Identitatea unei firme este separată de identificatorul intern al entității.

ETALON-4322 include trei familii: Încălzire, Sanitare, Climatizare; homepage-ul prezintă câte trei servicii reprezentative per familie, apoi link Vezi mai multe spre catalogul alfabetic complet.

Stratul comun ETALON este completat de stratul specific firmei: servicii confirmate, prețuri, descrieri, imagini, contact și arie deservită. Bifele propuse automat nu reprezintă confirmare comercială.

Website-ul este generat și personalizat incremental pe inweb.ro, apoi poate utiliza domeniul firmei. Modelul multi-tenant reutilizează codul; D1/R2 păstrează date și artefacte specifice.

DOCUMENTAȚIE • CAP8

08 · Responsabilități, timp și securitate

Există dezvoltatori, responsabili de proiect, directori de proiecte, administratori de proiecte și administrator global, cu drepturi și scopuri diferite într-un singur referențial.

Timestampurile sunt stocate UTC ISO 8601 și afișate local, implicit Europe/Bucharest. Numărul SESSION asigură identitatea; unicitatea temporală nu rezultă automat din milisecunde.

Registrul GitHub necesită controlul concurenței, autentificarea workflow-urilor, privilegiul minim și jurnalizarea cererilor și aprobărilor.

Nu toate deciziile sunt finalizate: ora rotației zilnice, numerotarea T, schema registrului GitHub, reconcilierea GitHub–Cloudflare și SHA pentru conținut dinamic D1.

DOCUMENTAȚIE • ANEXA1

Anexa I — Zece exemple pas cu pas

Scenarii ilustrative ale tuturor situațiilor esențiale: rotație, upload, FREEZE, SHA, T, MERGE și rollback. Apasă fiecare exemplu pentru detalii.

0101 · Cinci zile fără H+

Ziua 1: 0009. Ziua 2: 0010. Ziua 3: 0011. Ziua 4: 0012. Ziua 5: 0013. Niciun FREEZE sau transfer: zero H noi.

0202 · Patru uploaduri GitHub+

La 09:00, 11:00, 14:00 și 17:00 dezvoltatorul trimite modificări din SRC local. Commituri diferite, dar CURRENT rămâne 0009 toată ziua, fără FREEZE.

0303 · FREEZE pentru un membru+

La 11:00 membrul A cere o referință pentru SCARA. Admin aprobă: 0009 → 0009H + 0010. Referențialul global este fixat logic; celelalte proiecte continuă.

0404 · Trei FREEZE într-o zi+

CURRENT=0009. La primul FREEZE rezultă 0009H/0010, la al doilea 0010H/0011, la al treilea 0011H/0012. Ziua următoare CURRENT=0013.

0505 · SHA identic: NO-OP+

SCARA candidat și SCARA publicat au același manifest SHA-256. Nu se face deployment; CURRENT și footerul rămân neschimbate.

0606 · SHA diferit, publicare reușită+

SCARA are un manifest nou; transferul reușește și este validat. Se fixează 0009H, CURRENT devine 0010; Worker session/KV furnizează 0009H în footer.

0707 · SHA diferit, transfer eșuat+

Deploymentul Cloudflare eșuează după compararea SHA. Site-ul păstrează versiunea live anterioară. Nu se finalizează H de publicare și nici incrementarea aferentă transferului.

0808 · Site-uri cu versiuni diferite+

GitHub CURRENT=0015; scara.dev servește 0009H, iar HOLMES 0011H. Fiecare footer arată H efectiv publicată, nu 0015.

0909 · T, delegare și MERGE+

Membrul B primește de la admin acces la T derivată din 0009H. Modifică un atribut și o relație. Three-way merge compară BASE, CURRENT și T; conflictele se arbitrează.

1010 · Rollback+

Un release prezintă erori. Admin reconstruiește starea anterioară H, pregătește corecția, verifică SHA față de live și publică numai dacă este o schimbare reală.

DOCUMENTAȚIE • ANEXA2

Anexa II — Cinci perspective V1.0

Ciclul de viață prin ochii dezvoltatorului, responsabilului de proiect, directorului de proiecte, administratorului de proiecte și administratorului global.

01

Dezvoltator

Descărcă sursele la 0009; modifică local ETALON-4322 prin adăugarea entității SERVICIU și a relației cu FAMILIE; testează, trimite două commituri în aceeași 0009. După deployment SHA diferit și reușit: 0009H + 0010. Verifică pagina și footerul.

02

Responsabil de proiect

În SCARA preia CUI/CAEN 4322, verifică trei familii și servicii, personalizează împreună cu proprietarul, cere FREEZE 0010→0010H+0011 înainte de validare; folosește o T autorizată și pregătește publicarea verificabilă.

03

Director de proiecte

Coordonează FirmsFinder, HOLMES și SCARA pentru benchmarkuri locale; echipele lucrează la 0015, a doua zi 0016. Solicită FREEZE 0016H pentru reperul comun, CURRENT devine 0017. Compară DELTA între proiecte și aprobă integrarea.

04

Administrator de proiecte

CURRENT=0020; SHA diferit la SCARA și HOLMES, identic la FirmsFinder. FirmsFinder NO-OP; SCARA transferă 0020H, CURRENT 0021; HOLMES transferă 0021H, CURRENT 0022. Verifică KV și fiecare footer.

05

Administrator global

CURRENT=0030; membrul A solicită accesul membrului B la T derivată din 0024H. Admin verifică drepturile, aprobă, arbitrează un conflict FIRMĂ–SERVICIU, validează merge și eventuala publicare, menținând imuabilitatea H.

DOCUMENTAȚIE • GLOSAR

Glosar complet de termeni

Definiții ale termenilor economici, de modelare, versionare, guvernanță și exploatare.

SESSION
Identificator temporal global al generației referențialului
SSOT
Single Source of Truth, autoritatea informației pentru un domeniu
CURRENT
Sesiune globală numerică activă, fără sufix implicit
H / Historical
Stare logică globală imuabilă
T / Test-Maintenance
Ramură modificabilă derivată obligatoriu din H
FREEZE
Fixare imuabilă N→NH+N+1
DELTA
Diferența dintre două stări reconstructibile
BASE
Starea imuabilă de referință
SHA-256
Amprentă criptografică a conținutului
Commit SHA
Identificatorul unui obiect Git
Manifest canonic
Descriere deterministă a conținutului publicabil
NO-OP
Transfer eliminat pentru SHA identic
Metamodel
Model al entităților, relațiilor și atributelor
Entitate
Obiect identificabil economic sau tehnic
Relație
Fapt tipizat între entități
Atribut
Proprietate a entității sau relației
Referențial economic
Modelul comun al obiectelor economice AiVenture
Proveniență
Originea și istoricul unui fapt
Valid time
Când un fapt este valabil economic
Transaction time
Când referențialul a cunoscut un fapt
Bitemporalitate
Două axe de timp pentru același fapt
GitHub SSOT
Registrul autoritativ de sesiune și artefacte
LOCAL SRC
Spațiul de dezvoltare manuală sau AI
Push
Upload al modificărilor în GitHub
Deployment
Instalarea unei versiuni într-un mediu
Worker session
Serviciul Cloudflare pentru sesiunile publicate
Cloudflare KV
Proiecție key-value a sesiunilor publicate
D1
Depozit SQL de entități și configurări
R2
Depozit pentru imagini și artefacte
Footer SESSION
Afișaj al sesiunii publicate și timpului localizat
UTC
Timpul canonic al jurnalelor
Europe/Bucharest
Fus orar implicit de afișare
Idempotență
Retry fără dublarea efectelor
Serializare
Ordonarea operațiunilor concurente
MERGE
Integrare BASE/CURRENT/TEST
Conflict
Modificări incompatibile asupra aceleiași informații
Rollback
Revenire globală sau selectivă
Audit
Evidență verificabilă a operațiunilor
ETALON-CAEN
Catalogul comun pentru o activitate economică
CAEN
Clasificare activități economice din România
CUI
Identificator fiscal național al firmei
NACE
Clasificare europeană a activităților
Strat comun
Conținut standard reutilizabil
Strat specific
Informații personalizate ale firmei
Multi-tenant
Același motor servește mai mulți clienți
SCARA
Generator industrial de website-uri
FirmsFinder
Identificare și descoperire a firmelor
HOLMES.AI
Agent de cercetare economică
RRVI
Documentație demonstrativă pentru guvernanță AI

Statut și limite

Versiunea V1.0 documentează regulile confirmate și exemplele de proiectare. Nu demonstrează implementarea completă a registrului SESSION în GitHub sau a Worker-ului Cloudflare session. Rămân de validat ora rotației, numerotarea T, controlul concurenței și snapshoturile datelor D1/R2.