💼 Job & Internship Application Tracker Backend

A production-ready Job & Internship Application Tracker Backend Application built with Spring Boot 3, Spring Security (JWT), Spring Data JPA, PostgreSQL, H2 In-Memory Database, Docker, Spring Mail, and Swagger UI.

🌐 Live Deployed Application URL: https://job-and-internship-application-tracker.onrender.com
📑 Live Interactive Swagger UI: https://job-and-internship-application-tracker.onrender.com/swagger-ui.html

This repository is crafted in a beginner student-friendly style with explicit getters, setters, constructors, builders, and detailed Hinglish comments throughout the codebase to help students understand, learn, and present Spring Boot backend architecture easily!

---

🏗️ Architecture Overview

graph TD
    Client[Client / Postman / Swagger / Frontend] --> REST[REST Controllers]
    REST --> AuthCtrl[Auth Controller]
    REST --> AppCtrl[Job Application Controller]
    REST --> DashCtrl[Dashboard Controller]
    REST --> RemindCtrl[Reminder Controller]
    
    AuthCtrl --> Sec[Spring Security + JWT]
    AppCtrl --> AppService[Job Application Service]
    DashCtrl --> DashService[Dashboard Service]
    RemindCtrl --> MailService[Email Reminder Service]
    
    AppService --> FileService[File Storage Service]
    AppService --> Repo[JPA Repositories]
    DashService --> Repo
    Sec --> UserRepo[User Repository]
    
    Repo --> DB[(PostgreSQL / H2 Database)]
    FileService --> Storage[(Local File Storage ./uploads)]
    MailService --> SMTP[SMTP Server / Spring Mail]

Loading

---

📂 Project Layout

f:\Job & Internship Application Tracker
├── .mvn/                              # Maven Wrapper
├── uploads/                           # Resume file uploads storage
├── src/
│   ├── main/
│   │   ├── java/com/tracker/job/
│   │   │   ├── JobTrackerApplication.java
│   │   │   ├── config/                # Security, Swagger, Mail, Web Config
│   │   │   │   ├── SecurityConfig.java
│   │   │   │   ├── OpenApiConfig.java
│   │   │   │   └── DataInitializer.java
│   │   │   ├── controller/            # REST API Controllers
│   │   │   │   ├── AuthController.java
│   │   │   │   ├── JobApplicationController.java
│   │   │   │   ├── DashboardController.java
│   │   │   │   └── ReminderController.java
│   │   │   ├── dto/                   # Request & Response DTOs
│   │   │   │   ├── request/
│   │   │   │   │   ├── RegisterRequest.java
│   │   │   │   │   ├── LoginRequest.java
│   │   │   │   │   ├── JobApplicationRequest.java
│   │   │   │   │   └── StatusUpdateRequest.java
│   │   │   │   └── response/
│   │   │   │       ├── AuthResponse.java
│   │   │   │       ├── UserDto.java
│   │   │   │       ├── JobApplicationResponse.java
│   │   │   │       ├── DashboardStatsResponse.java
│   │   │   │       ├── ApiResponse.java
│   │   │   │       └── PagedResponse.java
│   │   │   ├── exception/             # Custom Exceptions & Global Handler
│   │   │   │   ├── ResourceNotFoundException.java
│   │   │   │   ├── BadRequestException.java
│   │   │   │   ├── FileStorageException.java
│   │   │   │   ├── UnauthorizedAccessException.java
│   │   │   │   ├── ErrorDetails.java
│   │   │   │   └── GlobalExceptionHandler.java
│   │   │   ├── model/                 # JPA Entities & Enums
│   │   │   │   ├── User.java
│   │   │   │   ├── Role.java
│   │   │   │   ├── JobApplication.java
│   │   │   │   ├── ApplicationStatus.java
│   │   │   │   └── JobType.java
│   │   │   ├── repository/            # Spring Data Repositories
│   │   │   │   ├── UserRepository.java
│   │   │   │   └── JobApplicationRepository.java
│   │   │   ├── security/              # JWT & Spring Security Utilities
│   │   │   │   ├── JwtTokenProvider.java
│   │   │   │   ├── JwtAuthenticationFilter.java
│   │   │   │   ├── JwtAuthenticationEntryPoint.java
│   │   │   │   └── CustomUserDetailsService.java
│   │   │   └── service/               # Service Layer & Implementations
│   │   │       ├── AuthService.java
│   │   │       ├── JobApplicationService.java
│   │   │       ├── DashboardService.java
│   │   │       ├── EmailReminderService.java
│   │   │       ├── FileStorageService.java
│   │   │       └── impl/
│   │   │           ├── AuthServiceImpl.java
│   │   │           ├── JobApplicationServiceImpl.java
│   │   │           ├── DashboardServiceImpl.java
│   │   │           ├── EmailReminderServiceImpl.java
│   │   │           └── FileStorageServiceImpl.java
│   │   └── resources/
│   │       ├── application.properties
│   │       └── application-dev.properties
│   └── test/                          # Unit & Integration Tests
├── Dockerfile                         # Multi-stage Docker build
├── docker-compose.yml                 # App + PostgreSQL orchestration
├── pom.xml                            # Dependencies & plugins
└── Job_Tracker_Postman_Collection.json # Importable Postman collection

