# bbseif/unt architecture

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

- Interactive diagram: https://gitdiagram.com/bbseif/unt
- Repository: https://github.com/bbseif/unt

## Overview

This repository is a Spring microservices application for registering users and questions, serving randomized tests, calculating submitted scores, and persisting results. The main workflow runs from a test client through the test service, which fetches questions, calculates a score, and publishes a result for the result service to save. Question and user registration are separate branches. The tree also includes an API gateway and Eureka server, but their routing and discovery relationships are not established by the available excerpts.

Main entry points: [`question-service/src/main/java/kz/prog/service/QuestionService.java`](https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/service/QuestionService.java) (Question service), [`test-service/src/main/java/kz/prog/TestController.java`](https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/TestController.java) (Test endpoints), [`test-service/src/main/java/kz/prog/service/TestResultCalculator.java`](https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/service/TestResultCalculator.java) (Score calculator), [`test-service/src/main/java/kz/prog/service/TestResultPublisher.java`](https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/service/TestResultPublisher.java) (Result publisher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and discovery"]
  node_gateway["API gateway"]
  node_registry["Eureka registry"]
end

subgraph group_identity["User registration"]
  node_user_api["User endpoints"]
  node_user_service["User registration<br/>[UserService.java]"]
  node_user_store[("User repository")]
  node_user_model["User model<br/>[User.java]"]
end

subgraph group_questions["Question bank"]
  node_question_api["Question endpoints"]
  node_question_service["Question service"]
  node_question_store[("Question repository")]
  node_answer_store[("Answer repository")]
  node_question_model["Question model<br/>[Question.java]"]
  node_answer_model["Answer model<br/>[Answer.java]"]
  node_registration_request["Question request"]
end

subgraph group_testing["Test workflow"]
  node_test_api["Test endpoints"]
  node_test_service["Question selection<br/>[TestService.java]"]
  node_question_client["Question HTTP client"]
  node_calculator["Score calculator"]
  node_submission["Test submission"]
  node_test_result["Test result<br/>[TestResult.java]"]
  node_publisher["Result publisher"]
end

subgraph group_results["Result persistence"]
  node_result_consumer["Result consumer"]
  node_result_service["Result service<br/>[ResultService.java]"]
  node_result_store[("Results repository")]
  node_result_model["Persisted results<br/>[Results.java]"]
end

node_client(("Client"))
node_broker["Message broker"]

node_client -.->|"registers"| node_user_api
node_user_api -->|"delegates to"| node_user_service
node_user_service -->|"saves user"| node_user_store
node_client -.->|"manages questions"| node_question_api
node_question_api -->|"delegates to"| node_question_service
node_question_service -->|"reads and writes"| node_question_store
node_question_service -->|"reads and writes"| node_answer_store
node_question_service -->|"builds questions"| node_question_model
node_question_service -->|"builds answers"| node_answer_model
node_question_service -->|"accepts request"| node_registration_request
node_test_api -->|"selects questions"| node_test_service
node_test_service -->|"fetches questions"| node_question_client
node_question_client -->|"requests questions"| node_question_api
node_client -.->|"requests test"| node_test_api
node_test_api -->|"calculates score"| node_calculator
node_test_api -->|"publishes result"| node_publisher
node_test_api -->|"accepts submission"| node_submission
node_calculator -->|"gets answers"| node_question_client
node_calculator -->|"produces result"| node_test_result
node_publisher -->|"serializes result"| node_test_result
node_publisher -.->|"sends message"| node_broker
node_broker -.->|"delivers message"| node_result_consumer
node_result_consumer -->|"saves result"| node_result_service
node_result_service -->|"persists results"| node_result_store
node_result_service -->|"stores model"| node_result_model

click node_gateway "https://github.com/bbseif/unt/blob/main/api-gateway/src/main/java/kz/prog/ApiGatewayApplication.java"
click node_registry "https://github.com/bbseif/unt/blob/main/eureka-server/src/main/java/kz/prog/EurekaServerApplication.java"
click node_user_api "https://github.com/bbseif/unt/blob/main/user-service/src/main/java/kz/prog/UserController.java"
click node_user_service "https://github.com/bbseif/unt/blob/main/user-service/src/main/java/kz/prog/UserService.java"
click node_user_store "https://github.com/bbseif/unt/blob/main/user-service/src/main/java/kz/prog/UserRepository.java"
click node_user_model "https://github.com/bbseif/unt/blob/main/user-service/src/main/java/kz/prog/User.java"
click node_question_api "https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/QuestionController.java"
click node_question_service "https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/service/QuestionService.java"
click node_question_store "https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/repository/QuestionRepository.java"
click node_answer_store "https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/repository/AnswerRepository.java"
click node_question_model "https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/entity/Question.java"
click node_answer_model "https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/entity/Answer.java"
click node_registration_request "https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/entity/QuestionRegistrationRequest.java"
click node_test_api "https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/TestController.java"
click node_test_service "https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/service/TestService.java"
click node_question_client "https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/service/QuestionServiceClient.java"
click node_calculator "https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/service/TestResultCalculator.java"
click node_submission "https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/entity/TestSubmission.java"
click node_test_result "https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/entity/TestResult.java"
click node_publisher "https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/service/TestResultPublisher.java"
click node_result_consumer "https://github.com/bbseif/unt/blob/main/result-service/src/main/java/kz/prog/service/TestResultConsumer.java"
click node_result_service "https://github.com/bbseif/unt/blob/main/result-service/src/main/java/kz/prog/service/ResultService.java"
click node_result_store "https://github.com/bbseif/unt/blob/main/result-service/src/main/java/kz/prog/repository/ResultRepository.java"
click node_result_model "https://github.com/bbseif/unt/blob/main/result-service/src/main/java/kz/prog/entity/Results.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,node_registry,node_client toneBlue
class node_user_api,node_user_service,node_user_store,node_user_model toneAmber
class node_question_api,node_question_service,node_question_store,node_answer_store,node_question_model,node_answer_model,node_registration_request toneMint
class node_test_api,node_test_service,node_question_client,node_calculator,node_submission,node_test_result,node_publisher toneRose
class node_result_consumer,node_result_service,node_result_store,node_result_model,node_broker toneIndigo
```

## Components

### Access and discovery

- [API gateway](https://github.com/bbseif/unt/blob/main/api-gateway/src/main/java/kz/prog/ApiGatewayApplication.java): `api-gateway/src/main/java/kz/prog/ApiGatewayApplication.java`
- [Eureka registry](https://github.com/bbseif/unt/blob/main/eureka-server/src/main/java/kz/prog/EurekaServerApplication.java): `eureka-server/src/main/java/kz/prog/EurekaServerApplication.java`

### User registration

- [User endpoints](https://github.com/bbseif/unt/blob/main/user-service/src/main/java/kz/prog/UserController.java): `user-service/src/main/java/kz/prog/UserController.java`
- [User registration](https://github.com/bbseif/unt/blob/main/user-service/src/main/java/kz/prog/UserService.java): `user-service/src/main/java/kz/prog/UserService.java`
- [User repository](https://github.com/bbseif/unt/blob/main/user-service/src/main/java/kz/prog/UserRepository.java): `user-service/src/main/java/kz/prog/UserRepository.java`
- [User model](https://github.com/bbseif/unt/blob/main/user-service/src/main/java/kz/prog/User.java): `user-service/src/main/java/kz/prog/User.java`

### Question bank

- [Question endpoints](https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/QuestionController.java): `question-service/src/main/java/kz/prog/QuestionController.java`
- [Question service](https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/service/QuestionService.java): `question-service/src/main/java/kz/prog/service/QuestionService.java`
- [Question repository](https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/repository/QuestionRepository.java): `question-service/src/main/java/kz/prog/repository/QuestionRepository.java`
- [Answer repository](https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/repository/AnswerRepository.java): `question-service/src/main/java/kz/prog/repository/AnswerRepository.java`
- [Question model](https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/entity/Question.java): `question-service/src/main/java/kz/prog/entity/Question.java`
- [Answer model](https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/entity/Answer.java): `question-service/src/main/java/kz/prog/entity/Answer.java`
- [Question request](https://github.com/bbseif/unt/blob/main/question-service/src/main/java/kz/prog/entity/QuestionRegistrationRequest.java): `question-service/src/main/java/kz/prog/entity/QuestionRegistrationRequest.java`

### Test workflow

- [Test endpoints](https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/TestController.java): `test-service/src/main/java/kz/prog/TestController.java`
- [Question selection](https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/service/TestService.java): `test-service/src/main/java/kz/prog/service/TestService.java`
- [Question HTTP client](https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/service/QuestionServiceClient.java): `test-service/src/main/java/kz/prog/service/QuestionServiceClient.java`
- [Score calculator](https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/service/TestResultCalculator.java): `test-service/src/main/java/kz/prog/service/TestResultCalculator.java`
- [Test submission](https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/entity/TestSubmission.java): `test-service/src/main/java/kz/prog/entity/TestSubmission.java`
- [Test result](https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/entity/TestResult.java): `test-service/src/main/java/kz/prog/entity/TestResult.java`
- [Result publisher](https://github.com/bbseif/unt/blob/main/test-service/src/main/java/kz/prog/service/TestResultPublisher.java): `test-service/src/main/java/kz/prog/service/TestResultPublisher.java`

### Result persistence

- [Result consumer](https://github.com/bbseif/unt/blob/main/result-service/src/main/java/kz/prog/service/TestResultConsumer.java): `result-service/src/main/java/kz/prog/service/TestResultConsumer.java`
- [Result service](https://github.com/bbseif/unt/blob/main/result-service/src/main/java/kz/prog/service/ResultService.java): `result-service/src/main/java/kz/prog/service/ResultService.java`
- [Results repository](https://github.com/bbseif/unt/blob/main/result-service/src/main/java/kz/prog/repository/ResultRepository.java): `result-service/src/main/java/kz/prog/repository/ResultRepository.java`
- [Persisted results](https://github.com/bbseif/unt/blob/main/result-service/src/main/java/kz/prog/entity/Results.java): `result-service/src/main/java/kz/prog/entity/Results.java`

### Other components

- **Client**
- **Message broker**

## Connections

- Client → User endpoints: registers
- User endpoints → User registration: delegates to (evidence: `user-service/src/main/java/kz/prog/UserController.java`)
- User registration → User repository: saves user (evidence: `user-service/src/main/java/kz/prog/UserService.java`)
- Client → Question endpoints: manages questions
- Question endpoints → Question service: delegates to (evidence: `question-service/src/main/java/kz/prog/QuestionController.java`)
- Question service → Question repository: reads and writes (evidence: `question-service/src/main/java/kz/prog/service/QuestionService.java`)
- Question service → Answer repository: reads and writes (evidence: `question-service/src/main/java/kz/prog/service/QuestionService.java`)
- Question service → Question model: builds questions (evidence: `question-service/src/main/java/kz/prog/service/QuestionService.java`)
- Question service → Answer model: builds answers (evidence: `question-service/src/main/java/kz/prog/service/QuestionService.java`)
- Question service → Question request: accepts request (evidence: `question-service/src/main/java/kz/prog/service/QuestionService.java`)
- Test endpoints → Question selection: selects questions (evidence: `test-service/src/main/java/kz/prog/TestController.java`)
- Question selection → Question HTTP client: fetches questions (evidence: `test-service/src/main/java/kz/prog/service/TestService.java`)
- Question HTTP client → Question endpoints: requests questions (evidence: `test-service/src/main/java/kz/prog/service/QuestionServiceClient.java`)
- Client → Test endpoints: requests test
- Test endpoints → Score calculator: calculates score (evidence: `test-service/src/main/java/kz/prog/TestController.java`)
- Test endpoints → Result publisher: publishes result (evidence: `test-service/src/main/java/kz/prog/TestController.java`)
- Test endpoints → Test submission: accepts submission (evidence: `test-service/src/main/java/kz/prog/TestController.java`)
- Score calculator → Question HTTP client: gets answers (evidence: `test-service/src/main/java/kz/prog/service/TestResultCalculator.java`)
- Score calculator → Test result: produces result (evidence: `test-service/src/main/java/kz/prog/service/TestResultCalculator.java`)
- Result publisher → Test result: serializes result (evidence: `test-service/src/main/java/kz/prog/service/TestResultPublisher.java`)
- Result publisher → Message broker: sends message
- Message broker → Result consumer: delivers message
- Result consumer → Result service: saves result (evidence: `result-service/src/main/java/kz/prog/service/TestResultConsumer.java`)
- Result service → Results repository: persists results (evidence: `result-service/src/main/java/kz/prog/service/ResultService.java`)
- Result service → Persisted results: stores model (evidence: `result-service/src/main/java/kz/prog/service/ResultService.java`)
