How soufiane2204/quiz-api works
Quiz API accepts validated quiz-generation requests, obtains AI-generated questions, validates and persists them, then exposes answer-hidden quizzes. Submission loads a quiz, scores ordered answers, saves an attempt, and returns corrections; other endpoints list quizzes and prior attempts. The service is the business-flow layer between HTTP, AI, repositories, and domain entities. README documents Claude by default and Ollama as an optional provider; source excerpts do not show the provider wiring, so those integration links are marked unverified.
Main entry points: QuizService.java Quiz workflows · dto Requests and responses · QuizController.java Quiz endpoints · ClaudeQuizGenerator.java Claude generator
Components 14
REST API
- Quiz endpoints
src/main/java/com/soufiane/quizapi/controller/QuizController.java - Requests and responses
src/main/java/com/soufiane/quizapi/dto - Error mapping
src/main/java/com/soufiane/quizapi/exception/GlobalExceptionHandler.java
Quiz workflows
- Quiz workflows
src/main/java/com/soufiane/quizapi/service/QuizService.java - Quiz domain
src/main/java/com/soufiane/quizapi/model
AI generation
- Generator contract
src/main/java/com/soufiane/quizapi/ai/QuizGenerator.java - Claude generator
src/main/java/com/soufiane/quizapi/ai/ClaudeQuizGenerator.java - Ollama profile
src/main/resources/application-ollama.properties
Persistence
- Quiz repository
src/main/java/com/soufiane/quizapi/repository/QuizRepository.java - Attempt repository
src/main/java/com/soufiane/quizapi/repository/AttemptRepository.java
Other components
- API client
- MySQL database
- Anthropic API
- Ollama service
Connections 16
- API client → Quiz endpoints: calls endpoints
src/main/java/com/soufiane/quizapi/controller/QuizController.java - Quiz endpoints → Quiz workflows: delegates to
src/main/java/com/soufiane/quizapi/controller/QuizController.java - API client → Requests and responses: sends requests
README.md - Quiz endpoints → Requests and responses: returns DTOs
src/main/java/com/soufiane/quizapi/controller/QuizController.java - Quiz workflows → Requests and responses: builds responses
src/main/java/com/soufiane/quizapi/service/QuizService.java - Quiz workflows → Generator contract: requests questions
src/main/java/com/soufiane/quizapi/service/QuizService.java - Claude generator → Generator contract: implements contract
src/main/java/com/soufiane/quizapi/ai/ClaudeQuizGenerator.java - Claude generator → Anthropic API: calls model
README.md - Ollama profile → Ollama service: configures provider
README.md - Quiz workflows → Quiz repository: reads and saves quizzes
src/main/java/com/soufiane/quizapi/service/QuizService.java - Quiz workflows → Attempt repository: reads and saves attempts
src/main/java/com/soufiane/quizapi/service/QuizService.java - Quiz workflows → Quiz domain: scores and maps
src/main/java/com/soufiane/quizapi/service/QuizService.java - Quiz repository → MySQL database: persists quizzes
README.md - Attempt repository → MySQL database: persists attempts
README.md - Quiz workflows → Error mapping: raises domain errors
src/main/java/com/soufiane/quizapi/service/QuizService.java - Error mapping → Requests and responses: formats errors
src/main/java/com/soufiane/quizapi/exception/GlobalExceptionHandler.java