Sari la conținut

8. Sincronizare Magento

LexiScor nu deține catalogul de cărți. Sursa de adevăr pentru cărți și pentru pachetele din care fac parte este librăria Magento EDG. Pagina Magento Sync la /admin/magento-sync este modul prin care trageți o copie proaspătă a catalogului în LexiScor.

Veți rula o sincronizare ori de câte ori:

  • O carte nouă a fost adăugată în librăria Editura Gama.
  • Metadatele unei cărți (titlu, copertă, descriere, puncte, pachete) s-au schimbat în librărie.
  • Un pachet nou a fost publicat sau un pachet existent a fost reorganizat.

Ce se sincronizează — și ce nu

Sincronizate Nu se sincronizează
Titlul cărții, ISBN, imaginea de copertă, descrierea Testele (acelea trăiesc doar în LexiScor)
Clasa cărții (clasa), modulul (modul) Încercările
Valoarea în puncte a cărții Orice au făcut elevii
Pachetele și ce cărți aparțin fiecărui pachet Administratorii

Testele sunt conținut exclusiv LexiScor și nu sunt afectate niciodată de o sincronizare — chiar dacă librăria este ștearsă, testele voastre rămân în siguranță.

Cum se comportă o sincronizare

Trei garanții importante:

  1. Sincronizarea doar adaugă și actualizează — nu șterge niciodată. Dacă o carte dispare din EDG, copia LexiScor rămâne pe loc (la fel și testele și încercările ei). Asta este intenționat, ca să ne asigurăm că datele istorice nu se pierd niciodată din greșeală. Dacă chiar trebuie să eliminați o carte, faceți-o manual prin instrumente de bază de date.
  2. Sincronizarea este idempotentă. Rularea de două ori la rând este sigură; a doua rulare vede că nimic nu s-a schimbat și raportează zero actualizări.
  3. Sincronizarea ține cont de câmpuri. Când o carte se schimbă în EDG, doar câmpurile efectiv modificate sunt scrise înapoi în LexiScor — pista de audit vă arată exact ce a fost diferit.

Pagina Magento Sync, pas cu pas

Sincronizări recente (partea de sus a paginii)

Dacă a rulat vreodată cel puțin o sincronizare, un card listează ultimele rulări în ordine cronologică inversă. Fiecare rând arată:

  • Un icon verde (bifuleț) sau roșu (✗) (succes sau eșec).
  • Ora exactă la care a rulat și cât a durat.
  • Care administrator a declanșat-o.
  • Două insigne cu numere — „N created" și „N updated" — combinând pachete și cărți.
  • Pentru rulările eșuate, mesajul de eroare aferent.

Declanșarea unei noi sincronizări

Un al doilea card conține un singur buton mare Start Sync. Click pe el și:

  1. Butonul devine „Syncing…" cu un icon care se rotește. Pagina rămâne pe ecran — nu o reîmprospătați. O sincronizare tipică durează între câteva secunde și câteva minute, în funcție de cât de mult s-a schimbat.
  2. Când sincronizarea s-a terminat, apare o bandă verde „Sync Complete" împreună cu durata.
  3. Cardul de sumar de mai jos arată două coloane de contoare:
Packages Books
Created 2 17
Updated 1 4
Unchanged 38 412
Total 41 433
  1. Comutatorul View Details extinde sumarul într-o defalcare completă, câmp cu câmp:
  2. Pachetele și cărțile noi sunt listate cu nume și ISBN/SKU.
  3. Pentru rândurile actualizate, vedeți câmpul care s-a schimbat și valoarea anterioară (ex. „title schimbat din 'Vechi titlu' în 'Titlu nou'").

Când o sincronizare eșuează

Dacă ceva merge prost (eroare de rețea, credențiale EDG expirate, librăria a returnat un răspuns neașteptat etc.) pagina afișează o casetă de alertă roșie cu mesajul de eroare, iar eșecul este înregistrat în istoricul de sincronizare.

Cele mai comune cauze:

  • Credențiale lipsă sau greșite pentru librărie — verificați variabilele de mediu de producție MAGENTO_API_URL, MAGENTO_API_USERNAME și MAGENTO_API_PASSWORD.
  • Librăria nu poate fi accesată — site-ul EDG poate fi în pană sau în mentenanță. Așteptați câteva minute și încercați din nou.

O sincronizare eșuată lasă catalogul LexiScor exact așa cum era înainte de încercare, deci reîncercarea este mereu sigură.

După o sincronizare

  • Reîncărcați Tabloul de bord ca să vedeți noile pachete și cărți apărând.
  • Pentru orice carte nouă, ar trebui acum să pregătiți și să importați un test — vezi Import teste din Excel.
  • Dacă clasa, modulul sau pachetele unei cărți s-au schimbat, filtrele și gruparea din tabloul de bord vor reflecta noile valori imediat.

Cât de des să rulați o sincronizare?

În prezent nu există un program automat — fiecare sincronizare este declanșată manual din această pagină. Ca regulă generală:

  • Rulați una înainte de a pregăti un lot de importuri de teste pentru un nou modul școlar, ca ISBN-urile potrivite să fie prezente.
  • Rulați una după ce echipa librăriei confirmă o modificare în catalog.
  • O sincronizare săptămânală în timpul anului școlar este suficientă pentru întreținere de rutină.