# dineshrajbhar-cloud/ai-powered-jobportal architecture

> Architecture diagram of the GitHub repository dineshrajbhar-cloud/ai-powered-jobportal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dineshrajbhar-cloud/ai-powered-jobportal
- Repository: https://github.com/dineshrajbhar-cloud/ai-powered-jobportal

## Overview

This is a full-stack recruitment portal: candidates browse jobs, apply with resumes, track application status, and use AI resume matching; recruiters manage postings and applicants. The React frontend calls a Spring Boot API for authentication and portal operations. Resume matching is documented as a separate FastAPI service that extracts PDF text, fetches jobs, and uses Groq to return matches. The README documents the service boundaries; several backend and frontend implementation details were not sampled, so those links are cited to the README or left unasserted.

Main entry points: [`jobportal-frontend/src/lib/api.js`](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/lib/api.js) (API client), [`jobportal-frontend/src/App.jsx`](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/App.jsx) (React app), [`src/main/java/com/dinesh/jobportal/repositories`](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/tree/main/src/main/java/com/dinesh/jobportal/repositories) (JPA repositories), [`ai-service/main.py`](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/ai-service/main.py) (AI endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_react["React app<br/>[App.jsx]"]
  node_candidate_pages["Candidate workflows"]
  node_recruiter_pages["Recruiter workflows"]
  node_resume_matcher["Resume matcher<br/>[ResumeMatcher.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_job_client["Job client<br/>[jobService.js]"]
  node_application_client["Application client"]
  node_ai_client["AI client<br/>[aiService.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth_state["Auth context<br/>[AuthContext.jsx]"]
  node_auth_client["Auth client<br/>[authService.js]"]
  node_auth_api["Auth API"]
  node_auth_service["Authentication service"]
end

subgraph group_recruitment["Recruitment backend"]
  node_job_api["Job API<br/>[JobController.java]"]
  node_job_service["Job service"]
  node_application_api["Application API"]
  node_application_service["Application service"]
  node_dashboard["Dashboards"]
end

subgraph group_ai["AI matching"]
  node_spring_ai["AI bridge<br/>[AiServiceImpl.java]"]
  node_fastapi["AI endpoints<br/>[main.py]"]
  node_pdf["PDF extraction<br/>[main.py]"]
  node_job_fetch["Job fetcher<br/>[job_service.py]"]
  node_groq_service["Groq integration<br/>[groq_service.py]"]
end

subgraph group_state["Persistent data"]
  node_mysql[("MySQL")]
  node_repositories["JPA repositories"]
end

node_candidate(("Candidate"))
node_recruiter(("Recruiter"))

node_candidate -->|"uses"| node_react
node_recruiter -->|"uses"| node_react
node_react -->|"routes to"| node_candidate_pages
node_react -->|"routes to"| node_recruiter_pages
node_candidate_pages -.->|"manages applications"| node_application_client
node_recruiter_pages -.->|"manages applicants"| node_application_client
node_auth_state -->|"uses"| node_auth_client
node_auth_client -->|"requests"| node_api_client
node_job_client -->|"requests"| node_api_client
node_application_client -->|"requests"| node_api_client
node_ai_client -.->|"requests"| node_api_client
node_react -->|"provides auth"| node_auth_state
node_api_client -->|"calls REST API"| node_auth_api
node_api_client -->|"calls REST API"| node_job_api
node_api_client -->|"calls REST API"| node_application_api
node_auth_api -.->|"delegates"| node_auth_service
node_auth_service -->|"reads and saves"| node_repositories
node_job_api -->|"delegates"| node_job_service
node_application_api -->|"delegates"| node_application_service
node_job_service -.->|"accesses jobs"| node_repositories
node_application_service -.->|"accesses applications"| node_repositories
node_dashboard -.->|"aggregates data"| node_repositories
node_repositories -->|"persists records"| node_mysql
node_resume_matcher -.->|"requests matching"| node_ai_client
node_spring_ai -->|"forwards resume"| node_fastapi
node_fastapi -->|"extracts text"| node_pdf
node_fastapi -->|"fetches jobs"| node_job_fetch
node_fastapi -->|"requests analysis"| node_groq_service
node_job_fetch -->|"fetches available jobs"| node_job_api
node_groq_service -->|"returns match results"| node_candidate

click node_react "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/App.jsx"
click node_candidate_pages "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/tree/main/jobportal-frontend/src/pages/candidate"
click node_recruiter_pages "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/tree/main/jobportal-frontend/src/pages/recruiter"
click node_resume_matcher "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/pages/ResumeMatcher.jsx"
click node_auth_state "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/context/AuthContext.jsx"
click node_auth_client "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/services/authService.js"
click node_api_client "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/lib/api.js"
click node_job_client "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/services/jobService.js"
click node_application_client "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/services/applicationService.js"
click node_ai_client "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/services/aiService.js"
click node_auth_api "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/controller/AuthController.java"
click node_auth_service "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/serviceImpl/AuthServiceImpl.java"
click node_job_api "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/controller/JobController.java"
click node_job_service "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/serviceImpl/JobServiceImpl.java"
click node_application_api "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/controller/ApplicationController.java"
click node_application_service "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/serviceImpl/ApplicationServiceImpl.java"
click node_dashboard "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/serviceImpl/DashboardServiceImpl.java"
click node_spring_ai "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/serviceImpl/AiServiceImpl.java"
click node_fastapi "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/ai-service/main.py"
click node_pdf "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/ai-service/main.py"
click node_job_fetch "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/ai-service/job_service.py"
click node_groq_service "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/ai-service/groq_service.py"
click node_repositories "https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/tree/main/src/main/java/com/dinesh/jobportal/repositories"

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_react,node_candidate_pages,node_recruiter_pages,node_resume_matcher,node_api_client,node_job_client,node_application_client,node_ai_client toneBlue
class node_auth_state,node_auth_client,node_auth_api,node_auth_service toneAmber
class node_job_api,node_job_service,node_application_api,node_application_service,node_dashboard toneMint
class node_spring_ai,node_fastapi,node_pdf,node_job_fetch,node_groq_service toneRose
class node_mysql,node_repositories,node_candidate,node_recruiter toneIndigo
```

## Components

### Web application

- [React app](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/App.jsx): `jobportal-frontend/src/App.jsx`
- [Candidate workflows](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/tree/main/jobportal-frontend/src/pages/candidate): `jobportal-frontend/src/pages/candidate`
- [Recruiter workflows](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/tree/main/jobportal-frontend/src/pages/recruiter): `jobportal-frontend/src/pages/recruiter`
- [Resume matcher](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/pages/ResumeMatcher.jsx): `jobportal-frontend/src/pages/ResumeMatcher.jsx`
- [API client](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/lib/api.js): `jobportal-frontend/src/lib/api.js`
- [Job client](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/services/jobService.js): `jobportal-frontend/src/services/jobService.js`
- [Application client](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/services/applicationService.js): `jobportal-frontend/src/services/applicationService.js`
- [AI client](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/services/aiService.js): `jobportal-frontend/src/services/aiService.js`

### Identity and access

- [Auth context](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/context/AuthContext.jsx): `jobportal-frontend/src/context/AuthContext.jsx`
- [Auth client](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/jobportal-frontend/src/services/authService.js): `jobportal-frontend/src/services/authService.js`
- [Auth API](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/controller/AuthController.java): `src/main/java/com/dinesh/jobportal/controller/AuthController.java`
- [Authentication service](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/serviceImpl/AuthServiceImpl.java): `src/main/java/com/dinesh/jobportal/serviceImpl/AuthServiceImpl.java`

### Recruitment backend

- [Job API](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/controller/JobController.java): `src/main/java/com/dinesh/jobportal/controller/JobController.java`
- [Job service](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/serviceImpl/JobServiceImpl.java): `src/main/java/com/dinesh/jobportal/serviceImpl/JobServiceImpl.java`
- [Application API](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/controller/ApplicationController.java): `src/main/java/com/dinesh/jobportal/controller/ApplicationController.java`
- [Application service](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/serviceImpl/ApplicationServiceImpl.java): `src/main/java/com/dinesh/jobportal/serviceImpl/ApplicationServiceImpl.java`
- [Dashboards](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/serviceImpl/DashboardServiceImpl.java): `src/main/java/com/dinesh/jobportal/serviceImpl/DashboardServiceImpl.java`

### AI matching

- [AI bridge](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/src/main/java/com/dinesh/jobportal/serviceImpl/AiServiceImpl.java): `src/main/java/com/dinesh/jobportal/serviceImpl/AiServiceImpl.java`
- [AI endpoints](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/ai-service/main.py): `ai-service/main.py`
- [PDF extraction](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/ai-service/main.py): `ai-service/main.py`
- [Job fetcher](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/ai-service/job_service.py): `ai-service/job_service.py`
- [Groq integration](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/blob/main/ai-service/groq_service.py): `ai-service/groq_service.py`

### Persistent data

- **MySQL**
- [JPA repositories](https://github.com/dineshrajbhar-cloud/ai-powered-jobportal/tree/main/src/main/java/com/dinesh/jobportal/repositories): `src/main/java/com/dinesh/jobportal/repositories`

### Other components

- **Candidate**
- **Recruiter**

## Connections

- Candidate → React app: uses (evidence: `README.md`)
- Recruiter → React app: uses (evidence: `README.md`)
- React app → Candidate workflows: routes to (evidence: `jobportal-frontend/src/App.jsx`)
- React app → Recruiter workflows: routes to (evidence: `jobportal-frontend/src/App.jsx`)
- Candidate workflows → Application client: manages applications
- Recruiter workflows → Application client: manages applicants
- Auth context → Auth client: uses (evidence: `jobportal-frontend/src/context/AuthContext.jsx`)
- Auth client → API client: requests (evidence: `jobportal-frontend/src/services/authService.js`)
- Job client → API client: requests (evidence: `jobportal-frontend/src/services/jobService.js`)
- Application client → API client: requests (evidence: `jobportal-frontend/src/services/applicationService.js`)
- AI client → API client: requests
- React app → Auth context: provides auth (evidence: `jobportal-frontend/src/main.jsx`)
- API client → Auth API: calls REST API (evidence: `README.md`)
- API client → Job API: calls REST API (evidence: `README.md`)
- API client → Application API: calls REST API (evidence: `README.md`)
- Auth API → Authentication service: delegates
- Authentication service → JPA repositories: reads and saves (evidence: `src/main/java/com/dinesh/jobportal/serviceImpl/AuthServiceImpl.java`)
- Job API → Job service: delegates (evidence: `src/main/java/com/dinesh/jobportal/controller/JobController.java`)
- Application API → Application service: delegates (evidence: `src/main/java/com/dinesh/jobportal/controller/ApplicationController.java`)
- Job service → JPA repositories: accesses jobs
- Application service → JPA repositories: accesses applications
- Dashboards → JPA repositories: aggregates data
- JPA repositories → MySQL: persists records (evidence: `README.md`)
- Resume matcher → AI client: requests matching (evidence: `jobportal-frontend/src/pages/ResumeMatcher.jsx`)
- AI bridge → AI endpoints: forwards resume (evidence: `README.md`)
- AI endpoints → PDF extraction: extracts text (evidence: `ai-service/main.py`)
- AI endpoints → Job fetcher: fetches jobs (evidence: `ai-service/main.py`)
- AI endpoints → Groq integration: requests analysis (evidence: `ai-service/main.py`)
- Job fetcher → Job API: fetches available jobs (evidence: `README.md`)
- Groq integration → Candidate: returns match results (evidence: `README.md`)
