CodeKings LEVEL UP YOUR LEARNING

🚀 Getting Started

Welcome! This guide will walk you through setting up and running your learning environment from scratch.
Whether you're an Admin or Program Lead, the steps are nearly identical, with Admins having full system control.
Here's the basic order of operations to build a full course pipeline:

Create a Program — Your top-level structure. (Admins only)
Create Courses within that Program.
Add Modules under each Course — these are the main teaching units.
Create Lessons inside each Module using the rich content editor.
Generate Quizzes to assess progress and trigger achievements.
Monitor Analytics and fine-tune based on real engagement.

Students will automatically see their program content, quizzes, streaks, and achievements in their dashboard.

📅 1. Creating a Program

Only Admins have permission to create new Programs.
Navigate to the Admin Panel, then click Program Manager.
Click “Create Program”, enter a name, and assign it to your Institution.
After creation, Admins can assign Program Leads who will manage content.

📄 2. Creating a Course

Accessible via both Admin and Program Lead dashboards.
Start in the Course & Module Builder panel.
Click “Create Course”, name it, and link it to a Program. Each Program can contain multiple Courses.
Add Modules under your course. These represent key teaching units.

📂 3. Creating Modules

Modules go under each Course and represent major topics or categories.
Click “Manage Lessons” inside a Module to begin building content steps.
You can add end-of-topic quizzes with pass thresholds (e.g., 7/10).
Modules can be made public to share with the community.

📖 4. Lesson Builder

Click “Add Lessons” in a module to get started.
The rich text editor (TinyMCE) supports formatting, media, LaTeX, HTML, and code blocks.
Lessons can be locked to enforce sequential progress or quiz completion.
You can embed links or buttons that lead to quizzes you've generated. Students will also receive in-app notifications.

Example:

<p><a class="quiz-button" href="generated_quizzes/quiz_41_level_2_computing_end_of_topic_html_quiz.php" target="_blank" rel="noopener">Take the HTML Basics Quiz!</a></p>

🎓 5. Quiz System

Use the Quiz Generator to create quizzes for any module.
Choose between:
- Manual question creation
- AI-powered question generation

New Question Types Supported:
- Multiple Choice (MCQ): Classic single-answer multiple choice with answers randomized per attempt.
- Short Text: Students type answers evaluated with fuzzy matching, allowing minor typos and synonyms.
- Fill-in-the-Blank: Phrase completion with lenient fuzzy grading similar to short text.

FuzziMatch™ Grading Algorithm:
- Utilizes approximate string matching (like Levenshtein distance) to compare answers.
- Allows small spelling errors, grammatical differences, and acceptable synonyms or word substitutions (e.g., "build" vs "create").
- This leniency improves fairness while maintaining assessment integrity.

Quiz Types:
- 📅 Daily Quizzes: One per program. Shown on the dashboard. Encourages streaks.
- 🔥 Achievement Quizzes: Tied to EXP, badges, and level progression.
- 📚 Regular Quizzes: Embedded into modules/courses.
- ⚔️ Gauntlet Mode: A unique, high-risk format with these rules:
  - 3 attempts max per day
  - Costs Achievement Points (AP)
  - One mistake ends the run
  - Time-limited questions
  - Each mode must be created separately
  - Modes include:
    - Easy (20s/question)
    - Medium (30s)
    - Hard (40s)
    - Mixed (30s, random difficulty)
    - 1v1 (coming soon)
Scoping:
- Daily & Gauntlet: Program level
- Regular & Achievement: Course/module level