# adityasaini0070/resumebuilder architecture

> Architecture diagram of the GitHub repository adityasaini0070/resumebuilder, 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/adityasaini0070/resumebuilder
- Repository: https://github.com/adityasaini0070/resumebuilder

## Overview

The visible runtime is a Spring-based account and authentication backend for a resume-builder product: clients register, verify email, log in, and can upload a profile image. Authentication persists users in MongoDB, sends verification mail through Resend, and issues JWTs later checked by a request filter. The tree and excerpts do not show resume editing, templates, or export, so those product capabilities cannot be mapped here. Relationships are limited to excerpted calls and SOURCE INDEX references; several configuration and bootstrap components have no evidenced runtime link.

Main entry points: [`src/main/java/com/aditya/resumebuilder/service/AuthService.java`](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/service/AuthService.java) (Account workflows), [`src/main/java/com/aditya/resumebuilder/controller/AuthController.java`](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/controller/AuthController.java) (Auth endpoints), [`src/main/java/com/aditya/resumebuilder/security/JwtAuthenticationFilter.java`](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/security/JwtAuthenticationFilter.java) (JWT request filter), [`src/main/java/com/aditya/resumebuilder/repository/UserRepository.java`](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/repository/UserRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and payloads"]
  node_auth_controller["Auth endpoints"]
  node_register_request["Registration payload"]
  node_login_request["Login payload<br/>[LoginRequest.java]"]
  node_auth_response["Auth response<br/>[AuthResponse.java]"]
  node_app_constants["Route constants<br/>[AppConstants.java]"]
  node_exception_handler["Exception mapping"]
  node_application["Application bootstrap"]
end

subgraph group_identity["Identity and persistence"]
  node_auth_service["Account workflows<br/>[AuthService.java]"]
  node_user_repository["User repository"]
  node_user_document[("User record<br/>[User.java]")]
  node_resource_exists["Duplicate exception"]
  node_mongo_config["Mongo configuration<br/>[MongoConfig.java]"]
end

subgraph group_security["Security"]
  node_jwt_util["JWT operations<br/>[JwtUtil.java]"]
  node_jwt_filter["JWT request filter"]
  node_jwt_entry["Auth entry point"]
  node_security_config["Security wiring"]
end

subgraph group_integrations["External integrations"]
  node_email_service["Email delivery<br/>[EmailService.java]"]
  node_email_provider["Resend API"]
  node_upload_service["Image upload"]
  node_cloudinary["Cloudinary"]
  node_cloudinary_config["Cloudinary configuration"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_auth_controller
node_auth_controller -->|"delegates auth"| node_auth_service
node_auth_controller -->|"delegates upload"| node_upload_service
node_auth_controller -->|"accepts"| node_register_request
node_auth_controller -->|"accepts"| node_login_request
node_auth_controller -->|"returns"| node_auth_response
node_auth_controller -->|"uses routes"| node_app_constants
node_auth_service -->|"reads and saves"| node_user_repository
node_auth_service -->|"sends verification"| node_email_service
node_auth_service -->|"creates token"| node_jwt_util
node_auth_service -->|"builds user"| node_user_document
node_auth_service -->|"maps input"| node_register_request
node_auth_service -->|"reads credentials"| node_login_request
node_auth_service -->|"builds response"| node_auth_response
node_auth_service -->|"throws duplicate"| node_resource_exists
node_user_repository -->|"stores"| node_user_document
node_exception_handler -->|"handles"| node_resource_exists
node_jwt_filter -->|"validates token"| node_jwt_util
node_jwt_filter -->|"loads user"| node_user_repository
node_security_config -->|"configures filter"| node_jwt_filter
node_security_config -->|"configures entry point"| node_jwt_entry
node_email_service -->|"posts email"| node_email_provider
node_upload_service -->|"uploads image"| node_cloudinary

click node_auth_controller "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/controller/AuthController.java"
click node_register_request "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/dto/RegisterRequest.java"
click node_login_request "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/dto/LoginRequest.java"
click node_auth_response "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/dto/AuthResponse.java"
click node_app_constants "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/util/AppConstants.java"
click node_auth_service "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/service/AuthService.java"
click node_user_repository "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/repository/UserRepository.java"
click node_user_document "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/document/User.java"
click node_resource_exists "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/exception/ResourceExistsException.java"
click node_exception_handler "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/exception/GlobalExceptionHandler.java"
click node_jwt_util "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/util/JwtUtil.java"
click node_jwt_filter "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/security/JwtAuthenticationFilter.java"
click node_jwt_entry "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/security/JwtAuthenticationEntryPoint.java"
click node_security_config "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/config/SecurityConfig.java"
click node_email_service "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/service/EmailService.java"
click node_upload_service "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/service/FileUploadService.java"
click node_mongo_config "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/config/MongoConfig.java"
click node_cloudinary_config "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/config/CloudinaryConfig.java"
click node_application "https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/ResumebuilderApplication.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_auth_controller,node_register_request,node_login_request,node_auth_response,node_app_constants,node_exception_handler,node_application,node_client toneBlue
class node_auth_service,node_user_repository,node_user_document,node_resource_exists,node_mongo_config toneAmber
class node_jwt_util,node_jwt_filter,node_jwt_entry,node_security_config toneMint
class node_email_service,node_email_provider,node_upload_service,node_cloudinary,node_cloudinary_config toneRose
```

## Components

### API and payloads

- [Auth endpoints](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/controller/AuthController.java): `src/main/java/com/aditya/resumebuilder/controller/AuthController.java`
- [Registration payload](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/dto/RegisterRequest.java): `src/main/java/com/aditya/resumebuilder/dto/RegisterRequest.java`
- [Login payload](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/dto/LoginRequest.java): `src/main/java/com/aditya/resumebuilder/dto/LoginRequest.java`
- [Auth response](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/dto/AuthResponse.java): `src/main/java/com/aditya/resumebuilder/dto/AuthResponse.java`
- [Route constants](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/util/AppConstants.java): `src/main/java/com/aditya/resumebuilder/util/AppConstants.java`
- [Exception mapping](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/exception/GlobalExceptionHandler.java): `src/main/java/com/aditya/resumebuilder/exception/GlobalExceptionHandler.java`
- [Application bootstrap](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/ResumebuilderApplication.java): `src/main/java/com/aditya/resumebuilder/ResumebuilderApplication.java`

### Identity and persistence

- [Account workflows](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/service/AuthService.java): `src/main/java/com/aditya/resumebuilder/service/AuthService.java`
- [User repository](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/repository/UserRepository.java): `src/main/java/com/aditya/resumebuilder/repository/UserRepository.java`
- [User record](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/document/User.java): `src/main/java/com/aditya/resumebuilder/document/User.java`
- [Duplicate exception](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/exception/ResourceExistsException.java): `src/main/java/com/aditya/resumebuilder/exception/ResourceExistsException.java`
- [Mongo configuration](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/config/MongoConfig.java): `src/main/java/com/aditya/resumebuilder/config/MongoConfig.java`

### Security

- [JWT operations](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/util/JwtUtil.java): `src/main/java/com/aditya/resumebuilder/util/JwtUtil.java`
- [JWT request filter](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/security/JwtAuthenticationFilter.java): `src/main/java/com/aditya/resumebuilder/security/JwtAuthenticationFilter.java`
- [Auth entry point](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/security/JwtAuthenticationEntryPoint.java): `src/main/java/com/aditya/resumebuilder/security/JwtAuthenticationEntryPoint.java`
- [Security wiring](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/config/SecurityConfig.java): `src/main/java/com/aditya/resumebuilder/config/SecurityConfig.java`

### External integrations

- [Email delivery](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/service/EmailService.java): `src/main/java/com/aditya/resumebuilder/service/EmailService.java`
- **Resend API**
- [Image upload](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/service/FileUploadService.java): `src/main/java/com/aditya/resumebuilder/service/FileUploadService.java`
- **Cloudinary**
- [Cloudinary configuration](https://github.com/adityasaini0070/resumebuilder/blob/main/src/main/java/com/aditya/resumebuilder/config/CloudinaryConfig.java): `src/main/java/com/aditya/resumebuilder/config/CloudinaryConfig.java`

### Other components

- **API client**

## Connections

- API client → Auth endpoints: sends requests (evidence: `src/main/java/com/aditya/resumebuilder/controller/AuthController.java`)
- Auth endpoints → Account workflows: delegates auth (evidence: `src/main/java/com/aditya/resumebuilder/controller/AuthController.java`)
- Auth endpoints → Image upload: delegates upload (evidence: `src/main/java/com/aditya/resumebuilder/controller/AuthController.java`)
- Auth endpoints → Registration payload: accepts (evidence: `src/main/java/com/aditya/resumebuilder/controller/AuthController.java`)
- Auth endpoints → Login payload: accepts (evidence: `src/main/java/com/aditya/resumebuilder/controller/AuthController.java`)
- Auth endpoints → Auth response: returns (evidence: `src/main/java/com/aditya/resumebuilder/controller/AuthController.java`)
- Auth endpoints → Route constants: uses routes (evidence: `src/main/java/com/aditya/resumebuilder/controller/AuthController.java`)
- Account workflows → User repository: reads and saves (evidence: `src/main/java/com/aditya/resumebuilder/service/AuthService.java`)
- Account workflows → Email delivery: sends verification (evidence: `src/main/java/com/aditya/resumebuilder/service/AuthService.java`)
- Account workflows → JWT operations: creates token (evidence: `src/main/java/com/aditya/resumebuilder/service/AuthService.java`)
- Account workflows → User record: builds user (evidence: `src/main/java/com/aditya/resumebuilder/service/AuthService.java`)
- Account workflows → Registration payload: maps input (evidence: `src/main/java/com/aditya/resumebuilder/service/AuthService.java`)
- Account workflows → Login payload: reads credentials (evidence: `src/main/java/com/aditya/resumebuilder/service/AuthService.java`)
- Account workflows → Auth response: builds response (evidence: `src/main/java/com/aditya/resumebuilder/service/AuthService.java`)
- Account workflows → Duplicate exception: throws duplicate (evidence: `src/main/java/com/aditya/resumebuilder/service/AuthService.java`)
- User repository → User record: stores (evidence: `src/main/java/com/aditya/resumebuilder/repository/UserRepository.java`)
- Exception mapping → Duplicate exception: handles (evidence: `src/main/java/com/aditya/resumebuilder/exception/GlobalExceptionHandler.java`)
- JWT request filter → JWT operations: validates token (evidence: `src/main/java/com/aditya/resumebuilder/security/JwtAuthenticationFilter.java`)
- JWT request filter → User repository: loads user (evidence: `src/main/java/com/aditya/resumebuilder/security/JwtAuthenticationFilter.java`)
- Security wiring → JWT request filter: configures filter (evidence: `src/main/java/com/aditya/resumebuilder/config/SecurityConfig.java`)
- Security wiring → Auth entry point: configures entry point (evidence: `src/main/java/com/aditya/resumebuilder/config/SecurityConfig.java`)
- Email delivery → Resend API: posts email (evidence: `src/main/java/com/aditya/resumebuilder/service/EmailService.java`)
- Image upload → Cloudinary: uploads image (evidence: `src/main/java/com/aditya/resumebuilder/service/FileUploadService.java`)
