# parthnvm/job-portal architecture

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

- Interactive diagram: https://gitdiagram.com/parthnvm/job-portal
- Repository: https://github.com/parthnvm/job-portal

## Overview

JobSphere is a job portal for applicants and recruiters, with account management, job listings and applications, external job aggregation, and resume analysis. The main workflow runs from the portal UI through its API service to backend routes and controllers, which manage domain data; external-job search adds provider aggregation and caching, while resume analysis extracts and evaluates uploaded resumes. The README is empty, so capabilities are inferred from the source tree and indexed references; unsampled links are omitted where their callers are not evidenced.

Main entry points: [`backend/services/jobProviderManager.js`](https://github.com/parthnvm/job-portal/blob/main/backend/services/jobProviderManager.js) (Provider manager), [`frontend/src/App.jsx`](https://github.com/parthnvm/job-portal/blob/main/frontend/src/App.jsx) (Application shell), [`backend/services/externalJobSync.js`](https://github.com/parthnvm/job-portal/blob/main/backend/services/externalJobSync.js) (Job synchronization), [`backend/controllers/user.controller.js`](https://github.com/parthnvm/job-portal/blob/main/backend/controllers/user.controller.js) (Account controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Portal experience"]
  node_app["Application shell<br/>[App.jsx]"]
  node_portal["Job portal<br/>[JobPortal.jsx]"]
  node_applicant["Applicant view"]
  node_recruiter["Recruiter view"]
  node_authui["Authentication UI<br/>[JobPortalAuth.jsx]"]
  node_theme["Theme state<br/>[ThemeContext.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_server["HTTP server<br/>[index.js]"]
  node_user_routes["User routes<br/>[user.routes.js]"]
  node_company_routes["Company routes<br/>[company.route.js]"]
  node_application_routes["Application routes"]
  node_external_routes["External job routes"]
  node_auth["Authentication guard<br/>[isAuthenticated.js]"]
end

subgraph group_jobs["Job discovery"]
  node_application_controller["Application controller"]
  node_application_store[("Applications")]
  node_job_store[("Local jobs<br/>[job.model.js]")]
  node_external_controller["External job controller"]
  node_sync["Job synchronization<br/>[externalJobSync.js]"]
  node_manager["Provider manager"]
  node_adzuna["Adzuna provider"]
  node_jooble["Jooble provider"]
  node_dedup["Job deduplication<br/>[jobDeduplicator.js]"]
  node_rate_limit["Provider rate limits<br/>[rateLimiter.js]"]
  node_external_store[("External jobs")]
  node_search_cache[("Search cache")]
end

subgraph group_accounts["Accounts and analysis"]
  node_user_controller["Account controller<br/>[user.controller.js]"]
  node_resume_extract["Resume extraction<br/>[resumeExtractor.js]"]
  node_resume_analysis["Resume analysis<br/>[groqService.js]"]
  node_analysis_rules["Analysis validation"]
  node_local_analysis["Heuristic analysis"]
  node_resume_store[("Analysis records")]
end

node_user(("Portal user"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_portal
node_app -->|"renders"| node_applicant
node_app -->|"renders"| node_recruiter
node_app -->|"renders"| node_authui
node_portal -->|"calls"| node_api_client
node_portal -->|"uses"| node_theme
node_authui -->|"calls"| node_api_client
node_authui -->|"uses"| node_portal
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_company_routes
node_server -->|"mounts"| node_application_routes
node_server -->|"mounts"| node_external_routes
node_user_routes -->|"guards"| node_auth
node_user_routes -->|"routes to"| node_user_controller
node_company_routes -->|"guards"| node_auth
node_application_routes -->|"guards"| node_auth
node_application_routes -->|"routes to"| node_application_controller
node_external_routes -->|"routes to"| node_external_controller
node_auth -->|"checks users"| node_user_controller
node_user_controller -->|"extracts text"| node_resume_extract
node_user_controller -->|"requests analysis"| node_resume_analysis
node_user_controller -->|"stores analysis"| node_resume_store
node_resume_analysis -->|"validates"| node_analysis_rules
node_resume_analysis -->|"falls back to"| node_local_analysis
node_application_controller -->|"creates and reads"| node_application_store
node_application_controller -->|"checks and updates"| node_job_store
node_external_controller -->|"searches"| node_manager
node_external_controller -->|"triggers"| node_sync
node_sync -->|"queries providers"| node_manager
node_sync -->|"saves jobs"| node_external_store
node_sync -->|"checks limits"| node_rate_limit
node_sync -->|"deduplicates"| node_dedup
node_manager -->|"queries"| node_adzuna
node_manager -->|"queries"| node_jooble
node_manager -->|"deduplicates"| node_dedup
node_manager -->|"checks limits"| node_rate_limit
node_manager -->|"reads and upserts"| node_external_store
node_manager -->|"reads and writes"| node_search_cache

click node_app "https://github.com/parthnvm/job-portal/blob/main/frontend/src/App.jsx"
click node_portal "https://github.com/parthnvm/job-portal/blob/main/frontend/src/JobPortal.jsx"
click node_applicant "https://github.com/parthnvm/job-portal/blob/main/frontend/src/JobPortalApplicantView.jsx"
click node_recruiter "https://github.com/parthnvm/job-portal/blob/main/frontend/src/JobPortalRecruiterView.jsx"
click node_authui "https://github.com/parthnvm/job-portal/blob/main/frontend/src/JobPortalAuth.jsx"
click node_theme "https://github.com/parthnvm/job-portal/blob/main/frontend/src/context/ThemeContext.jsx"
click node_api_client "https://github.com/parthnvm/job-portal/blob/main/frontend/src/services/api.js"
click node_server "https://github.com/parthnvm/job-portal/blob/main/backend/index.js"
click node_user_routes "https://github.com/parthnvm/job-portal/blob/main/backend/routes/user.routes.js"
click node_company_routes "https://github.com/parthnvm/job-portal/blob/main/backend/routes/company.route.js"
click node_application_routes "https://github.com/parthnvm/job-portal/blob/main/backend/routes/application.route.js"
click node_external_routes "https://github.com/parthnvm/job-portal/blob/main/backend/routes/externalJob.route.js"
click node_auth "https://github.com/parthnvm/job-portal/blob/main/backend/middlewares/isAuthenticated.js"
click node_user_controller "https://github.com/parthnvm/job-portal/blob/main/backend/controllers/user.controller.js"
click node_resume_extract "https://github.com/parthnvm/job-portal/blob/main/backend/utils/resumeExtractor.js"
click node_resume_analysis "https://github.com/parthnvm/job-portal/blob/main/backend/services/groqService.js"
click node_analysis_rules "https://github.com/parthnvm/job-portal/blob/main/backend/utils/analysisValidator.js"
click node_local_analysis "https://github.com/parthnvm/job-portal/blob/main/backend/services/heuristicAnalyzer.js"
click node_resume_store "https://github.com/parthnvm/job-portal/blob/main/backend/models/resumeAnalysis.model.js"
click node_application_controller "https://github.com/parthnvm/job-portal/blob/main/backend/controllers/application.controller.js"
click node_application_store "https://github.com/parthnvm/job-portal/blob/main/backend/models/application.model.js"
click node_job_store "https://github.com/parthnvm/job-portal/blob/main/backend/models/job.model.js"
click node_external_controller "https://github.com/parthnvm/job-portal/blob/main/backend/controllers/externalJob.controller.js"
click node_sync "https://github.com/parthnvm/job-portal/blob/main/backend/services/externalJobSync.js"
click node_manager "https://github.com/parthnvm/job-portal/blob/main/backend/services/jobProviderManager.js"
click node_adzuna "https://github.com/parthnvm/job-portal/blob/main/backend/providers/AdzunaJobProvider.js"
click node_jooble "https://github.com/parthnvm/job-portal/blob/main/backend/providers/JoobleJobProvider.js"
click node_dedup "https://github.com/parthnvm/job-portal/blob/main/backend/services/jobDeduplicator.js"
click node_rate_limit "https://github.com/parthnvm/job-portal/blob/main/backend/services/rateLimiter.js"
click node_external_store "https://github.com/parthnvm/job-portal/blob/main/backend/models/externalJob.model.js"
click node_search_cache "https://github.com/parthnvm/job-portal/blob/main/backend/models/searchCache.model.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_app,node_portal,node_applicant,node_recruiter,node_authui,node_theme,node_api_client,node_user toneBlue
class node_server,node_user_routes,node_company_routes,node_application_routes,node_external_routes,node_auth toneAmber
class node_application_controller,node_application_store,node_job_store,node_external_controller,node_sync,node_manager,node_adzuna,node_jooble,node_dedup,node_rate_limit,node_external_store,node_search_cache toneMint
class node_user_controller,node_resume_extract,node_resume_analysis,node_analysis_rules,node_local_analysis,node_resume_store toneRose
```

## Components

### Portal experience

- [Application shell](https://github.com/parthnvm/job-portal/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Job portal](https://github.com/parthnvm/job-portal/blob/main/frontend/src/JobPortal.jsx): `frontend/src/JobPortal.jsx`
- [Applicant view](https://github.com/parthnvm/job-portal/blob/main/frontend/src/JobPortalApplicantView.jsx): `frontend/src/JobPortalApplicantView.jsx`
- [Recruiter view](https://github.com/parthnvm/job-portal/blob/main/frontend/src/JobPortalRecruiterView.jsx): `frontend/src/JobPortalRecruiterView.jsx`
- [Authentication UI](https://github.com/parthnvm/job-portal/blob/main/frontend/src/JobPortalAuth.jsx): `frontend/src/JobPortalAuth.jsx`
- [Theme state](https://github.com/parthnvm/job-portal/blob/main/frontend/src/context/ThemeContext.jsx): `frontend/src/context/ThemeContext.jsx`
- [API client](https://github.com/parthnvm/job-portal/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Backend API

- [HTTP server](https://github.com/parthnvm/job-portal/blob/main/backend/index.js): `backend/index.js`
- [User routes](https://github.com/parthnvm/job-portal/blob/main/backend/routes/user.routes.js): `backend/routes/user.routes.js`
- [Company routes](https://github.com/parthnvm/job-portal/blob/main/backend/routes/company.route.js): `backend/routes/company.route.js`
- [Application routes](https://github.com/parthnvm/job-portal/blob/main/backend/routes/application.route.js): `backend/routes/application.route.js`
- [External job routes](https://github.com/parthnvm/job-portal/blob/main/backend/routes/externalJob.route.js): `backend/routes/externalJob.route.js`
- [Authentication guard](https://github.com/parthnvm/job-portal/blob/main/backend/middlewares/isAuthenticated.js): `backend/middlewares/isAuthenticated.js`

### Job discovery

- [Application controller](https://github.com/parthnvm/job-portal/blob/main/backend/controllers/application.controller.js): `backend/controllers/application.controller.js`
- [Applications](https://github.com/parthnvm/job-portal/blob/main/backend/models/application.model.js): `backend/models/application.model.js`
- [Local jobs](https://github.com/parthnvm/job-portal/blob/main/backend/models/job.model.js): `backend/models/job.model.js`
- [External job controller](https://github.com/parthnvm/job-portal/blob/main/backend/controllers/externalJob.controller.js): `backend/controllers/externalJob.controller.js`
- [Job synchronization](https://github.com/parthnvm/job-portal/blob/main/backend/services/externalJobSync.js): `backend/services/externalJobSync.js`
- [Provider manager](https://github.com/parthnvm/job-portal/blob/main/backend/services/jobProviderManager.js): `backend/services/jobProviderManager.js`
- [Adzuna provider](https://github.com/parthnvm/job-portal/blob/main/backend/providers/AdzunaJobProvider.js): `backend/providers/AdzunaJobProvider.js`
- [Jooble provider](https://github.com/parthnvm/job-portal/blob/main/backend/providers/JoobleJobProvider.js): `backend/providers/JoobleJobProvider.js`
- [Job deduplication](https://github.com/parthnvm/job-portal/blob/main/backend/services/jobDeduplicator.js): `backend/services/jobDeduplicator.js`
- [Provider rate limits](https://github.com/parthnvm/job-portal/blob/main/backend/services/rateLimiter.js): `backend/services/rateLimiter.js`
- [External jobs](https://github.com/parthnvm/job-portal/blob/main/backend/models/externalJob.model.js): `backend/models/externalJob.model.js`
- [Search cache](https://github.com/parthnvm/job-portal/blob/main/backend/models/searchCache.model.js): `backend/models/searchCache.model.js`

### Accounts and analysis

- [Account controller](https://github.com/parthnvm/job-portal/blob/main/backend/controllers/user.controller.js): `backend/controllers/user.controller.js`
- [Resume extraction](https://github.com/parthnvm/job-portal/blob/main/backend/utils/resumeExtractor.js): `backend/utils/resumeExtractor.js`
- [Resume analysis](https://github.com/parthnvm/job-portal/blob/main/backend/services/groqService.js): `backend/services/groqService.js`
- [Analysis validation](https://github.com/parthnvm/job-portal/blob/main/backend/utils/analysisValidator.js): `backend/utils/analysisValidator.js`
- [Heuristic analysis](https://github.com/parthnvm/job-portal/blob/main/backend/services/heuristicAnalyzer.js): `backend/services/heuristicAnalyzer.js`
- [Analysis records](https://github.com/parthnvm/job-portal/blob/main/backend/models/resumeAnalysis.model.js): `backend/models/resumeAnalysis.model.js`

### Other components

- **Portal user**

## Connections

- Portal user → Application shell: uses
- Application shell → Job portal: renders (evidence: `frontend/src/App.jsx`)
- Application shell → Applicant view: renders (evidence: `frontend/src/App.jsx`)
- Application shell → Recruiter view: renders (evidence: `frontend/src/App.jsx`)
- Application shell → Authentication UI: renders (evidence: `frontend/src/App.jsx`)
- Job portal → API client: calls (evidence: `frontend/src/JobPortal.jsx`)
- Job portal → Theme state: uses (evidence: `frontend/src/JobPortal.jsx`)
- Authentication UI → API client: calls (evidence: `frontend/src/JobPortalAuth.jsx`)
- Authentication UI → Job portal: uses (evidence: `frontend/src/JobPortalAuth.jsx`)
- HTTP server → User routes: mounts (evidence: `backend/index.js`)
- HTTP server → Company routes: mounts (evidence: `backend/index.js`)
- HTTP server → Application routes: mounts (evidence: `backend/index.js`)
- HTTP server → External job routes: mounts (evidence: `backend/index.js`)
- User routes → Authentication guard: guards (evidence: `backend/routes/user.routes.js`)
- User routes → Account controller: routes to (evidence: `backend/routes/user.routes.js`)
- Company routes → Authentication guard: guards (evidence: `backend/routes/company.route.js`)
- Application routes → Authentication guard: guards (evidence: `backend/routes/application.route.js`)
- Application routes → Application controller: routes to (evidence: `backend/routes/application.route.js`)
- External job routes → External job controller: routes to (evidence: `backend/routes/externalJob.route.js`)
- Authentication guard → Account controller: checks users (evidence: `backend/middlewares/isAuthenticated.js`)
- Account controller → Resume extraction: extracts text (evidence: `backend/controllers/user.controller.js`)
- Account controller → Resume analysis: requests analysis (evidence: `backend/controllers/user.controller.js`)
- Account controller → Analysis records: stores analysis (evidence: `backend/controllers/user.controller.js`)
- Resume analysis → Analysis validation: validates (evidence: `backend/services/groqService.js`)
- Resume analysis → Heuristic analysis: falls back to (evidence: `backend/services/groqService.js`)
- Application controller → Applications: creates and reads (evidence: `backend/controllers/application.controller.js`)
- Application controller → Local jobs: checks and updates (evidence: `backend/controllers/application.controller.js`)
- External job controller → Provider manager: searches (evidence: `backend/controllers/externalJob.controller.js`)
- External job controller → Job synchronization: triggers (evidence: `backend/controllers/externalJob.controller.js`)
- Job synchronization → Provider manager: queries providers (evidence: `backend/services/externalJobSync.js`)
- Job synchronization → External jobs: saves jobs (evidence: `backend/services/externalJobSync.js`)
- Job synchronization → Provider rate limits: checks limits (evidence: `backend/services/externalJobSync.js`)
- Job synchronization → Job deduplication: deduplicates (evidence: `backend/services/externalJobSync.js`)
- Provider manager → Adzuna provider: queries (evidence: `backend/services/jobProviderManager.js`)
- Provider manager → Jooble provider: queries (evidence: `backend/services/jobProviderManager.js`)
- Provider manager → Job deduplication: deduplicates (evidence: `backend/services/jobProviderManager.js`)
- Provider manager → Provider rate limits: checks limits (evidence: `backend/services/jobProviderManager.js`)
- Provider manager → External jobs: reads and upserts (evidence: `backend/services/jobProviderManager.js`)
- Provider manager → Search cache: reads and writes (evidence: `backend/services/jobProviderManager.js`)
