Skip to content

1. Overview & Key Concepts

Before diving into individual screens it helps to understand the few core concepts the application is built around. They appear everywhere in the UI and in the rest of this manual.

The "object model" — five things you will hear about

1. Book

The central object. Every book in LexiScor mirrors a real book in the Editura Gama catalog. A book is identified by its ISBN (the same number printed on the back cover). Each book carries:

  • title, cover image, description
  • a class (Romanian "clasa" — Pregătitoare, I, II, III, …)
  • a module (the school period: 1, 2, 3, Vacanța de vară, …)
  • a points value used by the wider Editura Gama loyalty programme
  • the packages the book belongs to (see below)

Books are not created by hand inside LexiScor. They are pulled in from the EDG Magento bookstore by the Magento sync.

2. Package

A package is a marketing/curriculum bundle from the EDG bookstore — for example "Clasa I — Module 1". A book can belong to one or more packages. Packages are used in the dashboard to group books in a way that mirrors how they are sold and used in the classroom.

Like books, packages are pulled in by the Magento sync and not created manually.

3. Quiz

A quiz belongs to exactly one book. It is a list of multiple-choice questions, each with two or more answers and exactly one correct answer. Each question has a point value (defaults to 1).

Important rules to keep in mind:

  • A book can have many quiz versions (v1, v2, v3 …). Only one quiz can be published at a time per book — that is the one the public sees.
  • Older versions stay around for historical reference and so existing attempts remain meaningful.
  • Quizzes are always created via Excel import — there is no longer a "create quiz from scratch" button inside the admin. See Importing quizzes from Excel.
  • A quiz can be in one of three states: draft, published, or archived.

4. Attempt

When a pupil takes a quiz, the system records an attempt. An attempt captures who took it (name, optional email), which answers were chosen, the score, the duration, and whether the pupil passed or ran out of time.

Attempts feed the Attempts page — that is where you go to see who has taken what, average scores, pass rates, and to export data for reporting.

5. Administrator

Every action in the admin area is performed by an administrator. Two roles exist:

  • admin — can do everything in this manual except manage other administrators.
  • superadmin — can additionally add and remove administrator accounts via the Admins page.

Administrators sign in with a one-time code sent to their email. There are no passwords to remember or reset.

How a quiz lifecycle looks in practice

A typical end-to-end story for a single book:

  1. The book is added to the EDG Magento bookstore (outside LexiScor).
  2. An administrator clicks Start Sync on the Magento Sync page. LexiScor now knows about the book and the packages it belongs to.
  3. An administrator prepares an Excel file with the quiz questions, answers and scores, then uploads it on the Import page. The first quiz version (v1) is created in draft status.
  4. The administrator opens the quiz from the Books page, fixes any typos inline (the only kind of edit that does not require re-importing), and clicks Publish when ready.
  5. The book's public URL — /book/<isbn> — now serves the quiz to anyone who visits it. The link can be printed in the book or shared online.
  6. As pupils take the quiz, attempts accumulate. The dashboard shows an attempt counter; the Attempts page lets you slice and dice the data.
  7. If the questions need to change later, the administrator imports a new Excel file. A new version (v2) is created. When v2 is published, v1 is automatically retired but stays available for reference.

Light editing vs. structural changes

This is the single most important distinction to internalise:

Change Allowed inline Requires Excel re-import
Fix a typo in a question ✅ —
Fix a typo in an answer ✅ —
Toggle answer shuffling ✅ —
Add or remove a question — ✅
Add or remove an answer — ✅
Change which answer is correct — ✅
Change a question's score — ✅
Reorder questions — ✅

The rationale is fairness: once even one pupil has taken a quiz, changing its structure would invalidate their score. Inline text fixes are safe because they don't change the meaning of any answer.

Where to go next

  • If you have never logged in before, continue with Signing in.
  • Otherwise, the Admin navigation page gives a one-line summary of every menu item and links to the detailed chapter for each.