# hemanshi-0812/hireup architecture

> Architecture diagram of the GitHub repository hemanshi-0812/hireup, 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/hemanshi-0812/hireup
- Repository: https://github.com/hemanshi-0812/hireup

## Overview

HireUp is a role-based recruitment platform. Candidates and recruiters use the web app to manage profiles, jobs, and applications; recruiters review applicants and update application status, while admins oversee platform data and analytics. The Node/Express API handles authentication and recruitment workflows against MongoDB, and a FastAPI service provides resume analysis and generative AI capabilities. The README documents the backend as the AI request proxy; the detailed AI-to-backend wiring is not shown in the sampled source.

Main entry points: [`frontend/src/App.jsx`](https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/App.jsx) (App routes), [`backend/src/controllers/recruiterController.js`](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/controllers/recruiterController.js) (Recruiter workflows), [`backend/src/models/User.js`](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/models/User.js) (User profiles), [`backend/server.js`](https://github.com/hemanshi-0812/hireup/blob/main/backend/server.js) (API server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App routes<br/>[App.jsx]"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_landing["Landing page<br/>[Landing.jsx]"]
  node_login["Login page<br/>[Login.jsx]"]
  node_register["Registration page<br/>[Register.jsx]"]
  node_dashboards["Role dashboards"]
  node_frontendapi["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_server["API server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Authentication<br/>[authController.js]"]
  node_authguard["Role access<br/>[authMiddleware.js]"]
  node_recruitroutes["Recruiter routes<br/>[recruiterRoutes.js]"]
end

subgraph group_recruitment["Recruitment domain"]
  node_recruitcontroller["Recruiter workflows"]
  node_candidatecontroller["Candidate workflows"]
  node_admincontroller["Admin oversight<br/>[adminController.js]"]
  node_jobmodel[("Jobs and companies<br/>[Job.js]")]
  node_applicationmodel[("Applications<br/>[Application.js]")]
  node_usermodel[("User profiles<br/>[User.js]")]
end

subgraph group_intelligence["AI services"]
  node_aimain["AI service entry<br/>[main.py]"]
  node_analyze["Resume analysis<br/>[analyze.py]"]
  node_parser["Resume parser<br/>[parser.py]"]
  node_matcher["Job matcher<br/>[matcher.py]"]
  node_aistore["AI data access<br/>[database.py]"]
  node_advancedai["Generative AI routes<br/>[advanced.py]"]
  node_generative["Generative tools<br/>[generative.py]"]
  node_profileanalyzer["Profile analysis"]
end

node_user(("Platform user"))
node_mongodb[("MongoDB")]

node_user -->|"uses"| node_app
node_app -->|"provides auth"| node_authstate
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"routes to"| node_dashboards
node_login -->|"uses"| node_authstate
node_login -->|"requests data"| node_frontendapi
node_register -->|"uses"| node_authstate
node_register -->|"requests data"| node_frontendapi
node_frontendapi -.->|"calls API"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_recruitroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_recruitroutes -->|"dispatches"| node_recruitcontroller
node_recruitroutes -->|"protects routes"| node_authguard
node_authcontroller -->|"reads and writes"| node_usermodel
node_authguard -->|"loads user"| node_usermodel
node_recruitcontroller -->|"manages jobs"| node_jobmodel
node_recruitcontroller -->|"manages applications"| node_applicationmodel
node_recruitcontroller -->|"updates profile link"| node_usermodel
node_recruitcontroller -.->|"persists records"| node_mongodb
node_candidatecontroller -->|"accesses profiles"| node_usermodel
node_candidatecontroller -->|"manages applications"| node_applicationmodel
node_admincontroller -->|"administers users"| node_usermodel
node_admincontroller -->|"reports on jobs"| node_jobmodel
node_admincontroller -->|"reports on applications"| node_applicationmodel
node_aimain -->|"includes route"| node_analyze
node_aimain -->|"includes route"| node_advancedai
node_analyze -->|"parses resume"| node_parser
node_analyze -->|"scores match"| node_matcher
node_analyze -->|"reads and saves"| node_aistore
node_aistore -->|"connects to"| node_mongodb
node_advancedai -->|"calls tools"| node_generative
node_advancedai -->|"calls analyzer"| node_profileanalyzer
node_server -.->|"proxies AI requests"| node_aimain

click node_app "https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/App.jsx"
click node_authstate "https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/context/AuthContext.jsx"
click node_landing "https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/pages/Landing.jsx"
click node_login "https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/pages/auth/Login.jsx"
click node_register "https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/pages/auth/Register.jsx"
click node_dashboards "https://github.com/hemanshi-0812/hireup/tree/main/frontend/src/pages/dashboards"
click node_frontendapi "https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/services/api.js"
click node_server "https://github.com/hemanshi-0812/hireup/blob/main/backend/server.js"
click node_authroutes "https://github.com/hemanshi-0812/hireup/blob/main/backend/src/routes/authRoutes.js"
click node_authcontroller "https://github.com/hemanshi-0812/hireup/blob/main/backend/src/controllers/authController.js"
click node_authguard "https://github.com/hemanshi-0812/hireup/blob/main/backend/src/middlewares/authMiddleware.js"
click node_recruitroutes "https://github.com/hemanshi-0812/hireup/blob/main/backend/src/routes/recruiterRoutes.js"
click node_recruitcontroller "https://github.com/hemanshi-0812/hireup/blob/main/backend/src/controllers/recruiterController.js"
click node_candidatecontroller "https://github.com/hemanshi-0812/hireup/blob/main/backend/src/controllers/candidateController.js"
click node_admincontroller "https://github.com/hemanshi-0812/hireup/blob/main/backend/src/controllers/adminController.js"
click node_jobmodel "https://github.com/hemanshi-0812/hireup/blob/main/backend/src/models/Job.js"
click node_applicationmodel "https://github.com/hemanshi-0812/hireup/blob/main/backend/src/models/Application.js"
click node_usermodel "https://github.com/hemanshi-0812/hireup/blob/main/backend/src/models/User.js"
click node_aimain "https://github.com/hemanshi-0812/hireup/blob/main/ai/main.py"
click node_analyze "https://github.com/hemanshi-0812/hireup/blob/main/ai/routes/analyze.py"
click node_parser "https://github.com/hemanshi-0812/hireup/blob/main/ai/services/parser.py"
click node_matcher "https://github.com/hemanshi-0812/hireup/blob/main/ai/services/matcher.py"
click node_aistore "https://github.com/hemanshi-0812/hireup/blob/main/ai/database.py"
click node_advancedai "https://github.com/hemanshi-0812/hireup/blob/main/ai/routes/advanced.py"
click node_generative "https://github.com/hemanshi-0812/hireup/blob/main/ai/services/generative.py"
click node_profileanalyzer "https://github.com/hemanshi-0812/hireup/blob/main/ai/services/profile_analyzer.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_app,node_authstate,node_landing,node_login,node_register,node_dashboards,node_frontendapi,node_user toneBlue
class node_server,node_authroutes,node_authcontroller,node_authguard,node_recruitroutes,node_mongodb toneAmber
class node_recruitcontroller,node_candidatecontroller,node_admincontroller,node_jobmodel,node_applicationmodel,node_usermodel toneMint
class node_aimain,node_analyze,node_parser,node_matcher,node_aistore,node_advancedai,node_generative,node_profileanalyzer toneRose
```

## Components

### Web application

- [App routes](https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth state](https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Landing page](https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/pages/Landing.jsx): `frontend/src/pages/Landing.jsx`
- [Login page](https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/pages/auth/Login.jsx): `frontend/src/pages/auth/Login.jsx`
- [Registration page](https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/pages/auth/Register.jsx): `frontend/src/pages/auth/Register.jsx`
- [Role dashboards](https://github.com/hemanshi-0812/hireup/tree/main/frontend/src/pages/dashboards): `frontend/src/pages/dashboards`
- [API client](https://github.com/hemanshi-0812/hireup/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API and access

- [API server](https://github.com/hemanshi-0812/hireup/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Authentication](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Role access](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/middlewares/authMiddleware.js): `backend/src/middlewares/authMiddleware.js`
- [Recruiter routes](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/routes/recruiterRoutes.js): `backend/src/routes/recruiterRoutes.js`

### Recruitment domain

- [Recruiter workflows](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/controllers/recruiterController.js): `backend/src/controllers/recruiterController.js`
- [Candidate workflows](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/controllers/candidateController.js): `backend/src/controllers/candidateController.js`
- [Admin oversight](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/controllers/adminController.js): `backend/src/controllers/adminController.js`
- [Jobs and companies](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/models/Job.js): `backend/src/models/Job.js`
- [Applications](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/models/Application.js): `backend/src/models/Application.js`
- [User profiles](https://github.com/hemanshi-0812/hireup/blob/main/backend/src/models/User.js): `backend/src/models/User.js`

### AI services

- [AI service entry](https://github.com/hemanshi-0812/hireup/blob/main/ai/main.py): `ai/main.py`
- [Resume analysis](https://github.com/hemanshi-0812/hireup/blob/main/ai/routes/analyze.py): `ai/routes/analyze.py`
- [Resume parser](https://github.com/hemanshi-0812/hireup/blob/main/ai/services/parser.py): `ai/services/parser.py`
- [Job matcher](https://github.com/hemanshi-0812/hireup/blob/main/ai/services/matcher.py): `ai/services/matcher.py`
- [AI data access](https://github.com/hemanshi-0812/hireup/blob/main/ai/database.py): `ai/database.py`
- [Generative AI routes](https://github.com/hemanshi-0812/hireup/blob/main/ai/routes/advanced.py): `ai/routes/advanced.py`
- [Generative tools](https://github.com/hemanshi-0812/hireup/blob/main/ai/services/generative.py): `ai/services/generative.py`
- [Profile analysis](https://github.com/hemanshi-0812/hireup/blob/main/ai/services/profile_analyzer.py): `ai/services/profile_analyzer.py`

### Other components

- **Platform user**
- **MongoDB**

## Connections

- Platform user → App routes: uses
- App routes → Auth state: provides auth (evidence: `frontend/src/App.jsx`)
- App routes → Landing page: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Login page: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Registration page: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Role dashboards: routes to (evidence: `frontend/src/App.jsx`)
- Login page → Auth state: uses (evidence: `frontend/src/pages/auth/Login.jsx`)
- Login page → API client: requests data (evidence: `frontend/src/pages/auth/Login.jsx`)
- Registration page → Auth state: uses (evidence: `frontend/src/pages/auth/Register.jsx`)
- Registration page → API client: requests data (evidence: `frontend/src/pages/auth/Register.jsx`)
- API client → API server: calls API
- API server → Auth routes: mounts (evidence: `backend/server.js`)
- API server → Recruiter routes: mounts (evidence: `backend/server.js`)
- Auth routes → Authentication: dispatches (evidence: `backend/src/routes/authRoutes.js`)
- Recruiter routes → Recruiter workflows: dispatches (evidence: `backend/src/routes/recruiterRoutes.js`)
- Recruiter routes → Role access: protects routes (evidence: `backend/src/routes/recruiterRoutes.js`)
- Authentication → User profiles: reads and writes (evidence: `backend/src/controllers/authController.js`)
- Role access → User profiles: loads user (evidence: `backend/src/middlewares/authMiddleware.js`)
- Recruiter workflows → Jobs and companies: manages jobs (evidence: `backend/src/controllers/recruiterController.js`)
- Recruiter workflows → Applications: manages applications (evidence: `backend/src/controllers/recruiterController.js`)
- Recruiter workflows → User profiles: updates profile link (evidence: `backend/src/controllers/recruiterController.js`)
- Recruiter workflows → MongoDB: persists records
- Candidate workflows → User profiles: accesses profiles (evidence: `backend/src/controllers/candidateController.js`)
- Candidate workflows → Applications: manages applications (evidence: `backend/src/controllers/candidateController.js`)
- Admin oversight → User profiles: administers users (evidence: `backend/src/controllers/adminController.js`)
- Admin oversight → Jobs and companies: reports on jobs (evidence: `backend/src/controllers/adminController.js`)
- Admin oversight → Applications: reports on applications (evidence: `backend/src/controllers/adminController.js`)
- AI service entry → Resume analysis: includes route (evidence: `ai/main.py`)
- AI service entry → Generative AI routes: includes route (evidence: `ai/main.py`)
- Resume analysis → Resume parser: parses resume (evidence: `ai/routes/analyze.py`)
- Resume analysis → Job matcher: scores match (evidence: `ai/routes/analyze.py`)
- Resume analysis → AI data access: reads and saves (evidence: `ai/routes/analyze.py`)
- AI data access → MongoDB: connects to (evidence: `ai/database.py`)
- Generative AI routes → Generative tools: calls tools (evidence: `ai/routes/advanced.py`)
- Generative AI routes → Profile analysis: calls analyzer (evidence: `ai/routes/advanced.py`)
- API server → AI service entry: proxies AI requests
