# 0charanguru/final-year-project architecture

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

- Interactive diagram: https://gitdiagram.com/0charanguru/final-year-project
- Repository: https://github.com/0charanguru/final-year-project

## Overview

Recruit is a job portal connecting job seekers, organizations, and administrators. Job seekers browse openings, apply with a resume, and track applications; organizations manage jobs and review applicant status; administrators oversee users, organizations, and listings. The backend exposes separate route families backed by MongoDB models, with resume scoring, file uploads, and email notifications in the application workflow. The README is empty, and unsampled screens and route implementations limit evidence for some frontend-to-API connections.

Main entry points: [`frontend/src/App.jsx`](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/App.jsx) (Route application), [`backend/Router/jobRoutes.js`](https://github.com/0charanguru/final-year-project/blob/main/backend/Router/jobRoutes.js) (Job workflow routes), [`backend/Router/adminauth.js`](https://github.com/0charanguru/final-year-project/blob/main/backend/Router/adminauth.js) (Admin routes), [`backend/server.js`](https://github.com/0charanguru/final-year-project/blob/main/backend/server.js) (HTTP server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Portal interface"]
  node_app["Route application<br/>[App.jsx]"]
  node_home["Job portal home<br/>[Home.jsx]"]
  node_useraccount["Seeker accounts<br/>[Login.jsx]"]
  node_seekerprofile["Seeker profile<br/>[Profile.jsx]"]
  node_seekerjobs["Browse jobs<br/>[JobList.jsx]"]
  node_seekerapply["Apply and track<br/>[ApplyJob.jsx]"]
  node_orgaccount["Organization accounts<br/>[OrgLogin.jsx]"]
  node_orghome["Organization portal<br/>[OrgHome.jsx]"]
  node_orgjobs["Job management<br/>[AddJobs.jsx]"]
  node_orgapplications["Applicant review<br/>[Application.jsx]"]
  node_adminui["Admin management<br/>[Manage.jsx]"]
end

subgraph group_identity["Accounts and administration"]
  node_userroute["Seeker routes<br/>[userauth.js]"]
  node_orgroute["Organization routes<br/>[orgauth.js]"]
  node_adminroute["Admin routes<br/>[adminauth.js]"]
end

subgraph group_jobs["Jobs and applications"]
  node_jobroute["Job workflow routes<br/>[jobRoutes.js]"]
  node_ats["Resume scoring<br/>[ats.js]"]
end

subgraph group_platform["Backend and persistence"]
  node_server["HTTP server<br/>[server.js]"]
  node_userdb[("Seeker records<br/>[UserModel.js]")]
  node_orgdb[("Organization records<br/>[Orgmodel.js]")]
  node_jobdb[("Job listings<br/>[OrgJobs.js]")]
  node_candidate_db[("Applications")]
  node_admin_db[("Admin records<br/>[admin.js]")]
  node_cloudinary["Media storage client<br/>[cloudinary.js]"]
end

node_seeker(("Job seeker"))
node_orgactor(("Organization user"))
node_adminactor(("Administrator"))
node_mailer["Email service"]

node_seeker -->|"uses"| node_app
node_orgactor -->|"uses"| node_app
node_adminactor -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_useraccount
node_app -->|"routes to"| node_seekerprofile
node_app -->|"routes to"| node_seekerjobs
node_app -->|"routes to"| node_seekerapply
node_app -->|"routes to"| node_orgaccount
node_app -->|"routes to"| node_orghome
node_app -->|"routes to"| node_orgjobs
node_app -->|"routes to"| node_orgapplications
node_app -->|"routes to"| node_adminui
node_server -->|"mounts"| node_userroute
node_server -->|"mounts"| node_orgroute
node_server -->|"mounts"| node_adminroute
node_server -->|"mounts"| node_jobroute
node_userroute -->|"uses records"| node_userdb
node_orgroute -->|"uses records"| node_orgdb
node_orgroute -->|"manages listings"| node_jobdb
node_orgroute -->|"uploads media"| node_cloudinary
node_adminroute -->|"manages records"| node_userdb
node_adminroute -->|"manages records"| node_orgdb
node_adminroute -->|"manages listings"| node_jobdb
node_adminroute -->|"queries applications"| node_candidate_db
node_adminroute -->|"authenticates admins"| node_admin_db
node_jobroute -->|"checks organization"| node_orgdb
node_jobroute -->|"reads listings"| node_jobdb
node_jobroute -->|"stores and updates"| node_candidate_db
node_jobroute -->|"uploads resumes"| node_cloudinary
node_jobroute -->|"scores resume"| node_ats
node_jobroute -->|"sends email"| node_mailer
node_orgapplications -->|"fetches and updates applicants"| node_jobroute

click node_app "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Home/Home.jsx"
click node_useraccount "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Loginpage/Login.jsx"
click node_seekerprofile "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Dashboard/Profile.jsx"
click node_seekerjobs "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Jobs/JobList.jsx"
click node_seekerapply "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Dashboard/ApplyJob.jsx"
click node_orgaccount "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Organization/OrgLogin.jsx"
click node_orghome "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Organization/Org-home/OrgHome.jsx"
click node_orgjobs "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Organization/OrgDashComponents/AddJobs.jsx"
click node_orgapplications "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Organization/OrgDashComponents/Application.jsx"
click node_adminui "https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Admin/Manage.jsx"
click node_server "https://github.com/0charanguru/final-year-project/blob/main/backend/server.js"
click node_userroute "https://github.com/0charanguru/final-year-project/blob/main/backend/Router/userauth.js"
click node_orgroute "https://github.com/0charanguru/final-year-project/blob/main/backend/Router/orgauth.js"
click node_adminroute "https://github.com/0charanguru/final-year-project/blob/main/backend/Router/adminauth.js"
click node_jobroute "https://github.com/0charanguru/final-year-project/blob/main/backend/Router/jobRoutes.js"
click node_userdb "https://github.com/0charanguru/final-year-project/blob/main/backend/Models/UserModel.js"
click node_orgdb "https://github.com/0charanguru/final-year-project/blob/main/backend/Models/Orgmodel.js"
click node_jobdb "https://github.com/0charanguru/final-year-project/blob/main/backend/Models/OrgJobs.js"
click node_candidate_db "https://github.com/0charanguru/final-year-project/blob/main/backend/Models/AppliedCandidate.js"
click node_admin_db "https://github.com/0charanguru/final-year-project/blob/main/backend/Models/admin.js"
click node_cloudinary "https://github.com/0charanguru/final-year-project/blob/main/backend/Models/cloudinary.js"
click node_ats "https://github.com/0charanguru/final-year-project/blob/main/backend/ats.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_home,node_useraccount,node_seekerprofile,node_seekerjobs,node_seekerapply,node_orgaccount,node_orghome,node_orgjobs,node_orgapplications,node_adminui,node_orgactor toneBlue
class node_userroute,node_orgroute,node_adminroute toneAmber
class node_jobroute,node_ats toneMint
class node_server,node_userdb,node_orgdb,node_jobdb,node_candidate_db,node_admin_db,node_cloudinary toneRose
class node_seeker,node_adminactor,node_mailer toneIndigo
```

## Components

### Portal interface

- [Route application](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Job portal home](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Home/Home.jsx): `frontend/src/Components/Home/Home.jsx`
- [Seeker accounts](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Loginpage/Login.jsx): `frontend/src/Components/Loginpage/Login.jsx`
- [Seeker profile](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Dashboard/Profile.jsx): `frontend/src/Components/Dashboard/Profile.jsx`
- [Browse jobs](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Jobs/JobList.jsx): `frontend/src/Components/Jobs/JobList.jsx`
- [Apply and track](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Dashboard/ApplyJob.jsx): `frontend/src/Components/Dashboard/ApplyJob.jsx`
- [Organization accounts](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Organization/OrgLogin.jsx): `frontend/src/Components/Organization/OrgLogin.jsx`
- [Organization portal](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Organization/Org-home/OrgHome.jsx): `frontend/src/Components/Organization/Org-home/OrgHome.jsx`
- [Job management](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Organization/OrgDashComponents/AddJobs.jsx): `frontend/src/Components/Organization/OrgDashComponents/AddJobs.jsx`
- [Applicant review](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Organization/OrgDashComponents/Application.jsx): `frontend/src/Components/Organization/OrgDashComponents/Application.jsx`
- [Admin management](https://github.com/0charanguru/final-year-project/blob/main/frontend/src/Components/Admin/Manage.jsx): `frontend/src/Components/Admin/Manage.jsx`

### Accounts and administration

- [Seeker routes](https://github.com/0charanguru/final-year-project/blob/main/backend/Router/userauth.js): `backend/Router/userauth.js`
- [Organization routes](https://github.com/0charanguru/final-year-project/blob/main/backend/Router/orgauth.js): `backend/Router/orgauth.js`
- [Admin routes](https://github.com/0charanguru/final-year-project/blob/main/backend/Router/adminauth.js): `backend/Router/adminauth.js`

### Jobs and applications

- [Job workflow routes](https://github.com/0charanguru/final-year-project/blob/main/backend/Router/jobRoutes.js): `backend/Router/jobRoutes.js`
- [Resume scoring](https://github.com/0charanguru/final-year-project/blob/main/backend/ats.js): `backend/ats.js`

### Backend and persistence

- [HTTP server](https://github.com/0charanguru/final-year-project/blob/main/backend/server.js): `backend/server.js`
- [Seeker records](https://github.com/0charanguru/final-year-project/blob/main/backend/Models/UserModel.js): `backend/Models/UserModel.js`
- [Organization records](https://github.com/0charanguru/final-year-project/blob/main/backend/Models/Orgmodel.js): `backend/Models/Orgmodel.js`
- [Job listings](https://github.com/0charanguru/final-year-project/blob/main/backend/Models/OrgJobs.js): `backend/Models/OrgJobs.js`
- [Applications](https://github.com/0charanguru/final-year-project/blob/main/backend/Models/AppliedCandidate.js): `backend/Models/AppliedCandidate.js`
- [Admin records](https://github.com/0charanguru/final-year-project/blob/main/backend/Models/admin.js): `backend/Models/admin.js`
- [Media storage client](https://github.com/0charanguru/final-year-project/blob/main/backend/Models/cloudinary.js): `backend/Models/cloudinary.js`

### Other components

- **Job seeker**
- **Organization user**
- **Administrator**
- **Email service**

## Connections

- Job seeker → Route application: uses (evidence: `frontend/src/App.jsx`)
- Organization user → Route application: uses (evidence: `frontend/src/App.jsx`)
- Administrator → Route application: uses (evidence: `frontend/src/App.jsx`)
- Route application → Job portal home: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Seeker accounts: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Seeker profile: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Browse jobs: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Apply and track: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Organization accounts: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Organization portal: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Job management: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Applicant review: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Admin management: routes to (evidence: `frontend/src/App.jsx`)
- HTTP server → Seeker routes: mounts (evidence: `backend/server.js`)
- HTTP server → Organization routes: mounts (evidence: `backend/server.js`)
- HTTP server → Admin routes: mounts (evidence: `backend/server.js`)
- HTTP server → Job workflow routes: mounts (evidence: `backend/server.js`)
- Seeker routes → Seeker records: uses records (evidence: `backend/Router/userauth.js`)
- Organization routes → Organization records: uses records (evidence: `backend/Router/orgauth.js`)
- Organization routes → Job listings: manages listings (evidence: `backend/Router/orgauth.js`)
- Organization routes → Media storage client: uploads media (evidence: `backend/Router/orgauth.js`)
- Admin routes → Seeker records: manages records (evidence: `backend/Router/adminauth.js`)
- Admin routes → Organization records: manages records (evidence: `backend/Router/adminauth.js`)
- Admin routes → Job listings: manages listings (evidence: `backend/Router/adminauth.js`)
- Admin routes → Applications: queries applications (evidence: `backend/Router/adminauth.js`)
- Admin routes → Admin records: authenticates admins (evidence: `backend/Router/adminauth.js`)
- Job workflow routes → Organization records: checks organization (evidence: `backend/Router/jobRoutes.js`)
- Job workflow routes → Job listings: reads listings (evidence: `backend/Router/jobRoutes.js`)
- Job workflow routes → Applications: stores and updates (evidence: `backend/Router/jobRoutes.js`)
- Job workflow routes → Media storage client: uploads resumes (evidence: `backend/Router/jobRoutes.js`)
- Job workflow routes → Resume scoring: scores resume (evidence: `backend/Router/jobRoutes.js`)
- Job workflow routes → Email service: sends email (evidence: `backend/Router/jobRoutes.js`)
- Applicant review → Job workflow routes: fetches and updates applicants (evidence: `frontend/src/Components/Organization/OrgDashComponents/Application.jsx`)
