How parthnvm/job-portal works
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: jobProviderManager.js Provider manager · App.jsx Application shell · externalJobSync.js Job synchronization · user.controller.js Account controller
Components 32
Portal experience
- Application shell
frontend/src/App.jsx - Job portal
frontend/src/JobPortal.jsx - Applicant view
frontend/src/JobPortalApplicantView.jsx - Recruiter view
frontend/src/JobPortalRecruiterView.jsx - Authentication UI
frontend/src/JobPortalAuth.jsx - Theme state
frontend/src/context/ThemeContext.jsx - API client
frontend/src/services/api.js
Backend API
- HTTP server
backend/index.js - User routes
backend/routes/user.routes.js - Company routes
backend/routes/company.route.js - Application routes
backend/routes/application.route.js - External job routes
backend/routes/externalJob.route.js - Authentication guard
backend/middlewares/isAuthenticated.js
Job discovery
- Application controller
backend/controllers/application.controller.js - Applications
backend/models/application.model.js - Local jobs
backend/models/job.model.js - External job controller
backend/controllers/externalJob.controller.js - Job synchronization
backend/services/externalJobSync.js - Provider manager
backend/services/jobProviderManager.js - Adzuna provider
backend/providers/AdzunaJobProvider.js - Jooble provider
backend/providers/JoobleJobProvider.js - Job deduplication
backend/services/jobDeduplicator.js - Provider rate limits
backend/services/rateLimiter.js - External jobs
backend/models/externalJob.model.js - Search cache
backend/models/searchCache.model.js
Accounts and analysis
- Account controller
backend/controllers/user.controller.js - Resume extraction
backend/utils/resumeExtractor.js - Resume analysis
backend/services/groqService.js - Analysis validation
backend/utils/analysisValidator.js - Heuristic analysis
backend/services/heuristicAnalyzer.js - Analysis records
backend/models/resumeAnalysis.model.js
Other components
- Portal user
Connections 39
- Portal user → Application shell: uses
- Application shell → Job portal: renders
frontend/src/App.jsx - Application shell → Applicant view: renders
frontend/src/App.jsx - Application shell → Recruiter view: renders
frontend/src/App.jsx - Application shell → Authentication UI: renders
frontend/src/App.jsx - Job portal → API client: calls
frontend/src/JobPortal.jsx - Job portal → Theme state: uses
frontend/src/JobPortal.jsx - Authentication UI → API client: calls
frontend/src/JobPortalAuth.jsx - Authentication UI → Job portal: uses
frontend/src/JobPortalAuth.jsx - HTTP server → User routes: mounts
backend/index.js - HTTP server → Company routes: mounts
backend/index.js - HTTP server → Application routes: mounts
backend/index.js - HTTP server → External job routes: mounts
backend/index.js - User routes → Authentication guard: guards
backend/routes/user.routes.js - User routes → Account controller: routes to
backend/routes/user.routes.js - Company routes → Authentication guard: guards
backend/routes/company.route.js - Application routes → Authentication guard: guards
backend/routes/application.route.js - Application routes → Application controller: routes to
backend/routes/application.route.js - External job routes → External job controller: routes to
backend/routes/externalJob.route.js - Authentication guard → Account controller: checks users
backend/middlewares/isAuthenticated.js - Account controller → Resume extraction: extracts text
backend/controllers/user.controller.js - Account controller → Resume analysis: requests analysis
backend/controllers/user.controller.js - Account controller → Analysis records: stores analysis
backend/controllers/user.controller.js - Resume analysis → Analysis validation: validates
backend/services/groqService.js - Resume analysis → Heuristic analysis: falls back to
backend/services/groqService.js - Application controller → Applications: creates and reads
backend/controllers/application.controller.js - Application controller → Local jobs: checks and updates
backend/controllers/application.controller.js - External job controller → Provider manager: searches
backend/controllers/externalJob.controller.js - External job controller → Job synchronization: triggers
backend/controllers/externalJob.controller.js - Job synchronization → Provider manager: queries providers
backend/services/externalJobSync.js - Job synchronization → External jobs: saves jobs
backend/services/externalJobSync.js - Job synchronization → Provider rate limits: checks limits
backend/services/externalJobSync.js - Job synchronization → Job deduplication: deduplicates
backend/services/externalJobSync.js - Provider manager → Adzuna provider: queries
backend/services/jobProviderManager.js - Provider manager → Jooble provider: queries
backend/services/jobProviderManager.js - Provider manager → Job deduplication: deduplicates
backend/services/jobProviderManager.js - Provider manager → Provider rate limits: checks limits
backend/services/jobProviderManager.js - Provider manager → External jobs: reads and upserts
backend/services/jobProviderManager.js - Provider manager → Search cache: reads and writes
backend/services/jobProviderManager.js