---

🎯 Key Features

• User Authentication & Authorization:

  • Secure Registration & Login endpoints.
  • Stateless JWT (JSON Web Token) Bearer authentication.
  • Role-based Access Control (ROLE_USER, ROLE_ADMIN).
  • BCrypt Password Hashing.

• Job Application Tracking (CRUD):

  • Add, View, Update, and Delete Job/Internship Applications.
  • Tracking fields: Company Name, Job Title, Job Type (FULL_TIME, INTERNSHIP, PART_TIME, CONTRACT), Location, Salary/Stipend, Applied Date, Deadline, Interview Date, Notes, and Job Posting Link.
  • Application Lifecycle Status Workflow: APPLIED → OA (Online Assessment) → INTERVIEW → SELECTED / REJECTED.

• Multi-Criteria Search, Filtering & Pagination:

  • Search applications by Company, Job Title, or Location.
  • Filter applications by status (APPLIED, OA, INTERVIEW, SELECTED, REJECTED).
  • Paginated & Sorted REST API responses (Pageable, Sort).

• Resume Attachment Handling:

  • Upload PDF, DOC, or DOCX resume files for specific applications.
  • Secure local file storage (./uploads/resumes/).
  • Download attached resume files via REST API.
  • Delete resume attachments.

• Dashboard Analytics & Statistics:

  • Total application metrics.
  • Status breakdown counts (Applied, OA, Interview, Selected, Rejected).
  • Calculated Response Rate % & Selection Rate %.
  • Upcoming deadlines widget (next 7 days).
  • Recent applications list.

• Automated Email Reminders:

  • Scheduled background cron job (@Scheduled(cron = "0 0 9 * * ?")) checking application deadlines within 48 hours and sending HTML formatted reminder emails via Spring Boot Starter Mail.
  • Test email trigger endpoint.

• Developer & Deployment Assets:

  • Swagger UI interactive documentation (/swagger-ui.html).
  • H2 Web Console (/h2-console).
  • Multi-stage Dockerfile and docker-compose.yml.
  • Ready-to-import Postman Collection (Job_Tracker_Postman_Collection.json).

---

🚀 Getting Started

Prerequisites

• Java 17 or higher
• Maven (or use included ./mvnw.cmd wrapper)
• Docker & Docker Compose (Optional, for containerized run)

Running Locally with H2 Database (Fastest - Zero DB Setup)

# Clone the repository
git clone https://github.com/krishna3163/Job-And-Internship-Application-Tracker.git
cd Job-And-Internship-Application-Tracker

# Run using Maven Wrapper
.\mvnw.cmd spring-boot:run

Once started:

• Swagger UI Documentation: http://localhost:8080/swagger-ui.html
• H2 Database Console: http://localhost:8080/h2-console (JDBC URL: jdbc:h2:mem:jobtrackerdb, Username: sa, Password: blank)

Running with Docker Compose (PostgreSQL DB + App Container)

docker-compose up --build

---

🌐 Free Deployment on Render.com

Iss project ko Render.com par 100% Free deploy karne ke liye simple steps:

1. Render.com par account banayein aur New + > Web Service select karein.
2. Apne GitHub repository krishna3163/Job-And-Internship-Application-Tracker ko connect karein.
3. Configuration settings set karein:
   • Name: job-tracker-backend
   • Language / Environment: Docker
   • Region: Singapore (or nearest)
   • Instance Type: Free
4. Environment Variables add karein:
   • SPRING_PROFILES_ACTIVE: dev (H2 Database ke liye instant deployment without external DB)
   • APP_JWT_SECRET: 9a2f8c4e6b1d3a5f7e9c2b4a6d8f1e3c5a7b9d2e4f6a8c1e3b5d7f9a2c4e6b1d
5. Create Web Service par click karein. Application live URL https://job-and-internship-application-tracker.onrender.com par start ho jaayegi! 🎉

---

🔑 Default Credentials (Seed Data)

On application startup, demo user and 5 sample applications (Google, Microsoft, Amazon, Flipkart, Adobe) are automatically created:

• Username: demo_student
• Email: user@example.com
• Password: password123

---

