How vissinkus1/ai-job-portal works
JobMatrix AI is a job-seeking and recruiting portal. Seekers browse and search jobs, apply, track applications, and use recommendations and resume/skill analysis; employers post jobs and manage applicants; administrators oversee users and platform activity. The React client routes users to these workflows and calls an Express API backed by MongoDB. The README documents chat, alerts, analytics, and other capabilities whose implementation was not sampled; those branches are represented at subsystem level. Edges are limited to sampled wiring or README-documented relationships.
Main entry points: App.jsx React application · index.js API routing · applicationController.js Application workflows · api.js HTTP API client
Components 31
Web client
- React application
Client/src/App.jsx - Auth and profile
Client/src/context/AuthContext.jsx - Job discovery
Client/src/pages/Jobs.jsx - Job details
Client/src/pages/JobDetail.jsx - Applications
Client/src/pages/MyApplications.jsx - Employer tools
Client/src/pages/Applicants.jsx - Job alerts
Client/src/pages/JobAlerts.jsx - Recommendations
Client/src/pages/Recommendations.jsx - Resume scoring
Client/src/pages/ResumeScore.jsx - Skill gap analysis
Client/src/pages/SkillGap.jsx - Admin console
Client/src/pages/Admin.jsx - HTTP API client
Client/src/services/api.js
API and workflows
- API routing
server/index.js - Identity workflows
server/controllers/authController.js - Job workflows
server/controllers/jobController.js - Application workflows
server/controllers/applicationController.js - Alert workflows
server/controllers/jobAlertController.js - Skill gap workflow
server/controllers/skillGapController.js - Resume score workflow
server/controllers/resumeScoreController.js
Career intelligence
- Recommendation workflow
server/controllers/recommendationController.js - TF-IDF matching
server/utils/TFIDFEngine.js - Resume parsing
server/utils/resumeParser.js - Resume scorer
server/utils/ResumeScorer.js - Skill gap engine
server/utils/SkillGapEngine.js
Persistent data
- User records
server/models/User.js - Job records
server/models/Job.js - Application records
server/models/Application.js
Runtime services
- Email delivery
server/utils/emailService.js - MongoDB
Other components
- Portal user
- SMTP provider
Connections 44
- Portal user → React application: uses
Client/src/App.jsx - React application → Auth and profile: provides context
Client/src/App.jsx - React application → Job discovery: routes to
Client/src/App.jsx - React application → Job details: routes to
Client/src/App.jsx - React application → Applications: routes to
Client/src/App.jsx - React application → Employer tools: routes to
Client/src/App.jsx - React application → Job alerts: routes to
Client/src/App.jsx - React application → Recommendations: routes to
Client/src/App.jsx - React application → Resume scoring: routes to
Client/src/App.jsx - React application → Skill gap analysis: routes to
Client/src/App.jsx - React application → Admin console: routes to
Client/src/App.jsx - Auth and profile → HTTP API client: calls
Client/src/context/AuthContext.jsx - Admin console → HTTP API client: calls
Client/src/pages/Admin.jsx - Skill gap analysis → HTTP API client: calls
Client/src/pages/SkillGap.jsx - Portal user → HTTP API client: requests services
- HTTP API client → API routing: HTTP requests
- API routing → Identity workflows: routes auth
- API routing → Job workflows: mounts job routes
server/index.js - API routing → Application workflows: mounts application routes
server/index.js - API routing → Alert workflows: mounts alert routes
- API routing → Recommendation workflow: mounts recommendation routes
server/index.js - API routing → Skill gap workflow: mounts skill routes
server/index.js - API routing → Resume score workflow: mounts score routes
server/index.js - Identity workflows → User records: reads and writes
server/controllers/authController.js - Identity workflows → Email delivery: sends verification
server/controllers/authController.js - Job workflows → Job records: manages jobs
server/controllers/jobController.js - Job workflows → Alert workflows: checks matching alerts
server/controllers/jobController.js - Application workflows → Application records: creates and updates
server/controllers/applicationController.js - Application workflows → Job records: reads job
server/controllers/applicationController.js - Application workflows → User records: reads applicant
server/controllers/applicationController.js - Application workflows → Email delivery: sends status email
server/controllers/applicationController.js - Alert workflows → Email delivery: sends alert email
server/controllers/jobAlertController.js - Recommendation workflow → TF-IDF matching: matches jobs
server/controllers/recommendationController.js - Recommendation workflow → Job records: reads jobs
server/controllers/recommendationController.js - Recommendation workflow → User records: reads profiles
server/controllers/recommendationController.js - Skill gap workflow → Skill gap engine: analyzes skills
- Resume score workflow → Resume scorer: scores resume
- Resume scorer → Resume parsing: parses resume
- Skill gap engine → Resume parsing: uses parser
server/utils/SkillGapEngine.js - Email delivery → SMTP provider: sends mail
- API routing → MongoDB: connects database
server/index.js - User records → MongoDB: persists records
- Job records → MongoDB: persists records
- Application records → MongoDB: persists records