Quizzy - Complete Quiz Application

This is a complete quiz application with a React frontend and two backend options:

1. Spring Boot backend (full-featured but requires Maven)
2. Node.js mock backend (simplified but runs without build tools and persists data)

Project Structure

.
├── backend/              # Spring Boot backend with H2 database
│   ├── src/              # Java source code
│   ├── pom.xml           # Maven configuration
│   ├── build-and-run.bat # Build and run script
│   └── ...               # Other backend files
├── frontend/             # React frontend
│   ├── src/              # React components and services
│   ├── package.json      # NPM dependencies
│   └── ...               # Other frontend files
└── javafx-client/        # JavaFX desktop client (optional)

Backend

You can choose between two backend implementations:

Option 1: Spring Boot Backend (Full-Featured)

A fully functional Spring Boot application with:

• ✅ User authentication and registration (JWT)
• ✅ Role-based access control
• ✅ Quiz and question management
• ✅ Quiz attempt tracking and scoring
• ✅ Leaderboard functionality
• ✅ H2 in-memory database
• ✅ Swagger API documentation

Option 2: Node.js Mock Backend (Recommended for Demo)

A simplified backend implementation that:

• ✅ Provides all essential API endpoints
• ✅ Uses file-based persistence (data survives restarts)
• ✅ Requires no build tools
• ✅ Runs with just Node.js
• ✅ Perfect for demonstrations and testing

Backend Quick Start

For Node.js Mock Backend (RECOMMENDED):

1. Install Node.js (https://nodejs.org/)
2. Navigate to the backend directory: cd backend
3. Run: run-node-backend.bat (Windows) or npm start (Mac/Linux)
4. Access the application at: http://localhost:8080

For Spring Boot Backend:

1. Install Maven (see MAVEN-INSTALLATION-GUIDE.md)
2. Navigate to the backend directory: cd backend
3. Build and run: build-and-run.bat
4. Access the application:
   • API Documentation: http://localhost:8080/swagger-ui.html
   • H2 Console: http://localhost:8080/h2-console

Frontend

The frontend is built with React and is already complete.

Frontend Quick Start

1. Install Node.js and npm
2. Navigate to the frontend directory: cd frontend
3. Install dependencies: npm install
4. Start the development server: npm run dev

Integration

The frontend should be configured to communicate with the backend at http://localhost:8080/api.

Documentation

• QUICK-START-GUIDE.md - Get up and running quickly
• MAVEN-INSTALLATION-GUIDE.md - How to install Maven
• backend/README.md - Detailed backend documentation
• backend/SETUP-INSTRUCTIONS.md - Backend setup instructions
• backend/SUMMARY.md - Backend summary

Sample Users

After starting the backend, you can log in with:

• Admin User: admin / admin123
• Regular User: user / user123

Technologies Used

Backend

Spring Boot Version:

• Spring Boot 3.3.4
• Spring Security with JWT
• Spring Data JPA
• H2 Database
• Maven

Node.js Mock Version:

• Node.js
• Express.js
• JSON file-based persistence

Frontend

• React
• Vite
• JavaScript/JSX