🧪 Beginner Guide: How to Use Swagger UI & Test APIs (Kaam Kar Raha Hai Ki Nahi)

Agar aap beginner hain aur check karna chahte hain ki APIs live kaam kar rahi hain ya nahi, to Swagger UI sabse simple interactive testing tool hai!

📌 Step-by-Step Testing Guide:

1. Swagger UI Interface Open Karein

Browser me live URL ya local link kholein:

• Live Render URL: https://job-and-internship-application-tracker.onrender.com/swagger-ui.html
• Local URL: http://localhost:8080/swagger-ui.html

2. User Login API Test Karein & JWT Token Praapt Karein

1. Section 1. Authentication me POST /api/v1/auth/login par click karein.
2. Top-right side me Try it out button dabayein.
3. Request body me sample student credentials pass karein:

   {
     "usernameOrEmail": "user@example.com",
     "password": "password123"
   }

4. Execute button par click karein.
5. Response me 200 OK milega aur JSON data me accessToken (long JWT string) dikhega. Us token string ko Copy kar lein.

3. Swagger UI me Bearer Token Authorize Karein

1. Swagger page ke bilkul top-right me 🟢 Authorize 🔓 button par click karein.
2. Value box me copied accessToken string paste karein.
3. Authorize click karke Close dabayein. (Ab sabhi protected endpoints aapke token se automatically verify ho jayenge!)

4. Dashboard Stats & Job Applications Test Karein

• Dashboard Metrics Check: Section 3. Dashboard Analytics -> GET /api/v1/dashboard/stats -> Try it out -> Execute. Aapko live statistics (totalApplications: 5, response rate 80.0%, status counts) return honge!
• Job Applications Search Check: Section 2. Job Applications Management -> GET /api/v1/applications -> Execute. Saari job applications paginated JSON format me fetch hongi!

---

📡 REST API Endpoints Summary

1. Authentication (/api/v1/auth)

Method	Endpoint	Description	Public / Protected
POST	/api/v1/auth/register	Register new user account	Public
POST	/api/v1/auth/login	Login user & receive JWT token	Public
GET	/api/v1/auth/me	Fetch logged-in user profile	Protected (JWT)

2. Job Applications (/api/v1/applications)

Method	Endpoint	Description	Public / Protected
POST	/api/v1/applications	Create new job application	Protected (JWT)
GET	/api/v1/applications	Get paginated applications (with search & filter)	Protected (JWT)
GET	/api/v1/applications/{id}	Get application details by ID	Protected (JWT)
PUT	/api/v1/applications/{id}	Update application details	Protected (JWT)
PATCH	/api/v1/applications/{id}/status	Quick status transition (APPLIED → OA → INTERVIEW)	Protected (JWT)
DELETE	/api/v1/applications/{id}	Delete application	Protected (JWT)
POST	/api/v1/applications/{id}/resume	Upload & attach PDF/DOCX resume	Protected (JWT)
GET	/api/v1/applications/{id}/resume	Download attached resume file	Protected (JWT)
DELETE	/api/v1/applications/{id}/resume	Remove attached resume	Protected (JWT)

3. Dashboard Analytics (/api/v1/dashboard)

Method	Endpoint	Description	Public / Protected
GET	/api/v1/dashboard/stats	Fetch application metrics, status counts & rates	Protected (JWT)

4. Email Reminders (/api/v1/reminders)

Method	Endpoint	Description	Public / Protected
POST	/api/v1/reminders/test-email	Trigger test email to logged-in user	Protected (JWT)
POST	/api/v1/reminders/trigger-deadlines-job	Manually run deadline reminder scan	Protected (JWT)

---

📬 Postman Collection Usage

1. Open Postman and click Import.
2. Select Job_Tracker_Postman_Collection.json from project root directory.
3. Execute the Login User request under 1. Authentication.
4. The test script will automatically capture and save the Bearer JWT token into {{jwt_token}} for all subsequent requests!

---

💻 Hinglish Comments Code Style Sample

/**
 * JobApplicationServiceImpl: Job Applications business logic implementation.
 */
@Service
public class JobApplicationServiceImpl implements JobApplicationService {

    // Helper: Application ID verify karna aur Security Ownership Check karna
    private JobApplication getApplicationAndVerifyUser(Long applicationId, User user) {
        JobApplication application = jobApplicationRepository.findById(applicationId)
                .orElseThrow(() -> new ResourceNotFoundException("JobApplication", "id", applicationId));

        // Security Check: Verify that logged-in user owns this job application
        if (!application.getUser().getId().equals(user.getId())) {
            throw new UnauthorizedAccessException("Aap is job application ko access ya modify nahi kar sakte!");
        }

        return application;
    }
}

---

👨‍💻 Author

• Krishna Kumar (@krishna3163)