# vissinkus1/ai-job-portal architecture

> Architecture diagram of the GitHub repository vissinkus1/ai-job-portal, 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/vissinkus1/ai-job-portal
- Repository: https://github.com/vissinkus1/ai-job-portal

## Overview

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: [`Client/src/App.jsx`](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/App.jsx) (React application), [`server/index.js`](https://github.com/vissinkus1/ai-job-portal/blob/main/server/index.js) (API routing), [`server/controllers/applicationController.js`](https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/applicationController.js) (Application workflows), [`Client/src/services/api.js`](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/services/api.js) (HTTP API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["React application<br/>[App.jsx]"]
  node_authui["Auth and profile<br/>[AuthContext.jsx]"]
  node_searchui["Job discovery<br/>[Jobs.jsx]"]
  node_detailui["Job details<br/>[JobDetail.jsx]"]
  node_applyui["Applications<br/>[MyApplications.jsx]"]
  node_employerui["Employer tools<br/>[Applicants.jsx]"]
  node_alertui["Job alerts<br/>[JobAlerts.jsx]"]
  node_recommendui["Recommendations"]
  node_scoreui["Resume scoring<br/>[ResumeScore.jsx]"]
  node_skillui["Skill gap analysis<br/>[SkillGap.jsx]"]
  node_adminui["Admin console<br/>[Admin.jsx]"]
  node_apiclient["HTTP API client<br/>[api.js]"]
end

subgraph group_server["API and workflows"]
  node_routes["API routing<br/>[index.js]"]
  node_authflow["Identity workflows<br/>[authController.js]"]
  node_jobflow["Job workflows<br/>[jobController.js]"]
  node_applicationflow["Application workflows"]
  node_alertflow["Alert workflows"]
  node_skillflow["Skill gap workflow"]
  node_scoreflow["Resume score workflow"]
end

subgraph group_ai["Career intelligence"]
  node_recommendflow["Recommendation workflow"]
  node_tfidf["TF-IDF matching<br/>[TFIDFEngine.js]"]
  node_resumeparse["Resume parsing<br/>[resumeParser.js]"]
  node_resumescore["Resume scorer<br/>[ResumeScorer.js]"]
  node_skillengine["Skill gap engine<br/>[SkillGapEngine.js]"]
end

subgraph group_data["Persistent data"]
  node_users[("User records<br/>[User.js]")]
  node_jobs[("Job records<br/>[Job.js]")]
  node_applications[("Application records<br/>[Application.js]")]
end

subgraph group_infra["Runtime services"]
  node_email["Email delivery<br/>[emailService.js]"]
  node_mongo[("MongoDB")]
end

node_user(("Portal user"))
node_employers(("SMTP provider"))

node_user -->|"uses"| node_app
node_app -->|"provides context"| node_authui
node_app -->|"routes to"| node_searchui
node_app -->|"routes to"| node_detailui
node_app -->|"routes to"| node_applyui
node_app -->|"routes to"| node_employerui
node_app -.->|"routes to"| node_alertui
node_app -->|"routes to"| node_recommendui
node_app -.->|"routes to"| node_scoreui
node_app -->|"routes to"| node_skillui
node_app -->|"routes to"| node_adminui
node_authui -->|"calls"| node_apiclient
node_adminui -->|"calls"| node_apiclient
node_skillui -->|"calls"| node_apiclient
node_user -.->|"requests services"| node_apiclient
node_apiclient -.->|"HTTP requests"| node_routes
node_routes -->|"routes auth"| node_authflow
node_routes -->|"mounts job routes"| node_jobflow
node_routes -->|"mounts application routes"| node_applicationflow
node_routes -.->|"mounts alert routes"| node_alertflow
node_routes -->|"mounts recommendation routes"| node_recommendflow
node_routes -->|"mounts skill routes"| node_skillflow
node_routes -->|"mounts score routes"| node_scoreflow
node_authflow -->|"reads and writes"| node_users
node_authflow -->|"sends verification"| node_email
node_jobflow -->|"manages jobs"| node_jobs
node_jobflow -->|"checks matching alerts"| node_alertflow
node_applicationflow -->|"creates and updates"| node_applications
node_applicationflow -->|"reads job"| node_jobs
node_applicationflow -->|"reads applicant"| node_users
node_applicationflow -->|"sends status email"| node_email
node_alertflow -->|"sends alert email"| node_email
node_recommendflow -->|"matches jobs"| node_tfidf
node_recommendflow -->|"reads jobs"| node_jobs
node_recommendflow -->|"reads profiles"| node_users
node_skillflow -.->|"analyzes skills"| node_skillengine
node_scoreflow -.->|"scores resume"| node_resumescore
node_resumescore -.->|"parses resume"| node_resumeparse
node_skillengine -->|"uses parser"| node_resumeparse
node_email -.->|"sends mail"| node_employers
node_routes -->|"connects database"| node_mongo
node_users -.->|"persists records"| node_mongo
node_jobs -.->|"persists records"| node_mongo
node_applications -.->|"persists records"| node_mongo

click node_app "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/App.jsx"
click node_authui "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/context/AuthContext.jsx"
click node_searchui "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/Jobs.jsx"
click node_detailui "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/JobDetail.jsx"
click node_applyui "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/MyApplications.jsx"
click node_employerui "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/Applicants.jsx"
click node_alertui "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/JobAlerts.jsx"
click node_recommendui "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/Recommendations.jsx"
click node_scoreui "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/ResumeScore.jsx"
click node_skillui "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/SkillGap.jsx"
click node_adminui "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/Admin.jsx"
click node_apiclient "https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/services/api.js"
click node_routes "https://github.com/vissinkus1/ai-job-portal/blob/main/server/index.js"
click node_authflow "https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/authController.js"
click node_jobflow "https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/jobController.js"
click node_applicationflow "https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/applicationController.js"
click node_alertflow "https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/jobAlertController.js"
click node_recommendflow "https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/recommendationController.js"
click node_tfidf "https://github.com/vissinkus1/ai-job-portal/blob/main/server/utils/TFIDFEngine.js"
click node_resumeparse "https://github.com/vissinkus1/ai-job-portal/blob/main/server/utils/resumeParser.js"
click node_resumescore "https://github.com/vissinkus1/ai-job-portal/blob/main/server/utils/ResumeScorer.js"
click node_skillengine "https://github.com/vissinkus1/ai-job-portal/blob/main/server/utils/SkillGapEngine.js"
click node_skillflow "https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/skillGapController.js"
click node_scoreflow "https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/resumeScoreController.js"
click node_users "https://github.com/vissinkus1/ai-job-portal/blob/main/server/models/User.js"
click node_jobs "https://github.com/vissinkus1/ai-job-portal/blob/main/server/models/Job.js"
click node_applications "https://github.com/vissinkus1/ai-job-portal/blob/main/server/models/Application.js"
click node_email "https://github.com/vissinkus1/ai-job-portal/blob/main/server/utils/emailService.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_authui,node_searchui,node_detailui,node_applyui,node_employerui,node_alertui,node_recommendui,node_scoreui,node_skillui,node_adminui,node_apiclient,node_user toneBlue
class node_routes,node_authflow,node_jobflow,node_applicationflow,node_alertflow,node_skillflow,node_scoreflow toneAmber
class node_recommendflow,node_tfidf,node_resumeparse,node_resumescore,node_skillengine toneMint
class node_users,node_jobs,node_applications toneRose
class node_email,node_mongo,node_employers toneIndigo
```

## Components

### Web client

- [React application](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/App.jsx): `Client/src/App.jsx`
- [Auth and profile](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/context/AuthContext.jsx): `Client/src/context/AuthContext.jsx`
- [Job discovery](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/Jobs.jsx): `Client/src/pages/Jobs.jsx`
- [Job details](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/JobDetail.jsx): `Client/src/pages/JobDetail.jsx`
- [Applications](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/MyApplications.jsx): `Client/src/pages/MyApplications.jsx`
- [Employer tools](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/Applicants.jsx): `Client/src/pages/Applicants.jsx`
- [Job alerts](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/JobAlerts.jsx): `Client/src/pages/JobAlerts.jsx`
- [Recommendations](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/Recommendations.jsx): `Client/src/pages/Recommendations.jsx`
- [Resume scoring](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/ResumeScore.jsx): `Client/src/pages/ResumeScore.jsx`
- [Skill gap analysis](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/SkillGap.jsx): `Client/src/pages/SkillGap.jsx`
- [Admin console](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/pages/Admin.jsx): `Client/src/pages/Admin.jsx`
- [HTTP API client](https://github.com/vissinkus1/ai-job-portal/blob/main/Client/src/services/api.js): `Client/src/services/api.js`

### API and workflows

- [API routing](https://github.com/vissinkus1/ai-job-portal/blob/main/server/index.js): `server/index.js`
- [Identity workflows](https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Job workflows](https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/jobController.js): `server/controllers/jobController.js`
- [Application workflows](https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/applicationController.js): `server/controllers/applicationController.js`
- [Alert workflows](https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/jobAlertController.js): `server/controllers/jobAlertController.js`
- [Skill gap workflow](https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/skillGapController.js): `server/controllers/skillGapController.js`
- [Resume score workflow](https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/resumeScoreController.js): `server/controllers/resumeScoreController.js`

### Career intelligence

- [Recommendation workflow](https://github.com/vissinkus1/ai-job-portal/blob/main/server/controllers/recommendationController.js): `server/controllers/recommendationController.js`
- [TF-IDF matching](https://github.com/vissinkus1/ai-job-portal/blob/main/server/utils/TFIDFEngine.js): `server/utils/TFIDFEngine.js`
- [Resume parsing](https://github.com/vissinkus1/ai-job-portal/blob/main/server/utils/resumeParser.js): `server/utils/resumeParser.js`
- [Resume scorer](https://github.com/vissinkus1/ai-job-portal/blob/main/server/utils/ResumeScorer.js): `server/utils/ResumeScorer.js`
- [Skill gap engine](https://github.com/vissinkus1/ai-job-portal/blob/main/server/utils/SkillGapEngine.js): `server/utils/SkillGapEngine.js`

### Persistent data

- [User records](https://github.com/vissinkus1/ai-job-portal/blob/main/server/models/User.js): `server/models/User.js`
- [Job records](https://github.com/vissinkus1/ai-job-portal/blob/main/server/models/Job.js): `server/models/Job.js`
- [Application records](https://github.com/vissinkus1/ai-job-portal/blob/main/server/models/Application.js): `server/models/Application.js`

### Runtime services

- [Email delivery](https://github.com/vissinkus1/ai-job-portal/blob/main/server/utils/emailService.js): `server/utils/emailService.js`
- **MongoDB**

### Other components

- **Portal user**
- **SMTP provider**

## Connections

- Portal user → React application: uses (evidence: `Client/src/App.jsx`)
- React application → Auth and profile: provides context (evidence: `Client/src/App.jsx`)
- React application → Job discovery: routes to (evidence: `Client/src/App.jsx`)
- React application → Job details: routes to (evidence: `Client/src/App.jsx`)
- React application → Applications: routes to (evidence: `Client/src/App.jsx`)
- React application → Employer tools: routes to (evidence: `Client/src/App.jsx`)
- React application → Job alerts: routes to (evidence: `Client/src/App.jsx`)
- React application → Recommendations: routes to (evidence: `Client/src/App.jsx`)
- React application → Resume scoring: routes to (evidence: `Client/src/App.jsx`)
- React application → Skill gap analysis: routes to (evidence: `Client/src/App.jsx`)
- React application → Admin console: routes to (evidence: `Client/src/App.jsx`)
- Auth and profile → HTTP API client: calls (evidence: `Client/src/context/AuthContext.jsx`)
- Admin console → HTTP API client: calls (evidence: `Client/src/pages/Admin.jsx`)
- Skill gap analysis → HTTP API client: calls (evidence: `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 (evidence: `server/index.js`)
- API routing → Application workflows: mounts application routes (evidence: `server/index.js`)
- API routing → Alert workflows: mounts alert routes
- API routing → Recommendation workflow: mounts recommendation routes (evidence: `server/index.js`)
- API routing → Skill gap workflow: mounts skill routes (evidence: `server/index.js`)
- API routing → Resume score workflow: mounts score routes (evidence: `server/index.js`)
- Identity workflows → User records: reads and writes (evidence: `server/controllers/authController.js`)
- Identity workflows → Email delivery: sends verification (evidence: `server/controllers/authController.js`)
- Job workflows → Job records: manages jobs (evidence: `server/controllers/jobController.js`)
- Job workflows → Alert workflows: checks matching alerts (evidence: `server/controllers/jobController.js`)
- Application workflows → Application records: creates and updates (evidence: `server/controllers/applicationController.js`)
- Application workflows → Job records: reads job (evidence: `server/controllers/applicationController.js`)
- Application workflows → User records: reads applicant (evidence: `server/controllers/applicationController.js`)
- Application workflows → Email delivery: sends status email (evidence: `server/controllers/applicationController.js`)
- Alert workflows → Email delivery: sends alert email (evidence: `server/controllers/jobAlertController.js`)
- Recommendation workflow → TF-IDF matching: matches jobs (evidence: `server/controllers/recommendationController.js`)
- Recommendation workflow → Job records: reads jobs (evidence: `server/controllers/recommendationController.js`)
- Recommendation workflow → User records: reads profiles (evidence: `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 (evidence: `server/utils/SkillGapEngine.js`)
- Email delivery → SMTP provider: sends mail
- API routing → MongoDB: connects database (evidence: `server/index.js`)
- User records → MongoDB: persists records
- Job records → MongoDB: persists records
- Application records → MongoDB: persists records
