Skip to content

LexiScor — User Manual

Welcome to the LexiScor user manual. This is the official handoff documentation describing what the application does, what features are available, and how to use them. It is written for editors, content managers, and program owners — no programming background is required.

If you are a developer looking for technical implementation notes, see /docs/features and CLAUDE.md instead.

What is LexiScor?

LexiScor is a reading-comprehension quiz platform built around the Editura Gama catalog of children's books. Each book has an associated quiz; pupils take the quiz, get an instant score, and — if they pass — they can claim a personalised diploma by email.

There are two sides to the application:

  • Public side — used by pupils and parents. No login required to take a quiz. URLs are based on the book's ISBN so they can be printed in books or shared as links.
  • Admin side — used by Editura Gama staff to manage books, import quizzes from Excel, monitor results, and synchronise the catalog with the EDG Magento bookstore.

How to read this manual

The manual is split into short topic-based files. Read them in order if you are new, or jump straight to the topic you need.

Getting started

  1. Overview & key concepts — what books, quizzes, attempts and packages mean in LexiScor.
  2. Signing in to the admin area — how the OTP login works.

The admin area

  1. Admin navigation & layout — what every menu item does.
  2. Dashboard — the book-centric homepage with filters and summary statistics.
  3. Books — listing books and the per-book detail page with all quiz versions.
  4. Quizzes — viewing a quiz, light text edits, publishing, and the answer-shuffle toggle.
  5. Importing quizzes from Excel — the format the spreadsheet must follow and how the bulk import flow works.
  6. Magento sync — pulling books and packages from the EDG bookstore.
  7. Tracking attempts — filtering, statistics, CSV export.
  8. Managing administrators — superadmin-only.

The public side

  1. The public quiz experience — landing page, taking a quiz, seeing the result, claiming a diploma.

Reference

  1. FAQ & day-to-day tips — recurring questions and small but important behaviours.
  2. Glossary — short definitions for every term used in the app.

A note on screenshots

Screenshots are not embedded in this manual. The interface text changes frequently as new features land, and embedded screenshots quickly become misleading. Where the manual mentions a button label or a section title, the wording matches what is actually shown in the UI at the time of writing. If you find a discrepancy, the live UI is the source of truth.

The Lexiscor brand assets used in the application live under /public/logos/lexiscor and the brand guidelines are in /docs/design/lexiscor-brand-guidelines.md.