# arpitsahu2203/dev-track architecture

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

- Interactive diagram: https://gitdiagram.com/arpitsahu2203/dev-track
- Repository: https://github.com/arpitsahu2203/dev-track

## Overview

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: [`src/main/java/com/devtracker/config/GithubEmailResolvingOAuth2UserService.java`](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/config/GithubEmailResolvingOAuth2UserService.java) (GitHub email resolver), [`src/main/java/com/devtracker/controller/ProblemController.java`](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/controller/ProblemController.java) (Problem workflows), [`src/main/resources/templates`](https://github.com/arpitsahu2203/dev-track/tree/main/src/main/resources/templates) (Tracker interface), [`src/main/java/com/devtracker/ai/ProblemAiReviewService.java`](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/ai/ProblemAiReviewService.java) (AI revision coach)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_browser["Tracker interface"]
  node_client["Client interactions<br/>[app.js]"]
  node_page_routes["Site pages"]
end

subgraph group_practice["Problem tracking"]
  node_problem_routes["Problem workflows"]
  node_problem_service["Problem service"]
  node_problem_repo["Problem records"]
  node_problem_entity["Problem model<br/>[Problem.java]"]
  node_review_entity["Review model"]
  node_difficulty["Difficulty taxonomy<br/>[HardnessLevel.java]"]
  node_problem_form["Problem input<br/>[ProblemForm.java]"]
end

subgraph group_identity["Identity and access"]
  node_auth_routes["Account workflows"]
  node_security["Security configuration"]
  node_github_email["GitHub email resolver"]
  node_provisioning["OAuth provisioning"]
  node_user_service["User service"]
  node_user_repo["User records"]
  node_user_entity["User model<br/>[User.java]"]
  node_email_normalizer["Email normalization"]
  node_user_form["Account input<br/>[UserForm.java]"]
end

subgraph group_platform["AI and persistence"]
  node_ai_review["AI revision coach"]
  node_ai_output["Structured review"]
  node_review_repo["Review records"]
end

node_developer(("Developer"))
node_gemini["Gemini API"]
node_mysql[("MySQL database")]

node_developer -->|"uses"| node_browser
node_browser -->|"uses interactions"| node_client
node_browser -.->|"requests pages"| node_page_routes
node_browser -.->|"submits problems"| node_problem_routes
node_client -->|"assists URL entry"| node_problem_form
node_problem_routes -->|"binds input"| node_problem_form
node_problem_routes -->|"loads and saves"| node_problem_service
node_problem_routes -->|"requests review"| node_ai_review
node_problem_service -->|"queries records"| node_problem_repo
node_problem_repo -->|"persists problems"| node_mysql
node_problem_routes -->|"offers difficulty options"| node_difficulty
node_ai_review -->|"generates review"| node_gemini
node_ai_review -->|"parses response"| node_ai_output
node_ai_review -->|"loads and saves"| node_review_repo
node_review_repo -->|"persists reviews"| node_mysql
node_auth_routes -->|"handles accounts"| node_user_service
node_security -->|"configures OAuth lookup"| node_github_email
node_security -->|"configures OAuth success"| node_provisioning
node_github_email --> node_gemini
node_github_email --> node_developer
node_github_email --> node_user_service
node_github_email --> node_mysql
node_github_email --> node_browser
node_github_email --> node_page_routes
node_github_email --> node_problem_routes
node_github_email --> node_problem_service
node_github_email --> node_problem_repo
node_github_email --> node_problem_entity
node_github_email --> node_review_entity
node_github_email --> node_difficulty
node_github_email --> node_problem_form
node_github_email --> node_ai_review
node_github_email --> node_ai_output
node_github_email --> node_review_repo
node_github_email --> node_auth_routes
node_github_email --> node_security
node_github_email --> node_provisioning
node_github_email --> node_user_repo
node_github_email --> node_user_entity
node_github_email --> node_email_normalizer
node_github_email --> node_user_form

click node_browser "https://github.com/arpitsahu2203/dev-track/tree/main/src/main/resources/templates"
click node_client "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/resources/static/js/app.js"
click node_page_routes "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/controller/PageController.java"
click node_problem_routes "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/controller/ProblemController.java"
click node_problem_service "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/serviceImplementation/ProblemServiceImplementation.java"
click node_problem_repo "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/repositories/ProblemRepository.java"
click node_problem_entity "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/entities/Problem.java"
click node_review_entity "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/entities/ProblemAiReview.java"
click node_difficulty "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/entities/HardnessLevel.java"
click node_problem_form "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/form/ProblemForm.java"
click node_ai_review "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/ai/ProblemAiReviewService.java"
click node_ai_output "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/ai/AiProblemReview.java"
click node_review_repo "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/repositories/ProblemAiReviewRepository.java"
click node_auth_routes "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/controller/AuthController.java"
click node_security "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/config/SecurityConfig.java"
click node_github_email "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/config/GithubEmailResolvingOAuth2UserService.java"
click node_provisioning "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/config/OAuthAccountProvisioningSuccessHandler.java"
click node_user_service "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/serviceImplementation/UserServiceImplementation.java"
click node_user_repo "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/repositories/UserRepository.java"
click node_user_entity "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/entities/User.java"
click node_email_normalizer "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/support/EmailNormalizer.java"
click node_user_form "https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/form/UserForm.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_browser,node_client,node_page_routes toneBlue
class node_problem_routes,node_problem_service,node_problem_repo,node_problem_entity,node_review_entity,node_difficulty,node_problem_form,node_mysql toneAmber
class node_auth_routes,node_security,node_github_email,node_provisioning,node_user_service,node_user_repo,node_user_entity,node_email_normalizer,node_user_form,node_gemini toneMint
class node_ai_review,node_ai_output,node_review_repo toneRose
class node_developer toneIndigo
```

## Components

### User experience

- [Tracker interface](https://github.com/arpitsahu2203/dev-track/tree/main/src/main/resources/templates): `src/main/resources/templates`
- [Client interactions](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/resources/static/js/app.js): `src/main/resources/static/js/app.js`
- [Site pages](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/controller/PageController.java): `src/main/java/com/devtracker/controller/PageController.java`

### Problem tracking

- [Problem workflows](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/controller/ProblemController.java): `src/main/java/com/devtracker/controller/ProblemController.java`
- [Problem service](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/serviceImplementation/ProblemServiceImplementation.java): `src/main/java/com/devtracker/serviceImplementation/ProblemServiceImplementation.java`
- [Problem records](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/repositories/ProblemRepository.java): `src/main/java/com/devtracker/repositories/ProblemRepository.java`
- [Problem model](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/entities/Problem.java): `src/main/java/com/devtracker/entities/Problem.java`
- [Review model](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/entities/ProblemAiReview.java): `src/main/java/com/devtracker/entities/ProblemAiReview.java`
- [Difficulty taxonomy](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/entities/HardnessLevel.java): `src/main/java/com/devtracker/entities/HardnessLevel.java`
- [Problem input](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/form/ProblemForm.java): `src/main/java/com/devtracker/form/ProblemForm.java`

### Identity and access

- [Account workflows](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/controller/AuthController.java): `src/main/java/com/devtracker/controller/AuthController.java`
- [Security configuration](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/config/SecurityConfig.java): `src/main/java/com/devtracker/config/SecurityConfig.java`
- [GitHub email resolver](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/config/GithubEmailResolvingOAuth2UserService.java): `src/main/java/com/devtracker/config/GithubEmailResolvingOAuth2UserService.java`
- [OAuth provisioning](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/config/OAuthAccountProvisioningSuccessHandler.java): `src/main/java/com/devtracker/config/OAuthAccountProvisioningSuccessHandler.java`
- [User service](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/serviceImplementation/UserServiceImplementation.java): `src/main/java/com/devtracker/serviceImplementation/UserServiceImplementation.java`
- [User records](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/repositories/UserRepository.java): `src/main/java/com/devtracker/repositories/UserRepository.java`
- [User model](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/entities/User.java): `src/main/java/com/devtracker/entities/User.java`
- [Email normalization](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/support/EmailNormalizer.java): `src/main/java/com/devtracker/support/EmailNormalizer.java`
- [Account input](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/form/UserForm.java): `src/main/java/com/devtracker/form/UserForm.java`

### AI and persistence

- [AI revision coach](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/ai/ProblemAiReviewService.java): `src/main/java/com/devtracker/ai/ProblemAiReviewService.java`
- [Structured review](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/ai/AiProblemReview.java): `src/main/java/com/devtracker/ai/AiProblemReview.java`
- [Review records](https://github.com/arpitsahu2203/dev-track/blob/main/src/main/java/com/devtracker/repositories/ProblemAiReviewRepository.java): `src/main/java/com/devtracker/repositories/ProblemAiReviewRepository.java`

### Other components

- **Developer**
- **Gemini API**
- **MySQL database**

## Connections

- Developer → Tracker interface: uses (evidence: `README.md`)
- Tracker interface → Client interactions: uses interactions (evidence: `README.md`)
- Tracker interface → Site pages: requests pages
- Tracker interface → Problem workflows: submits problems
- Client interactions → Problem input: assists URL entry (evidence: `README.md`)
- Problem workflows → Problem input: binds input (evidence: `src/main/java/com/devtracker/controller/ProblemController.java`)
- Problem workflows → Problem service: loads and saves (evidence: `src/main/java/com/devtracker/controller/ProblemController.java`)
- Problem workflows → AI revision coach: requests review (evidence: `src/main/java/com/devtracker/controller/ProblemController.java`)
- Problem service → Problem records: queries records (evidence: `src/main/java/com/devtracker/serviceImplementation/ProblemServiceImplementation.java`)
- Problem records → MySQL database: persists problems (evidence: `README.md`)
- Problem workflows → Difficulty taxonomy: offers difficulty options (evidence: `src/main/java/com/devtracker/controller/ProblemController.java`)
- AI revision coach → Gemini API: generates review (evidence: `src/main/java/com/devtracker/ai/ProblemAiReviewService.java`)
- AI revision coach → Structured review: parses response (evidence: `src/main/java/com/devtracker/ai/ProblemAiReviewService.java`)
- AI revision coach → Review records: loads and saves (evidence: `src/main/java/com/devtracker/ai/ProblemAiReviewService.java`)
- Review records → MySQL database: persists reviews (evidence: `README.md`)
- Account workflows → User service: handles accounts (evidence: `src/main/java/com/devtracker/controller/AuthController.java`)
- Security configuration → GitHub email resolver: configures OAuth lookup (evidence: `src/main/java/com/devtracker/config/SecurityConfig.java`)
- Security configuration → OAuth provisioning: configures OAuth success (evidence: `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 (evidence: `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
