How arpitsahu2203/dev-track works
Dev Tracker is a server-rendered DSA practice tracker. Users sign in, record and filter solved problems, review difficulty and volume metrics, and optionally generate AI revision guidance with revisit scheduling. Authentication supports local accounts and Google/GitHub OAuth; GitHub sign-in resolves a verified email before provisioning. The graph also includes the documented browser-side search, URL ingestion, theme controls, and the MySQL-backed persistence layer. Some UI and auth wiring is documented rather than shown in source excerpts, so those links cite the README; unsampled details are not inferred.
Main entry points: GithubEmailResolvingOAuth2UserService.java GitHub email resolver · ProblemController.java Problem workflows · templates Tracker interface · ProblemAiReviewService.java AI revision coach
Components 25
User experience
- Tracker interface
src/main/resources/templates - Client interactions
src/main/resources/static/js/app.js - Site pages
src/main/java/com/devtracker/controller/PageController.java
Problem tracking
- Problem workflows
src/main/java/com/devtracker/controller/ProblemController.java - Problem service
src/main/java/com/devtracker/serviceImplementation/ProblemServiceImplementation.java - Problem records
src/main/java/com/devtracker/repositories/ProblemRepository.java - Problem model
src/main/java/com/devtracker/entities/Problem.java - Review model
src/main/java/com/devtracker/entities/ProblemAiReview.java - Difficulty taxonomy
src/main/java/com/devtracker/entities/HardnessLevel.java - Problem input
src/main/java/com/devtracker/form/ProblemForm.java
Identity and access
- Account workflows
src/main/java/com/devtracker/controller/AuthController.java - Security configuration
src/main/java/com/devtracker/config/SecurityConfig.java - GitHub email resolver
src/main/java/com/devtracker/config/GithubEmailResolvingOAuth2UserService.java - OAuth provisioning
src/main/java/com/devtracker/config/OAuthAccountProvisioningSuccessHandler.java - User service
src/main/java/com/devtracker/serviceImplementation/UserServiceImplementation.java - User records
src/main/java/com/devtracker/repositories/UserRepository.java - User model
src/main/java/com/devtracker/entities/User.java - Email normalization
src/main/java/com/devtracker/support/EmailNormalizer.java - Account input
src/main/java/com/devtracker/form/UserForm.java
AI and persistence
- AI revision coach
src/main/java/com/devtracker/ai/ProblemAiReviewService.java - Structured review
src/main/java/com/devtracker/ai/AiProblemReview.java - Review records
src/main/java/com/devtracker/repositories/ProblemAiReviewRepository.java
Other components
- Developer
- Gemini API
- MySQL database
Connections 41
- Developer → Tracker interface: uses
README.md - Tracker interface → Client interactions: uses interactions
README.md - Tracker interface → Site pages: requests pages
- Tracker interface → Problem workflows: submits problems
- Client interactions → Problem input: assists URL entry
README.md - Problem workflows → Problem input: binds input
src/main/java/com/devtracker/controller/ProblemController.java - Problem workflows → Problem service: loads and saves
src/main/java/com/devtracker/controller/ProblemController.java - Problem workflows → AI revision coach: requests review
src/main/java/com/devtracker/controller/ProblemController.java - Problem service → Problem records: queries records
src/main/java/com/devtracker/serviceImplementation/ProblemServiceImplementation.java - Problem records → MySQL database: persists problems
README.md - Problem workflows → Difficulty taxonomy: offers difficulty options
src/main/java/com/devtracker/controller/ProblemController.java - AI revision coach → Gemini API: generates review
src/main/java/com/devtracker/ai/ProblemAiReviewService.java - AI revision coach → Structured review: parses response
src/main/java/com/devtracker/ai/ProblemAiReviewService.java - AI revision coach → Review records: loads and saves
src/main/java/com/devtracker/ai/ProblemAiReviewService.java - Review records → MySQL database: persists reviews
README.md - Account workflows → User service: handles accounts
src/main/java/com/devtracker/controller/AuthController.java - Security configuration → GitHub email resolver: configures OAuth lookup
src/main/java/com/devtracker/config/SecurityConfig.java - Security configuration → OAuth provisioning: configures OAuth success
src/main/java/com/devtracker/config/SecurityConfig.java - GitHub email resolver → Gemini API
- GitHub email resolver → Developer
- GitHub email resolver → User service
- GitHub email resolver → MySQL database
- GitHub email resolver → Tracker interface
- GitHub email resolver → Site pages
- GitHub email resolver → Problem workflows
- GitHub email resolver → Problem service
- GitHub email resolver → Problem records
- GitHub email resolver → Problem model
- GitHub email resolver → Review model
- GitHub email resolver → Difficulty taxonomy
- GitHub email resolver → Problem input
- GitHub email resolver → AI revision coach
- GitHub email resolver → Structured review
- GitHub email resolver → Review records
- GitHub email resolver → Account workflows
- GitHub email resolver → Security configuration
src/main/java/com/devtracker/config/SecurityConfig.java - GitHub email resolver → OAuth provisioning
- GitHub email resolver → User records
- GitHub email resolver → User model
- GitHub email resolver → Email normalization
- GitHub email resolver → Account input