# aayushdai/job_application_tracker architecture

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

- Interactive diagram: https://gitdiagram.com/aayushdai/job_application_tracker
- Repository: https://github.com/aayushdai/job_application_tracker

## Overview

Job Application Tracker is a REST API for managing a job seeker’s application lifecycle: record applications and companies, track interviews and follow-ups, manage documents and notifications, and review dashboard analytics. The documented request path is client → Express routes → authentication/validation and controllers → services → Sequelize/MySQL; scheduled jobs automate follow-up checks and notification cleanup. The graph preserves those product areas and the core persistence layer. Some route-to-service links rely on the README’s layered-architecture description and SOURCE INDEX references; unsampled details are not inferred.

Main entry points: [`src/app.js`](https://github.com/aayushdai/job_application_tracker/blob/main/src/app.js) (Express API), [`src/models/index.js`](https://github.com/aayushdai/job_application_tracker/blob/main/src/models/index.js) (Sequelize relationships), [`src/config/database.js`](https://github.com/aayushdai/job_application_tracker/blob/main/src/config/database.js) (MySQL connection), [`src/models/Application.js`](https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Application.js) (Application records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_api["Express API<br/>[app.js]"]
  node_authroutes["Auth routes<br/>[auth.routes.js]"]
  node_authcontroller["Authentication<br/>[auth.controller.js]"]
  node_authservice["JWT and passwords<br/>[auth.service.js]"]
  node_authmw["JWT middleware<br/>[auth.middleware.js]"]
end

subgraph group_tracking["Job search tracking"]
  node_applications["Applications"]
  node_appcontroller["Application API"]
  node_companies["Companies<br/>[company.service.js]"]
  node_companycontroller["Company API"]
  node_interviews["Interviews"]
  node_interviewcontroller["Interview API"]
  node_dashboard["Dashboard analytics"]
  node_dashboardcontroller["Dashboard API"]
end

subgraph group_support["Job search support"]
  node_documents["Document management"]
  node_documentcontroller["Document API"]
  node_upload["File upload"]
  node_followups["Follow-up tasks"]
  node_followupcontroller["Follow-up API"]
  node_notifications["Notifications"]
  node_notificationcontroller["Notification API"]
  node_followjob["Follow-up scheduler<br/>[followUp.job.js]"]
  node_notificationjob["Notification cleanup"]
end

subgraph group_data["Persistence and automation"]
  node_dbconfig["MySQL connection<br/>[database.js]"]
  node_models["Sequelize relationships<br/>[index.js]"]
  node_applicationmodel[("Application records<br/>[Application.js]")]
  node_companymodel[("Company records<br/>[Company.js]")]
  node_interviewmodel[("Interview records<br/>[Interview.js]")]
  node_followupmodel[("Follow-up records<br/>[FollowUp.js]")]
  node_notificationmodel[("Notification records<br/>[Notification.js]")]
  node_documentmodel[("Document records<br/>[Document.js]")]
  node_usermodel[("User records<br/>[User.js]")]
end

node_client(("API client"))
node_mysql[("MySQL")]
node_files[("Local file storage")]

node_client -->|"sends requests"| node_api
node_api -->|"mounts routes"| node_authroutes
node_api -->|"routes requests"| node_appcontroller
node_api -->|"routes requests"| node_companycontroller
node_api -->|"routes requests"| node_interviewcontroller
node_api -->|"routes requests"| node_documentcontroller
node_api -->|"routes requests"| node_followupcontroller
node_api -->|"routes requests"| node_notificationcontroller
node_api -->|"routes requests"| node_dashboardcontroller
node_authroutes -->|"dispatches to"| node_authcontroller
node_authcontroller -->|"delegates to"| node_authservice
node_authroutes -.->|"authenticates"| node_authmw
node_appcontroller -->|"calls"| node_applications
node_appcontroller -->|"requires user"| node_authmw
node_companycontroller -->|"delegates to"| node_companies
node_interviewcontroller -->|"delegates to"| node_interviews
node_dashboardcontroller -.->|"serves analytics"| node_dashboard
node_documentcontroller -->|"calls"| node_documents
node_documentcontroller -->|"receives uploaded file"| node_upload
node_documentcontroller -->|"downloads files"| node_files
node_followupcontroller -->|"delegates to"| node_followups
node_notificationcontroller -->|"delegates to"| node_notifications
node_followjob -->|"checks due tasks"| node_followupmodel
node_followjob -->|"reads applications"| node_applicationmodel
node_followjob -->|"creates alerts"| node_notificationmodel
node_notificationjob -->|"cleans old alerts"| node_notificationmodel
node_applications -->|"queries records"| node_applicationmodel
node_applications -->|"looks up company"| node_companymodel
node_interviews -->|"queries records"| node_interviewmodel
node_followups -->|"queries records"| node_followupmodel
node_documents -->|"queries records"| node_documentmodel
node_dashboard -->|"aggregates data"| node_applicationmodel
node_dashboard -->|"aggregates data"| node_interviewmodel
node_dashboard -->|"aggregates data"| node_followupmodel
node_authservice -->|"accesses users"| node_usermodel
node_models -->|"associates models"| node_applicationmodel
node_models -->|"associates models"| node_companymodel
node_models -->|"associates models"| node_interviewmodel
node_models -->|"associates models"| node_followupmodel
node_models -->|"associates models"| node_notificationmodel
node_models -->|"associates models"| node_documentmodel
node_models -->|"associates models"| node_usermodel
node_applicationmodel -->|"uses connection"| node_dbconfig
node_companymodel -->|"uses connection"| node_dbconfig
node_interviewmodel -->|"uses connection"| node_dbconfig
node_followupmodel -->|"uses connection"| node_dbconfig
node_notificationmodel -->|"uses connection"| node_dbconfig
node_dbconfig -->|"connects to"| node_mysql

click node_api "https://github.com/aayushdai/job_application_tracker/blob/main/src/app.js"
click node_authroutes "https://github.com/aayushdai/job_application_tracker/blob/main/src/routes/auth.routes.js"
click node_authcontroller "https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/auth.controller.js"
click node_authservice "https://github.com/aayushdai/job_application_tracker/blob/main/src/services/auth.service.js"
click node_authmw "https://github.com/aayushdai/job_application_tracker/blob/main/src/middleware/auth.middleware.js"
click node_applications "https://github.com/aayushdai/job_application_tracker/blob/main/src/services/application.service.js"
click node_appcontroller "https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/application.controller.js"
click node_companies "https://github.com/aayushdai/job_application_tracker/blob/main/src/services/company.service.js"
click node_companycontroller "https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/company.controller.js"
click node_interviews "https://github.com/aayushdai/job_application_tracker/blob/main/src/services/Interview.service.js"
click node_interviewcontroller "https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/interview.controller.js"
click node_dashboard "https://github.com/aayushdai/job_application_tracker/blob/main/src/services/dashboard.service.js"
click node_dashboardcontroller "https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/dashboard.controller.js"
click node_documents "https://github.com/aayushdai/job_application_tracker/blob/main/src/services/document.service.js"
click node_documentcontroller "https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/document.controller.js"
click node_upload "https://github.com/aayushdai/job_application_tracker/blob/main/src/middleware/upload.middleware.js"
click node_followups "https://github.com/aayushdai/job_application_tracker/blob/main/src/services/followUp.service.js"
click node_followupcontroller "https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/followUp.controller.js"
click node_notifications "https://github.com/aayushdai/job_application_tracker/blob/main/src/services/notification.service.js"
click node_notificationcontroller "https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/notification.controller.js"
click node_followjob "https://github.com/aayushdai/job_application_tracker/blob/main/src/jobs/followUp.job.js"
click node_notificationjob "https://github.com/aayushdai/job_application_tracker/blob/main/src/jobs/notification.job.js"
click node_dbconfig "https://github.com/aayushdai/job_application_tracker/blob/main/src/config/database.js"
click node_models "https://github.com/aayushdai/job_application_tracker/blob/main/src/models/index.js"
click node_applicationmodel "https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Application.js"
click node_companymodel "https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Company.js"
click node_interviewmodel "https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Interview.js"
click node_followupmodel "https://github.com/aayushdai/job_application_tracker/blob/main/src/models/FollowUp.js"
click node_notificationmodel "https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Notification.js"
click node_documentmodel "https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Document.js"
click node_usermodel "https://github.com/aayushdai/job_application_tracker/blob/main/src/models/User.js"

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_api,node_authroutes,node_authcontroller,node_authservice,node_authmw,node_client toneBlue
class node_applications,node_appcontroller,node_companies,node_companycontroller,node_interviews,node_interviewcontroller,node_dashboard,node_dashboardcontroller,node_mysql,node_files toneAmber
class node_documents,node_documentcontroller,node_upload,node_followups,node_followupcontroller,node_notifications,node_notificationcontroller,node_followjob,node_notificationjob toneMint
class node_dbconfig,node_models,node_applicationmodel,node_companymodel,node_interviewmodel,node_followupmodel,node_notificationmodel,node_documentmodel,node_usermodel toneRose
```

## Components

### API and access

- [Express API](https://github.com/aayushdai/job_application_tracker/blob/main/src/app.js): `src/app.js`
- [Auth routes](https://github.com/aayushdai/job_application_tracker/blob/main/src/routes/auth.routes.js): `src/routes/auth.routes.js`
- [Authentication](https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/auth.controller.js): `src/controllers/auth.controller.js`
- [JWT and passwords](https://github.com/aayushdai/job_application_tracker/blob/main/src/services/auth.service.js): `src/services/auth.service.js`
- [JWT middleware](https://github.com/aayushdai/job_application_tracker/blob/main/src/middleware/auth.middleware.js): `src/middleware/auth.middleware.js`

### Job search tracking

- [Applications](https://github.com/aayushdai/job_application_tracker/blob/main/src/services/application.service.js): `src/services/application.service.js`
- [Application API](https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/application.controller.js): `src/controllers/application.controller.js`
- [Companies](https://github.com/aayushdai/job_application_tracker/blob/main/src/services/company.service.js): `src/services/company.service.js`
- [Company API](https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/company.controller.js): `src/controllers/company.controller.js`
- [Interviews](https://github.com/aayushdai/job_application_tracker/blob/main/src/services/Interview.service.js): `src/services/Interview.service.js`
- [Interview API](https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/interview.controller.js): `src/controllers/interview.controller.js`
- [Dashboard analytics](https://github.com/aayushdai/job_application_tracker/blob/main/src/services/dashboard.service.js): `src/services/dashboard.service.js`
- [Dashboard API](https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/dashboard.controller.js): `src/controllers/dashboard.controller.js`

### Job search support

- [Document management](https://github.com/aayushdai/job_application_tracker/blob/main/src/services/document.service.js): `src/services/document.service.js`
- [Document API](https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/document.controller.js): `src/controllers/document.controller.js`
- [File upload](https://github.com/aayushdai/job_application_tracker/blob/main/src/middleware/upload.middleware.js): `src/middleware/upload.middleware.js`
- [Follow-up tasks](https://github.com/aayushdai/job_application_tracker/blob/main/src/services/followUp.service.js): `src/services/followUp.service.js`
- [Follow-up API](https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/followUp.controller.js): `src/controllers/followUp.controller.js`
- [Notifications](https://github.com/aayushdai/job_application_tracker/blob/main/src/services/notification.service.js): `src/services/notification.service.js`
- [Notification API](https://github.com/aayushdai/job_application_tracker/blob/main/src/controllers/notification.controller.js): `src/controllers/notification.controller.js`
- [Follow-up scheduler](https://github.com/aayushdai/job_application_tracker/blob/main/src/jobs/followUp.job.js): `src/jobs/followUp.job.js`
- [Notification cleanup](https://github.com/aayushdai/job_application_tracker/blob/main/src/jobs/notification.job.js): `src/jobs/notification.job.js`

### Persistence and automation

- [MySQL connection](https://github.com/aayushdai/job_application_tracker/blob/main/src/config/database.js): `src/config/database.js`
- [Sequelize relationships](https://github.com/aayushdai/job_application_tracker/blob/main/src/models/index.js): `src/models/index.js`
- [Application records](https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Application.js): `src/models/Application.js`
- [Company records](https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Company.js): `src/models/Company.js`
- [Interview records](https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Interview.js): `src/models/Interview.js`
- [Follow-up records](https://github.com/aayushdai/job_application_tracker/blob/main/src/models/FollowUp.js): `src/models/FollowUp.js`
- [Notification records](https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Notification.js): `src/models/Notification.js`
- [Document records](https://github.com/aayushdai/job_application_tracker/blob/main/src/models/Document.js): `src/models/Document.js`
- [User records](https://github.com/aayushdai/job_application_tracker/blob/main/src/models/User.js): `src/models/User.js`

### Other components

- **API client**
- **MySQL**
- **Local file storage**

## Connections

- API client → Express API: sends requests
- Express API → Auth routes: mounts routes (evidence: `src/app.js`)
- Express API → Application API: routes requests (evidence: `src/app.js`)
- Express API → Company API: routes requests (evidence: `src/app.js`)
- Express API → Interview API: routes requests (evidence: `src/app.js`)
- Express API → Document API: routes requests (evidence: `src/app.js`)
- Express API → Follow-up API: routes requests (evidence: `src/app.js`)
- Express API → Notification API: routes requests (evidence: `src/app.js`)
- Express API → Dashboard API: routes requests (evidence: `src/app.js`)
- Auth routes → Authentication: dispatches to
- Authentication → JWT and passwords: delegates to
- Auth routes → JWT middleware: authenticates
- Application API → Applications: calls (evidence: `src/controllers/application.controller.js`)
- Application API → JWT middleware: requires user (evidence: `src/routes/application.routes.js`)
- Company API → Companies: delegates to (evidence: `src/controllers/company.controller.js`)
- Interview API → Interviews: delegates to (evidence: `src/controllers/interview.controller.js`)
- Dashboard API → Dashboard analytics: serves analytics
- Document API → Document management: calls (evidence: `src/controllers/document.controller.js`)
- Document API → File upload: receives uploaded file (evidence: `src/controllers/document.controller.js`)
- Document API → Local file storage: downloads files (evidence: `src/controllers/document.controller.js`)
- Follow-up API → Follow-up tasks: delegates to (evidence: `src/controllers/followUp.controller.js`)
- Notification API → Notifications: delegates to (evidence: `src/controllers/notification.controller.js`)
- Follow-up scheduler → Follow-up records: checks due tasks (evidence: `src/jobs/followUp.job.js`)
- Follow-up scheduler → Application records: reads applications (evidence: `src/jobs/followUp.job.js`)
- Follow-up scheduler → Notification records: creates alerts (evidence: `src/jobs/followUp.job.js`)
- Notification cleanup → Notification records: cleans old alerts (evidence: `src/jobs/notification.job.js`)
- Applications → Application records: queries records (evidence: `src/services/application.service.js`)
- Applications → Company records: looks up company (evidence: `src/services/application.service.js`)
- Interviews → Interview records: queries records (evidence: `src/services/Interview.service.js`)
- Follow-up tasks → Follow-up records: queries records (evidence: `src/services/followUp.service.js`)
- Document management → Document records: queries records (evidence: `src/services/document.service.js`)
- Dashboard analytics → Application records: aggregates data (evidence: `src/services/dashboard.service.js`)
- Dashboard analytics → Interview records: aggregates data (evidence: `src/services/dashboard.service.js`)
- Dashboard analytics → Follow-up records: aggregates data (evidence: `src/services/dashboard.service.js`)
- JWT and passwords → User records: accesses users (evidence: `src/services/auth.service.js`)
- Sequelize relationships → Application records: associates models (evidence: `src/models/index.js`)
- Sequelize relationships → Company records: associates models (evidence: `src/models/index.js`)
- Sequelize relationships → Interview records: associates models (evidence: `src/models/index.js`)
- Sequelize relationships → Follow-up records: associates models (evidence: `src/models/index.js`)
- Sequelize relationships → Notification records: associates models (evidence: `src/models/index.js`)
- Sequelize relationships → Document records: associates models (evidence: `src/models/index.js`)
- Sequelize relationships → User records: associates models (evidence: `src/models/index.js`)
- Application records → MySQL connection: uses connection (evidence: `src/models/Application.js`)
- Company records → MySQL connection: uses connection (evidence: `src/models/Company.js`)
- Interview records → MySQL connection: uses connection (evidence: `src/models/Interview.js`)
- Follow-up records → MySQL connection: uses connection (evidence: `src/models/FollowUp.js`)
- Notification records → MySQL connection: uses connection (evidence: `src/models/Notification.js`)
- MySQL connection → MySQL: connects to (evidence: `src/config/database.js`)
