Quizzler Backend

The Quizzler Backend is a microservices-based backend system for the Quizzler quiz platform. It is designed for scalability, modularity, and ease of integration, supporting a wide range of quiz, user, and leaderboard features.

Architecture Overview

This repository contains the following core services:

• API Gateway: Central entry point for all client requests, routing, and cross-cutting concerns.
• Service Registry: Service discovery and registration for all microservices.
• User Auth Service: Handles user authentication, registration, and authorization.
• Question Service: Manages quiz questions and their types.
• Quiz Service: Manages quizzes, quiz creation, and assignment of questions.
• Participation Service: Tracks user participation, attempts, and scores.
• LeaderBoard Service: Aggregates and displays user rankings.
• BugReport Service: Handles bug reporting and management.
• Docker-kafka: Contains Docker Compose setup for Kafka and related infrastructure.

Quick links to service READMEs

Each service has its own directory and detailed README.

Getting Started

Prerequisites

• Java 17 or higher
• Maven 3.6+
• Docker & Docker Compose (for running infrastructure)

Running the System

1. Clone the repository

   git clone https://github.com/Quizzler-Co/Quizzler_final_backend.git
   cd Quizzler_final_backend

2. Start infrastructure (Kafka, etc.)

   cd Docker-kafka
   docker-compose up -d

3. Build and run each service

   cd <service-folder>
   ./mvnw clean install
   ./mvnw spring-boot:run

   Or use Docker Compose if available.

Repository Structure

Quizzler_final_backend/
├── api-gateway/
├── BugReport-service/
├── LeaderBoard/
├── participation-service/
├── question-service/
├── Quiz/
├── service-registry/
├── user-auth/
├── Docker-kafka/
└── README.md

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit your changes
4. Open a pull request

License

This project is licensed under the MIT License.