A distributed quiz management system for schools and training environments — enabling teachers to create, manage, and distribute exams over LAN with real-time monitoring.

• About The Project
• Features
• Tech Stack
• Architecture Overview
• Screenshots
• Getting Started
• Usage
• License

Quizz is a Java-based client-server application designed to simplify the process of organizing and managing multiple-choice exams in educational environments.

The system allows teachers to:

• Create and manage question banks
• Organize exams across multiple subjects
• Distribute tests to students over LAN
• Monitor submissions and analyze results

Built as a lightweight, cross-platform desktop system, Quizz focuses on reliability, simplicity, and efficient exam management without requiring internet connectivity.

• 📚 Multiple workspaces for different classes or use cases
• 📝 Exam management (with question shuffling)
• 👨‍🎓 Student & group management
• 📊 Submission tracking and monitoring
• 📂 Subject & question bank organization
• 🌐 Distribute exams via LAN

• 🧑 Join exams using server IP + port
• ⏱️ Take exams in a controlled environment
• 📤 Submit answers directly to server

The system consists of two main components:

• Centralized exam management system
• Handles:
  • Question banks
  • Exam generation
  • Student tracking
  • Submission storage
• Connects to MySQL/MariaDB database

• Lightweight application for students
• Connects to server via IP + port
• Provides exam interface and submission flow

• Java 17+
• MySQL or MariaDB

Check Java version:

java -version

-- Default configuration
Username: root
Password: 123456789
Host: localhost
Port: 3306

1. Start MySQL/MariaDB

2. Run the SQL script:

   QuizzServerInitTableMySQL.sql
   

3. This will initialize the required database schema

Download pre-built binaries from: 👉 https://github.com/ttasc/Quizz/releases

Requirements:

• Java 17
• Maven

git clone https://github.com/ttasc/Quizz.git
cd Quizz

Build Server:

cd QuizzServer
mvn package

Build Client:

cd QuizzClient
mvn package

Output:

• QuizzServer.jar
• QuizzClient.jar

java -jar QuizzServer.jar

• Ensure database is running before starting server

java -jar QuizzClient.jar

• Enter:

  • Student ID
  • Server IP
  • Port

This project is currently not licensed. You may consider adding an MIT License for open-source usage.

• Java & open-source ecosystem
• MySQL / MariaDB community

💡 This project demonstrates practical experience in building distributed desktop systems, database-driven applications, and LAN-based communication for real-world educational use cases.