🎮 The app that turns CEB prep into an epic adventure for the kids!

The Certificat d'Études de Base (CEB) is the official certificate marking the end of primary school in French-speaking Belgium. It is awarded after a national external exam taken by pupils, usually around age 12 (the end of 6th primary year). The exam covers French (reading and writing), mathematics, and "éveil" (history, geography and science), and is administered over several days in June.

A solid CEB result is the gateway to secondary education, which is why families often spend the months beforehand practising with past papers. This project turns that practice into a game.

An interactive quiz application to train for the Certificat d'Études de Base (CEB) exams of French-speaking Belgium. Based on the official questionnaires from previous years (2022, 2023, 2024, 2025), it gamifies learning to make revisions fun and effective for the child preparing the exam.

⚠️ Local application only — no online deployment planned.

The official CEB covers French, mathematics and "éveil" (history/geography + science). This app currently focuses on the three subjects that can be auto-graded from the past papers:

• Format: YAML
• Source: CEB 2022, 2023, 2024, 2025 (questionnaires in /docs)
• Years are mixed — no per-year selection
• Encoding done by AI from the official PDFs

334 questions across 3 files:

Distribution per exam year: 2022 (55), 2023 (72), 2024 (45), 2025 (162).

Each YAML file starts with a top-level questions: key holding a list of entries. Typical structure:

questions:
  - id: sci_2024_01
    year: 2024
    subject: sciences
    type: qcm_multiple
    points: 2
    question: "Which of these are human senses? (Several answers)"
    choices:
      - label: "Smell"
        correct: true
      - label: "Breathing"
        correct: false
    explanation: "Explanation shown after answering"

• Score displayed at the end of a session (X/20)
• Success percentage

• Real-time counter visible during the session
• Resets to zero on a wrong answer
• Rewarded with XP bonuses and badges

XP gains:

Level tiers:

14 badges across 4 categories, seeded by app:init-game.

Progression:

• 🥇 First step — Complete your first session
• 📅 CEB 2022 completed — Answer all CEB 2022 questions
• 📅 CEB 2023 completed — Answer all CEB 2023 questions
• 📅 CEB 2024 completed — Answer all CEB 2024 questions
• 📅 CEB 2025 completed — Answer all CEB 2025 questions

Performance:

• 💯 Flawless — 20/20 on a session
• 🌟 Excellent — 18/20 or more on a session
• 💪 Persistent — Complete 10 sessions in total

Streak:

• 🔥 On fire — Streak of 5 consecutive correct answers
• ⚡ Unstoppable — Streak of 10
• 🤖 Machine — Streak of 20

Per subject:

• 🔢 Math whiz — 90%+ on a Math session
• 🏛️ Historian — 90%+ on a History/Geography session
• 🔬 Scientist — 90%+ on a Science session

• Personalized welcome message for the child
• Current level + XP bar
• Current streak
• "Start a session" button
• Latest badges earned
• Progress summary per subject

• Mode selection:
  • By subject: Math, History/Geography, Science
  • Random mix: A bit of everything
• 20 questions per session (fixed), drawn at random
• Already-answered questions are excluded until the bank runs out
• Years are mixed (no per-year filter)

• One question per step
• Progress indicator (question 3/20)
• Current streak visible in real time
• Immediate feedback after each validated answer
• Explanation shown if available
• "Next question" button

• Final score (X/20)
• XP earned + animation on level up
• Badges unlocked during the session
• Recap of the 20 answers

• History of all sessions
• All badges (earned 🔓 and locked 🔒)
• Statistics per subject

Hidden nods to the kids' favorite games:

• 🎮 Call of Duty Black Ops — References to the prestige system, "killstreak"-style messages for correct-answer runs, CoD-inspired badge names ("First Blood"...)
• 🧱 Roblox — References and nods scattered through the encouragement texts and the interface

Files in /docs:

• questionnaires-ceb-2022.pdf
• questionnaires-ceb-2023.pdf
• questionnaires-ceb-2024.pdf
• questionnaires-ceb-2025.pdf

• Symfony + PHP: Installed by the developer
• MySQL: Docker (set up by the developer)
• Frontend dependencies: Asset Mapper + ImportMap (no npm/Webpack)

make run                                # Docker + Symfony server
make tailwind                           # Tailwind watch mode
make abort                              # Stop everything
make test                               # Run PHPUnit tests
make stan                               # Run PHPStan static analysis
php bin/console app:init-game           # Seed player + 14 badges (idempotent)
php bin/console app:init-game --reset   # Reset everything

• PHPUnit 13 — fast, database-free unit tests under tests/ (make test)
• PHPStan level 7 static analysis (make stan)

Functional tests for badges, Doctrine repositories and controllers require a test database and are not included yet.

"The CEB is like a final boss... But with CEB Tactical Operations, the kids have the cheat code!" 💪🎮