# naveendpsn25/application-tracking-system architecture

> Architecture diagram of the GitHub repository naveendpsn25/application-tracking-system, 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/naveendpsn25/application-tracking-system
- Repository: https://github.com/naveendpsn25/application-tracking-system

## Overview

TalentBridge is a recruiting and applicant-tracking application with candidate and recruiter experiences. Candidates register and verify accounts, maintain profiles, browse jobs, and handle invitations; recruiters manage jobs, candidates, and applications. The graph preserves these distinct domain areas and the authentication, routing, service, and persistence layers. Evidence is limited to the supplied excerpts and SOURCE INDEX; unsampled backend domains are included where supported by the tree, but uncertain connections are omitted.

Main entry points: [`frontend/src/routes/CandidateRoutes.jsx`](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/routes/CandidateRoutes.jsx) (Candidate routes), [`backend/accounts/services/auth_service.py`](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/accounts/services/auth_service.py) (Authentication service), [`frontend/src/routes/RecruiterRoutes.jsx`](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/routes/RecruiterRoutes.jsx) (Recruiter routes), [`frontend/src/services/candidate/candidateService.js`](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/services/candidate/candidateService.js) (Candidate service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_user["User and OTP<br/>[models.py]"]
  node_auth_service["Authentication service<br/>[auth_service.py]"]
  node_otp_service["OTP service<br/>[otp_service.py]"]
  node_email_service["Verification email<br/>[email_service.py]"]
  node_auth_api["Auth API client<br/>[authService.js]"]
  node_auth_state["Authentication state<br/>[authStore.js]"]
end

subgraph group_candidate["Candidate experience"]
  node_candidate_routes["Candidate routes"]
  node_candidate_dashboard["Candidate dashboard"]
  node_candidate_jobs["Job discovery<br/>[Jobs.jsx]"]
  node_candidate_invitations["Invitation handling<br/>[Invitations.jsx]"]
  node_invitation_details["Invitation details"]
  node_candidate_profile["Candidate profile"]
  node_candidate_service["Candidate service"]
end

subgraph group_recruiter["Recruiter experience"]
  node_recruiter_routes["Recruiter routes"]
  node_recruiter_jobs["Job management<br/>[JobDetails.jsx]"]
  node_recruiter_candidates["Candidate review"]
  node_recruiter_applications["Application management<br/>[Applications.jsx]"]
  node_invited_applications["Invited applications"]
  node_application_service["Application service"]
end

subgraph group_backend["Backend domain"]
  node_jobs_domain["Jobs domain<br/>[models.py]"]
  node_applications_domain["Applications and invitations<br/>[models.py]"]
  node_candidate_domain["Candidate records<br/>[models.py]"]
  node_recruiter_domain["Recruiter records<br/>[models.py]"]
  node_interviews_domain["Interview records<br/>[models.py]"]
  node_offers_domain["Offer records<br/>[models.py]"]
end

node_auth_service -->|"creates user"| node_user
node_auth_service -->|"generates OTP"| node_otp_service
node_auth_service -->|"sends verification"| node_email_service
node_otp_service -->|"sends OTP"| node_email_service
node_auth_api -.->|"provides auth data"| node_auth_state
node_candidate_routes -->|"routes to"| node_candidate_dashboard
node_candidate_routes -->|"routes to"| node_candidate_jobs
node_candidate_routes -->|"routes to"| node_candidate_invitations
node_candidate_routes -->|"routes to"| node_invitation_details
node_candidate_routes -->|"routes to"| node_candidate_profile
node_candidate_dashboard -->|"requests data"| node_candidate_service
node_candidate_invitations -->|"requests data"| node_candidate_service
node_invitation_details -->|"requests data"| node_candidate_service
node_recruiter_routes -->|"routes to"| node_recruiter_jobs
node_recruiter_routes -->|"routes to"| node_recruiter_candidates
node_recruiter_routes -->|"routes to"| node_recruiter_applications
node_recruiter_applications -->|"renders tab"| node_invited_applications
node_invited_applications -->|"requests data"| node_application_service

click node_user "https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/accounts/models.py"
click node_auth_service "https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/accounts/services/auth_service.py"
click node_otp_service "https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/accounts/services/otp_service.py"
click node_email_service "https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/accounts/services/email_service.py"
click node_auth_api "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/services/auth/authService.js"
click node_auth_state "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/store/auth/authStore.js"
click node_candidate_routes "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/routes/CandidateRoutes.jsx"
click node_candidate_dashboard "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Candidate/CandidateDashboard.jsx"
click node_candidate_jobs "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Candidate/Jobs/Jobs.jsx"
click node_candidate_invitations "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Candidate/Invitations/Invitations.jsx"
click node_invitation_details "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Candidate/Invitations/InvitationDetails/InvitationDetails.jsx"
click node_candidate_profile "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Candidate/Profile/CandidateProfile.jsx"
click node_candidate_service "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/services/candidate/candidateService.js"
click node_recruiter_routes "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/routes/RecruiterRoutes.jsx"
click node_recruiter_jobs "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/components/Recruiter/Jobs/JobDetails/JobDetails.jsx"
click node_recruiter_candidates "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/components/Recruiter/Candidates/CandidateDetails/CandidateDetails.jsx"
click node_recruiter_applications "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Recruiter/Applications/Applications.jsx"
click node_invited_applications "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/components/Recruiter/Applications/InvitedApplications/InvitedApplications.jsx"
click node_application_service "https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/services/recruiter/applicationService.js"
click node_jobs_domain "https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/jobs/models.py"
click node_applications_domain "https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/applications/models.py"
click node_candidate_domain "https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/candidates/models.py"
click node_recruiter_domain "https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/recruiters/models.py"
click node_interviews_domain "https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/interviews/models.py"
click node_offers_domain "https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/offers/models.py"

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_user,node_auth_service,node_otp_service,node_email_service,node_auth_api,node_auth_state toneBlue
class node_candidate_routes,node_candidate_dashboard,node_candidate_jobs,node_candidate_invitations,node_invitation_details,node_candidate_profile,node_candidate_service toneAmber
class node_recruiter_routes,node_recruiter_jobs,node_recruiter_candidates,node_recruiter_applications,node_invited_applications,node_application_service toneMint
class node_jobs_domain,node_applications_domain,node_candidate_domain,node_recruiter_domain,node_interviews_domain,node_offers_domain toneRose
```

## Components

### Identity and access

- [User and OTP](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/accounts/models.py): `backend/accounts/models.py`
- [Authentication service](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/accounts/services/auth_service.py): `backend/accounts/services/auth_service.py`
- [OTP service](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/accounts/services/otp_service.py): `backend/accounts/services/otp_service.py`
- [Verification email](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/accounts/services/email_service.py): `backend/accounts/services/email_service.py`
- [Auth API client](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/services/auth/authService.js): `frontend/src/services/auth/authService.js`
- [Authentication state](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/store/auth/authStore.js): `frontend/src/store/auth/authStore.js`

### Candidate experience

- [Candidate routes](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/routes/CandidateRoutes.jsx): `frontend/src/routes/CandidateRoutes.jsx`
- [Candidate dashboard](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Candidate/CandidateDashboard.jsx): `frontend/src/pages/Candidate/CandidateDashboard.jsx`
- [Job discovery](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Candidate/Jobs/Jobs.jsx): `frontend/src/pages/Candidate/Jobs/Jobs.jsx`
- [Invitation handling](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Candidate/Invitations/Invitations.jsx): `frontend/src/pages/Candidate/Invitations/Invitations.jsx`
- [Invitation details](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Candidate/Invitations/InvitationDetails/InvitationDetails.jsx): `frontend/src/pages/Candidate/Invitations/InvitationDetails/InvitationDetails.jsx`
- [Candidate profile](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Candidate/Profile/CandidateProfile.jsx): `frontend/src/pages/Candidate/Profile/CandidateProfile.jsx`
- [Candidate service](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/services/candidate/candidateService.js): `frontend/src/services/candidate/candidateService.js`

### Recruiter experience

- [Recruiter routes](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/routes/RecruiterRoutes.jsx): `frontend/src/routes/RecruiterRoutes.jsx`
- [Job management](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/components/Recruiter/Jobs/JobDetails/JobDetails.jsx): `frontend/src/components/Recruiter/Jobs/JobDetails/JobDetails.jsx`
- [Candidate review](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/components/Recruiter/Candidates/CandidateDetails/CandidateDetails.jsx): `frontend/src/components/Recruiter/Candidates/CandidateDetails/CandidateDetails.jsx`
- [Application management](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/pages/Recruiter/Applications/Applications.jsx): `frontend/src/pages/Recruiter/Applications/Applications.jsx`
- [Invited applications](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/components/Recruiter/Applications/InvitedApplications/InvitedApplications.jsx): `frontend/src/components/Recruiter/Applications/InvitedApplications/InvitedApplications.jsx`
- [Application service](https://github.com/naveendpsn25/application-tracking-system/blob/master/frontend/src/services/recruiter/applicationService.js): `frontend/src/services/recruiter/applicationService.js`

### Backend domain

- [Jobs domain](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/jobs/models.py): `backend/jobs/models.py`
- [Applications and invitations](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/applications/models.py): `backend/applications/models.py`
- [Candidate records](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/candidates/models.py): `backend/candidates/models.py`
- [Recruiter records](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/recruiters/models.py): `backend/recruiters/models.py`
- [Interview records](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/interviews/models.py): `backend/interviews/models.py`
- [Offer records](https://github.com/naveendpsn25/application-tracking-system/blob/master/backend/offers/models.py): `backend/offers/models.py`

## Connections

- Authentication service → User and OTP: creates user (evidence: `backend/accounts/services/auth_service.py`)
- Authentication service → OTP service: generates OTP (evidence: `backend/accounts/services/auth_service.py`)
- Authentication service → Verification email: sends verification (evidence: `backend/accounts/services/auth_service.py`)
- OTP service → Verification email: sends OTP (evidence: `backend/accounts/services/otp_service.py`)
- Auth API client → Authentication state: provides auth data
- Candidate routes → Candidate dashboard: routes to (evidence: `frontend/src/routes/CandidateRoutes.jsx`)
- Candidate routes → Job discovery: routes to (evidence: `frontend/src/routes/CandidateRoutes.jsx`)
- Candidate routes → Invitation handling: routes to (evidence: `frontend/src/routes/CandidateRoutes.jsx`)
- Candidate routes → Invitation details: routes to (evidence: `frontend/src/routes/CandidateRoutes.jsx`)
- Candidate routes → Candidate profile: routes to (evidence: `frontend/src/routes/CandidateRoutes.jsx`)
- Candidate dashboard → Candidate service: requests data (evidence: `frontend/src/pages/Candidate/CandidateDashboard.jsx`)
- Invitation handling → Candidate service: requests data (evidence: `frontend/src/pages/Candidate/Invitations/Invitations.jsx`)
- Invitation details → Candidate service: requests data (evidence: `frontend/src/pages/Candidate/Invitations/InvitationDetails/InvitationDetails.jsx`)
- Recruiter routes → Job management: routes to (evidence: `frontend/src/routes/RecruiterRoutes.jsx`)
- Recruiter routes → Candidate review: routes to (evidence: `frontend/src/routes/RecruiterRoutes.jsx`)
- Recruiter routes → Application management: routes to (evidence: `frontend/src/routes/RecruiterRoutes.jsx`)
- Application management → Invited applications: renders tab (evidence: `frontend/src/pages/Recruiter/Applications/Applications.jsx`)
- Invited applications → Application service: requests data (evidence: `frontend/src/components/Recruiter/Applications/InvitedApplications/InvitedApplications.jsx`)
