Skip to content

JobTrackr is a job application tracker built with Spring Boot and PostgreSQL. It helps users manage their job applications, track statuses, store related documents, and maintain audit logs. Features include user authentication, follow-up reminders, and role-based access control.

License

Notifications You must be signed in to change notification settings

VictoriousWealth/job-application-tracker

Repository files navigation

💼 JobTrackr – Full-Stack Job Application Tracker

Build Status Coverage Checker Gradle Tests Built with Java License: MIT

JobTrackr is a comprehensive system designed to streamline and manage every part of the job search process — tracking applications, managing resumes and cover letters, logging communication, setting follow-ups, and organizing timelines.
It is built for real-world use with a secure backend, a clean modular design, and future-ready architecture.


📌 Table of Contents


🌟 Features

  • ✅ Secure JWT-based user authentication
  • ✅ Advanced job application tracking
  • ✅ Resume and cover letter management
  • ✅ Timeline and event tracking
  • ✅ Recruiter communication logs
  • ✅ Reminder and notification system
  • ✅ Audit logging for all key actions
  • ✅ Attach important documents (offers, rejections, prep material)
  • ✅ Structured data models for sources, locations, and skills
  • ✅ Extendable and AI-ready backend

⚙️ Tech Stack

Layer Technology
Backend Spring Boot (Java)
Database PostgreSQL
ORM Spring Data JPA + Hibernate
Security Spring Security + JWT
Build Tool Gradle
Docs Swagger/OpenAPI (Planned)
Deployment Render / Heroku (Planned)

🧠 System Overview

JobTrackr models the real-world complexity of job hunting:

  • Track applications to roles with detailed metadata
  • Manage communications across multiple channels (email, calls, LinkedIn)
  • Schedule interviews and assessments
  • Attach and organize supporting files
  • Normalize locations, sources, and skills for analytics and filtering
  • Log all significant actions for transparency and auditability

Built with an enterprise architecture mindset, prioritizing security, extendability, and real usability.


🧪 Testing and Code Quality

Testing is built into the development lifecycle:

  • Per-class test coverage is tracked with a custom script.
  • Gradle integration to run tests by module or globally.
  • Test Coverage Metrics are output with colored progress bars.
  • Auditability: Changes are logged through the AuditLog model.

🛠️ Check Test Coverage

Run the custom coverage checker:

./scripts/check_test_coverage.sh

Options:

  • --show-missing or --s-m → Also show classes without corresponding tests.
  • --with-gradle → Automatically run Gradle tests for each major package/folder.
  • -h or --help → Show usage information.

Example:

./scripts/check_test_coverage.sh --show-missing --with-gradle

🧹 Scripts

Script Description
scripts/check_test_coverage.sh Calculates Java class test coverage. Shows per-folder breakdowns. Integrates with Gradle test runner.

📖 See scripts/README.md for full usage instructions and options.


📂 Folder Structure (Backend)

TBC (To be completed once frontend and backend stabilization is done)


🔮 Future Plans

  • Analytics dashboard (conversion rates, offers vs rejections)
  • Calendar-based event management
  • Resume and Job Matching AI (Skill-based scoring)
  • Export capabilities (CSV, PDF)
  • GraphQL migration option
  • Full frontend client (React)

👋 Want to Contribute?

The project will soon open for external contributions. Stay tuned for the contribution guide!


🚀 Let's make job tracking seamless!


About

JobTrackr is a job application tracker built with Spring Boot and PostgreSQL. It helps users manage their job applications, track statuses, store related documents, and maintain audit logs. Features include user authentication, follow-up reminders, and role-based access control.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published