🧠 Smart AI-Based Quiz Generator

AI-Powered Quiz Platform built with Spring Boot Microservices

AI-powered quiz generation platform built using Spring Boot Microservices, Spring AI, RabbitMQ, and Keycloak Authentication.

---

📖 Overview

Smart AI-Based Quiz Generator is a scalable backend system that automatically generates quizzes using Artificial Intelligence.

The platform demonstrates modern backend architecture used in production systems, including:

• Microservices architecture
• Event-driven communication
• AI integration
• Secure authentication
• Cloud-native service design

---

🚀 Features

🤖 AI Quiz Generation

• Dynamically generates quiz questions using Spring AI
• Topic-based quiz creation
• Automated question generation
• Intelligent quiz building

---

🔐 Secure Authentication

• Keycloak OAuth2 authentication
• JWT-based request validation
• Role-based access control (RBAC)

---

⚡ Event-Driven Architecture

• RabbitMQ messaging
• Asynchronous communication between microservices
• Decoupled and scalable system design

---

☁️ Cloud-Native Design

• Spring Cloud Gateway
• Service Discovery using Eureka
• Centralized Configuration with Config Server

---

🏗️ System Architecture

---

📊 Quiz Generation Workflow

---

🧱 Microservices

🌐 API Gateway

Acts as the single entry point for all client requests.

Responsibilities:

• Routing client requests
• JWT token validation
• Forwarding requests to appropriate microservices

---

📝 Quiz Service

Handles:

• Quiz creation
• Quiz management
• Fetching quizzes
• Quiz metadata management

---

📂 Category Service

Responsible for:

• Managing quiz categories
• Organizing quiz topics
• Category-based classification

---

🤖 Question Generator Service

Handles AI integration.

Responsibilities:

• Integrates Spring AI
• Dynamically generates quiz questions
• Communicates asynchronously via RabbitMQ

---

🧭 Service Registry

Implemented using Eureka.

• Registers all microservices
• Enables dynamic service discovery

---

⚙️ Config Server

Provides centralized configuration management for all microservices.

---

🧰 Tech Stack

Layer	Technology
Backend	Java 21, Spring Boot
Architecture	Microservices
Cloud	Spring Cloud
Service Discovery	Eureka
API Gateway	Spring Cloud Gateway
Messaging	RabbitMQ
AI Integration	Spring AI
Security	Keycloak OAuth2
Build Tool	Maven

---

📂 Project Structure

Smart-AI-Based-Quiz-Generator
│
├── api-gateway
├── category-service
├── quiz-service
├── questions-generator
├── config-server
├── service-registry
│
└── README.md

---

🔐 Authentication Flow

1️⃣ User logs in via Keycloak

2️⃣ Keycloak generates a JWT token

3️⃣ Client sends the token with API requests

4️⃣ API Gateway validates the token

5️⃣ Request is routed to the appropriate microservice

---

📡 Service Communication

🔹 Synchronous Communication

• REST APIs between microservices

🔹 Asynchronous Communication

• RabbitMQ queues
• Event-driven messaging between services

---

▶️ Running the Project

1️⃣ Clone Repository

git clone https://github.com/GiriGourav/Smart-AI-Based-Quiz-Generator.git

---

2️⃣ Navigate to Project

cd Smart-AI-Based-Quiz-Generator

---

3️⃣ Start Infrastructure Services

Start these services first:

config-server
service-registry

---

4️⃣ Start Microservices

category-service
quiz-service
questions-generator

---

5️⃣ Start API Gateway

api-gateway

---

📈 Future Improvements

• Docker containerization
• Kubernetes deployment
• Redis caching
• Distributed tracing (Zipkin / Sleuth)
• CI/CD pipeline
• Frontend dashboard
• API documentation using Swagger / OpenAPI

---

👨‍💻 Author

Gourav Giri

Backend Developer
Java • Spring Boot • Microservices

GitHub:
https://github.com/GiriGourav

---

⭐ Support

If you find this project useful, please star the repository ⭐

---

📜 License

This project is licensed under the MIT License.