1. Prezentare generală și concepte cheie¶

Înainte de a intra în ecranele individuale, este util să înțelegeți cele câteva concepte esențiale pe care este construită aplicația. Apar peste tot în interfață și în restul acestui manual.

„Modelul de obiecte" — cinci lucruri despre care veți auzi¶

1. Carte (Book)¶

Obiectul central. Fiecare carte din LexiScor reflectă o carte reală din catalogul Editura Gama. O carte este identificată prin ISBN (același număr tipărit pe coperta a IV-a). Fiecare carte are:

titlu, imagine de copertă, descriere
o clasă (Pregătitoare, I, II, III, …)
un modul (perioada școlară: 1, 2, 3, Vacanța de vară, …)
o valoare în puncte folosită în programul de loialitate Editura Gama
pachetele din care face parte cartea (vezi mai jos)

Cărțile nu se creează manual în LexiScor. Sunt preluate din librăria Magento EDG prin sincronizarea Magento.

2. Pachet (Package)¶

Un pachet este un grup de marketing/curriculum din librăria EDG — de exemplu „Clasa I — Modulul 1". O carte poate aparține unuia sau mai multor pachete. Pachetele sunt folosite în tabloul de bord pentru a grupa cărțile într-un mod care reflectă cum sunt vândute și folosite la clasă.

La fel ca în cazul cărților, pachetele sunt preluate prin sincronizarea Magento și nu se creează manual.

3. Test (Quiz)¶

Un test aparține unei singure cărți. Este o listă de întrebări cu mai multe variante, fiecare cu cel puțin două răspunsuri și exact un răspuns corect. Fiecare întrebare are un punctaj (implicit 1).

Reguli importante de reținut:

O carte poate avea mai multe versiuni de teste (v1, v2, v3 …). La un moment dat, doar un singur test poate fi publicat per carte — acela este cel pe care îl văd publicul.
Versiunile mai vechi rămân disponibile pentru referință istorică, ca încercările existente să rămână relevante.
Testele sunt întotdeauna create prin import Excel — nu mai există un buton „creează test de la zero" în zona de admin. Vezi Import teste din Excel.
Un test poate fi în una din trei stări: draft, published (publicat) sau archived (arhivat).

4. Încercare (Attempt)¶

Când un elev rezolvă un test, sistemul înregistrează o încercare. O încercare conține cine a rezolvat (nume, email opțional), ce răspunsuri a ales, scorul, durata și dacă a promovat sau a expirat timpul.

Încercările alimentează pagina Încercări — acolo mergeți să vedeți cine ce a rezolvat, scoruri medii, rate de promovare și pentru a exporta date pentru raportare.

5. Administrator (Admin)¶

Fiecare acțiune din zona de admin este efectuată de un administrator. Există două roluri:

admin — poate face tot ce este descris în acest manual cu excepția administrării altor administratori.
superadmin — poate, în plus, să adauge și să șteargă conturi de administrator prin pagina Admins.

Administratorii se conectează cu un cod de unică folosință trimis pe email. Nu există parole de memorat sau de resetat.

Cum arată ciclul de viață al unui test în practică¶

O poveste tipică, de la cap la coadă, pentru o singură carte:

Cartea este adăugată în librăria Magento EDG (în afara LexiScor).
Un administrator dă click pe Start Sync în pagina Magento Sync. LexiScor știe acum despre carte și despre pachetele din care face parte.
Un administrator pregătește un fișier Excel cu întrebările, răspunsurile și punctajele testului, apoi îl încarcă pe pagina de Import. Prima versiune (v1) este creată în stare draft.
Administratorul deschide testul din pagina Books, corectează inline eventualele greșeli de redactare (singurul tip de editare care nu cere reimport) și dă click pe Publish când e gata.
Adresa publică a cărții — /book/<isbn> — servește acum testul oricui o vizitează. Link-ul poate fi tipărit în carte sau distribuit online.
Pe măsură ce elevii rezolvă testul, se acumulează încercări. Tabloul de bord arată un contor de încercări; pagina Încercări permite analizarea datelor în detaliu.
Dacă întrebările trebuie să se schimbe ulterior, administratorul importă un nou fișier Excel. Se creează o nouă versiune (v2). Când v2 este publicată, v1 este retrasă automat dar rămâne disponibilă pentru referință.

Editări minore vs. modificări structurale¶

Aceasta este cea mai importantă distincție de înțeles:

Modificare	Permisă inline	Necesită reimport Excel
Corectarea unei greșeli într-o întrebare	✅	—
Corectarea unei greșeli într-un răspuns	✅	—
Activarea/dezactivarea amestecării răspunsurilor	✅	—
Adăugarea sau ștergerea unei întrebări	—	✅
Adăugarea sau ștergerea unui răspuns	—	✅
Schimbarea răspunsului corect	—	✅
Schimbarea punctajului unei întrebări	—	✅
Reordonarea întrebărilor	—	✅

Motivul este corectitudinea: odată ce măcar un elev a rezolvat un test, schimbarea structurii i-ar invalida scorul. Corecturile inline de text sunt sigure pentru că nu schimbă sensul vreunui răspuns.

De unde să continuați¶

Dacă nu v-ați autentificat niciodată, continuați cu Autentificare.
Altfel, pagina Navigare admin oferă un sumar pe o linie pentru fiecare element din meniu și trimite la capitolul detaliat.