LexiScor — Manual de utilizare¶

Bine ați venit la manualul de utilizare LexiScor. Aceasta este documentația oficială de predare-primire care descrie ce face aplicația, ce funcționalități sunt disponibile și cum se folosesc. Este scrisă pentru editori, administratori de conținut și responsabili de program — nu este nevoie de cunoștințe de programare.

Dacă sunteți dezvoltator și căutați note tehnice de implementare, consultați /docs/features și CLAUDE.md.

Ce este LexiScor?¶

LexiScor este o platformă de teste de înțelegere a textului citit, construită în jurul catalogului Editura Gama de cărți pentru copii. Fiecare carte are un test asociat; elevii rezolvă testul, primesc instant un scor și — dacă promovează — pot revendica o diplomă personalizată prin email.

Aplicația are două părți:

Partea publică — folosită de elevi și părinți. Nu este nevoie de autentificare pentru a rezolva un test. Adresele URL sunt construite pe baza ISBN-ului cărții, ca să poată fi tipărite în carte sau distribuite ca link-uri.
Partea de administrare — folosită de personalul Editura Gama pentru a gestiona cărți, a importa teste din Excel, a monitoriza rezultate și a sincroniza catalogul cu librăria Magento EDG.

Cum se citește acest manual¶

Manualul este împărțit în fișiere scurte, organizate pe subiecte. Citiți-le în ordine dacă sunteți la început, sau săriți direct la subiectul de care aveți nevoie.

Primii pași¶

Prezentare generală și concepte cheie — ce înseamnă cărți, teste, încercări și pachete în LexiScor.
Autentificare în zona de admin — cum funcționează conectarea cu cod OTP.

Zona de administrare¶

Navigare admin și aspect — ce face fiecare element din meniu.
Tablou de bord — pagina principală centrată pe cărți, cu filtre și statistici sumare.
Cărți — listarea cărților și pagina de detaliu per carte cu toate versiunile de teste.
Teste — vizualizarea unui test, editări de text minore, publicare și opțiunea de amestecare a răspunsurilor.
Import teste din Excel — formatul pe care trebuie să-l respecte fișierul și cum funcționează importul în masă.
Sincronizare Magento — preluarea cărților și pachetelor din librăria EDG.
Urmărirea încercărilor — filtrare, statistici, export CSV.
Administrarea conturilor de admin — doar pentru superadmin.

Partea publică¶

Experiența publică a testului — pagina de pornire, rezolvarea testului, vizualizarea rezultatului, revendicarea diplomei.

Referință¶

Întrebări frecvente și sfaturi zilnice — întrebări recurente și comportamente mici dar importante.
Glosar — definiții scurte pentru fiecare termen folosit în aplicație.

O notă despre capturi de ecran¶

În acest manual nu sunt incluse capturi de ecran. Textele din interfață se schimbă frecvent pe măsură ce apar funcționalități noi, iar capturile încorporate devin rapid înșelătoare. Acolo unde manualul menționează un buton sau o secțiune, formularea corespunde cu ceea ce este afișat efectiv în interfață la momentul scrierii. Dacă găsiți o discrepanță, interfața live este sursa de adevăr.

Resursele de brand LexiScor folosite în aplicație se află în /public/logos/lexiscor iar ghidul de brand este în /docs/design/lexiscor-brand-guidelines.md.