# chaitanyag5/quiz-microservices architecture

> Architecture diagram of the GitHub repository chaitanyag5/quiz-microservices, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chaitanyag5/quiz-microservices
- Repository: https://github.com/chaitanyag5/quiz-microservices

## Overview

This is a Spring-based quiz application split into an API gateway, quiz service, question service, and service registry. Users create a quiz, retrieve its questions, and submit answers for scoring; the quiz service delegates question selection, retrieval, and scoring to the question service over Feign. Question management also exposes listing, category filtering, and adding questions. The excerpts show service and persistence responsibilities, but not gateway routes, registry configuration, or database wiring, so those connections are omitted.

Main entry points: [`quiz-service/src/main/java/com/chaitanya/quizservice/service/QuizService.java`](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/service/QuizService.java) (Quiz workflows), [`question-service/src/main/java/com/chaitanya/questionservice/service/QuestionService.java`](https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/service/QuestionService.java) (Question workflows), [`quiz-service/src/main/java/com/chaitanya/quizservice/controller/QuizController.java`](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/controller/QuizController.java) (Quiz API), [`quiz-service/src/main/java/com/chaitanya/quizservice/dao/QuizDao.java`](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/dao/QuizDao.java) (Quiz persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gateway["API gateway"]
  node_gateway_app["Gateway app"]
end

subgraph group_quiz["Quiz service"]
  node_quiz_app["Quiz app"]
  node_quiz_controller["Quiz API"]
  node_quiz_service["Quiz workflows<br/>[QuizService.java]"]
  node_quiz_dao["Quiz persistence<br/>[QuizDao.java]"]
  node_quiz_model["Quiz record<br/>[Quiz.java]"]
  node_quiz_dto["Quiz request<br/>[QuizDto.java]"]
  node_quiz_wrapper["Question view"]
  node_quiz_response["Answer payload<br/>[Response.java]"]
  node_question_client["Question client<br/>[QuizInterface.java]"]
end

subgraph group_questions["Question service"]
  node_question_app["Question app"]
  node_question_controller["Question API"]
  node_question_service["Question workflows"]
  node_question_dao["Question persistence<br/>[QuestionDao.java]"]
  node_question_model["Question record<br/>[Question.java]"]
  node_question_wrapper["Question view"]
  node_question_response["Answer payload<br/>[Response.java]"]
end

subgraph group_registry["Service registry"]
  node_registry_app["Registry app"]
end

node_user(("User"))

node_user -->|"uses quiz API"| node_quiz_controller
node_quiz_controller -->|"delegates"| node_quiz_service
node_quiz_controller -->|"accepts request"| node_quiz_dto
node_quiz_controller -->|"accepts answers"| node_quiz_response
node_quiz_service -->|"reads and saves"| node_quiz_dao
node_quiz_service -->|"creates and reads"| node_quiz_model
node_quiz_service -->|"requests questions and score"| node_question_client
node_quiz_service -->|"returns question views"| node_quiz_wrapper
node_quiz_service -->|"submits answers"| node_quiz_response
node_quiz_dao -->|"persists entity"| node_quiz_model
node_question_client -.->|"calls question endpoints"| node_question_controller
node_question_controller -->|"delegates"| node_question_service
node_question_service -->|"queries and saves"| node_question_dao
node_question_dao -->|"persists entity"| node_question_model
node_question_service -->|"reads question data"| node_question_model
node_question_service -->|"builds question views"| node_question_wrapper
node_question_service -->|"scores submitted answers"| node_question_response

click node_gateway_app "https://github.com/chaitanyag5/quiz-microservices/blob/main/api-gateway/src/main/java/com/chaitanya/apigateway/ApiGatewayApplication.java"
click node_quiz_app "https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/QuizServiceApplication.java"
click node_quiz_controller "https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/controller/QuizController.java"
click node_quiz_service "https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/service/QuizService.java"
click node_quiz_dao "https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/dao/QuizDao.java"
click node_quiz_model "https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/model/Quiz.java"
click node_quiz_dto "https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/model/QuizDto.java"
click node_quiz_wrapper "https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/model/QuestionWrapper.java"
click node_quiz_response "https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/model/Response.java"
click node_question_client "https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/feign/QuizInterface.java"
click node_question_app "https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/QuestionServiceApplication.java"
click node_question_controller "https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/controller/QuestionController.java"
click node_question_service "https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/service/QuestionService.java"
click node_question_dao "https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/dao/QuestionDao.java"
click node_question_model "https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/model/Question.java"
click node_question_wrapper "https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/model/QuestionWrapper.java"
click node_question_response "https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/model/Response.java"
click node_registry_app "https://github.com/chaitanyag5/quiz-microservices/blob/main/service-registry/src/main/java/com/chaitanya/serviceregistry/ServiceRegistryApplication.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gateway_app,node_user toneBlue
class node_quiz_app,node_quiz_controller,node_quiz_service,node_quiz_dao,node_quiz_model,node_quiz_dto,node_quiz_wrapper,node_quiz_response,node_question_client toneAmber
class node_question_app,node_question_controller,node_question_service,node_question_dao,node_question_model,node_question_wrapper,node_question_response toneMint
class node_registry_app toneRose
```

## Components

### API gateway

- [Gateway app](https://github.com/chaitanyag5/quiz-microservices/blob/main/api-gateway/src/main/java/com/chaitanya/apigateway/ApiGatewayApplication.java): `api-gateway/src/main/java/com/chaitanya/apigateway/ApiGatewayApplication.java`

### Quiz service

- [Quiz app](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/QuizServiceApplication.java): `quiz-service/src/main/java/com/chaitanya/quizservice/QuizServiceApplication.java`
- [Quiz API](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/controller/QuizController.java): `quiz-service/src/main/java/com/chaitanya/quizservice/controller/QuizController.java`
- [Quiz workflows](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/service/QuizService.java): `quiz-service/src/main/java/com/chaitanya/quizservice/service/QuizService.java`
- [Quiz persistence](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/dao/QuizDao.java): `quiz-service/src/main/java/com/chaitanya/quizservice/dao/QuizDao.java`
- [Quiz record](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/model/Quiz.java): `quiz-service/src/main/java/com/chaitanya/quizservice/model/Quiz.java`
- [Quiz request](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/model/QuizDto.java): `quiz-service/src/main/java/com/chaitanya/quizservice/model/QuizDto.java`
- [Question view](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/model/QuestionWrapper.java): `quiz-service/src/main/java/com/chaitanya/quizservice/model/QuestionWrapper.java`
- [Answer payload](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/model/Response.java): `quiz-service/src/main/java/com/chaitanya/quizservice/model/Response.java`
- [Question client](https://github.com/chaitanyag5/quiz-microservices/blob/main/quiz-service/src/main/java/com/chaitanya/quizservice/feign/QuizInterface.java): `quiz-service/src/main/java/com/chaitanya/quizservice/feign/QuizInterface.java`

### Question service

- [Question app](https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/QuestionServiceApplication.java): `question-service/src/main/java/com/chaitanya/questionservice/QuestionServiceApplication.java`
- [Question API](https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/controller/QuestionController.java): `question-service/src/main/java/com/chaitanya/questionservice/controller/QuestionController.java`
- [Question workflows](https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/service/QuestionService.java): `question-service/src/main/java/com/chaitanya/questionservice/service/QuestionService.java`
- [Question persistence](https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/dao/QuestionDao.java): `question-service/src/main/java/com/chaitanya/questionservice/dao/QuestionDao.java`
- [Question record](https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/model/Question.java): `question-service/src/main/java/com/chaitanya/questionservice/model/Question.java`
- [Question view](https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/model/QuestionWrapper.java): `question-service/src/main/java/com/chaitanya/questionservice/model/QuestionWrapper.java`
- [Answer payload](https://github.com/chaitanyag5/quiz-microservices/blob/main/question-service/src/main/java/com/chaitanya/questionservice/model/Response.java): `question-service/src/main/java/com/chaitanya/questionservice/model/Response.java`

### Service registry

- [Registry app](https://github.com/chaitanyag5/quiz-microservices/blob/main/service-registry/src/main/java/com/chaitanya/serviceregistry/ServiceRegistryApplication.java): `service-registry/src/main/java/com/chaitanya/serviceregistry/ServiceRegistryApplication.java`

### Other components

- **User**

## Connections

- User → Quiz API: uses quiz API (evidence: `quiz-service/src/main/java/com/chaitanya/quizservice/controller/QuizController.java`)
- Quiz API → Quiz workflows: delegates (evidence: `quiz-service/src/main/java/com/chaitanya/quizservice/controller/QuizController.java`)
- Quiz API → Quiz request: accepts request (evidence: `quiz-service/src/main/java/com/chaitanya/quizservice/controller/QuizController.java`)
- Quiz API → Answer payload: accepts answers (evidence: `quiz-service/src/main/java/com/chaitanya/quizservice/controller/QuizController.java`)
- Quiz workflows → Quiz persistence: reads and saves (evidence: `quiz-service/src/main/java/com/chaitanya/quizservice/service/QuizService.java`)
- Quiz workflows → Quiz record: creates and reads (evidence: `quiz-service/src/main/java/com/chaitanya/quizservice/service/QuizService.java`)
- Quiz workflows → Question client: requests questions and score (evidence: `quiz-service/src/main/java/com/chaitanya/quizservice/service/QuizService.java`)
- Quiz workflows → Question view: returns question views (evidence: `quiz-service/src/main/java/com/chaitanya/quizservice/service/QuizService.java`)
- Quiz workflows → Answer payload: submits answers (evidence: `quiz-service/src/main/java/com/chaitanya/quizservice/service/QuizService.java`)
- Quiz persistence → Quiz record: persists entity (evidence: `quiz-service/src/main/java/com/chaitanya/quizservice/dao/QuizDao.java`)
- Question client → Question API: calls question endpoints
- Question API → Question workflows: delegates (evidence: `question-service/src/main/java/com/chaitanya/questionservice/controller/QuestionController.java`)
- Question workflows → Question persistence: queries and saves (evidence: `question-service/src/main/java/com/chaitanya/questionservice/service/QuestionService.java`)
- Question persistence → Question record: persists entity (evidence: `question-service/src/main/java/com/chaitanya/questionservice/dao/QuestionDao.java`)
- Question workflows → Question record: reads question data (evidence: `question-service/src/main/java/com/chaitanya/questionservice/service/QuestionService.java`)
- Question workflows → Question view: builds question views (evidence: `question-service/src/main/java/com/chaitanya/questionservice/service/QuestionService.java`)
- Question workflows → Answer payload: scores submitted answers (evidence: `question-service/src/main/java/com/chaitanya/questionservice/service/QuestionService.java`)
