How bbseif/unt works
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: QuestionService.java Question service · TestController.java Test endpoints · TestResultCalculator.java Score calculator · TestResultPublisher.java Result publisher
Components 26
Access and discovery
- API gateway
api-gateway/src/main/java/kz/prog/ApiGatewayApplication.java - Eureka registry
eureka-server/src/main/java/kz/prog/EurekaServerApplication.java
User registration
- User endpoints
user-service/src/main/java/kz/prog/UserController.java - User registration
user-service/src/main/java/kz/prog/UserService.java - User repository
user-service/src/main/java/kz/prog/UserRepository.java - User model
user-service/src/main/java/kz/prog/User.java
Question bank
- Question endpoints
question-service/src/main/java/kz/prog/QuestionController.java - Question service
question-service/src/main/java/kz/prog/service/QuestionService.java - Question repository
question-service/src/main/java/kz/prog/repository/QuestionRepository.java - Answer repository
question-service/src/main/java/kz/prog/repository/AnswerRepository.java - Question model
question-service/src/main/java/kz/prog/entity/Question.java - Answer model
question-service/src/main/java/kz/prog/entity/Answer.java - Question request
question-service/src/main/java/kz/prog/entity/QuestionRegistrationRequest.java
Test workflow
- Test endpoints
test-service/src/main/java/kz/prog/TestController.java - Question selection
test-service/src/main/java/kz/prog/service/TestService.java - Question HTTP client
test-service/src/main/java/kz/prog/service/QuestionServiceClient.java - Score calculator
test-service/src/main/java/kz/prog/service/TestResultCalculator.java - Test submission
test-service/src/main/java/kz/prog/entity/TestSubmission.java - Test result
test-service/src/main/java/kz/prog/entity/TestResult.java - Result publisher
test-service/src/main/java/kz/prog/service/TestResultPublisher.java
Result persistence
- Result consumer
result-service/src/main/java/kz/prog/service/TestResultConsumer.java - Result service
result-service/src/main/java/kz/prog/service/ResultService.java - Results repository
result-service/src/main/java/kz/prog/repository/ResultRepository.java - Persisted results
result-service/src/main/java/kz/prog/entity/Results.java
Other components
- Client
- Message broker
Connections 25
- Client → User endpoints: registers
- User endpoints → User registration: delegates to
user-service/src/main/java/kz/prog/UserController.java - User registration → User repository: saves user
user-service/src/main/java/kz/prog/UserService.java - Client → Question endpoints: manages questions
- Question endpoints → Question service: delegates to
question-service/src/main/java/kz/prog/QuestionController.java - Question service → Question repository: reads and writes
question-service/src/main/java/kz/prog/service/QuestionService.java - Question service → Answer repository: reads and writes
question-service/src/main/java/kz/prog/service/QuestionService.java - Question service → Question model: builds questions
question-service/src/main/java/kz/prog/service/QuestionService.java - Question service → Answer model: builds answers
question-service/src/main/java/kz/prog/service/QuestionService.java - Question service → Question request: accepts request
question-service/src/main/java/kz/prog/service/QuestionService.java - Test endpoints → Question selection: selects questions
test-service/src/main/java/kz/prog/TestController.java - Question selection → Question HTTP client: fetches questions
test-service/src/main/java/kz/prog/service/TestService.java - Question HTTP client → Question endpoints: requests questions
test-service/src/main/java/kz/prog/service/QuestionServiceClient.java - Client → Test endpoints: requests test
- Test endpoints → Score calculator: calculates score
test-service/src/main/java/kz/prog/TestController.java - Test endpoints → Result publisher: publishes result
test-service/src/main/java/kz/prog/TestController.java - Test endpoints → Test submission: accepts submission
test-service/src/main/java/kz/prog/TestController.java - Score calculator → Question HTTP client: gets answers
test-service/src/main/java/kz/prog/service/TestResultCalculator.java - Score calculator → Test result: produces result
test-service/src/main/java/kz/prog/service/TestResultCalculator.java - Result publisher → Test result: serializes result
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
result-service/src/main/java/kz/prog/service/TestResultConsumer.java - Result service → Results repository: persists results
result-service/src/main/java/kz/prog/service/ResultService.java - Result service → Persisted results: stores model
result-service/src/main/java/kz/prog/service/ResultService.java