# codewithrishabh09/ai-resume-matcher architecture

> Architecture diagram of the GitHub repository codewithrishabh09/ai-resume-matcher, 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/codewithrishabh09/ai-resume-matcher
- Repository: https://github.com/codewithrishabh09/ai-resume-matcher

## Overview

ResumeAI is a two-sided job/resume matching platform: job seekers upload resumes, discover jobs, review compatibility, and apply; employers post jobs, assess candidate matches, and manage applications. The documented analysis flow extracts and cleans resume text, identifies skills, computes matching features, and produces scores and skill gaps. React pages call a FastAPI API; backend services, persisted records, and Celery tasks support the workflow. The README documents additional capabilities not fully sampled; unsampled implementation links are omitted rather than inferred.

Main entry points: [`backend/app/workers/tasks.py`](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/workers/tasks.py) (Background tasks), [`frontend/src/App.jsx`](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/frontend/src/App.jsx) (Role-based app), [`backend/app/main.py`](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/main.py) (FastAPI application), [`frontend/src/api/axios.js`](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/frontend/src/api/axios.js) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_frontend["Role-based app<br/>[App.jsx]"]
  node_seeker_workflows["Seeker workflows"]
  node_employer_workflows["Employer workflows"]
  node_auth_ui["Sign-in and registration<br/>[authStore.js]"]
  node_http_client["HTTP client<br/>[axios.js]"]
end

subgraph group_api["API and services"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_api_routes["REST endpoints"]
  node_auth_service["Authentication service<br/>[auth_service.py]"]
  node_resume_service["Resume service<br/>[resume_service.py]"]
  node_job_service["Job service<br/>[job_service.py]"]
  node_matching_service["Matching service"]
  node_worker_tasks["Background tasks<br/>[tasks.py]"]
end

subgraph group_analysis["Resume analysis"]
  node_parsing["Resume parsing"]
  node_preprocessing["Text and skill processing"]
  node_ml_matching["ML matching<br/>[matcher.py]"]
  node_similarity["Similarity features<br/>[similarity.py]"]
end

subgraph group_state["Persistence and infrastructure"]
  node_models["Domain records"]
  node_database[("PostgreSQL<br/>[database.py]")]
  node_cache[("Redis cache<br/>[cache.py]")]
  node_rate_limiter["Rate limiting<br/>[rate_limiter.py]"]
end

node_seekers(("Job seekers"))
node_employers(("Employers"))

node_seekers -->|"use"| node_frontend
node_employers -->|"use"| node_frontend
node_frontend -->|"routes to"| node_seeker_workflows
node_frontend -->|"routes to"| node_employer_workflows
node_frontend -->|"reads auth state"| node_auth_ui
node_seeker_workflows -->|"calls"| node_http_client
node_employer_workflows -->|"calls"| node_http_client
node_auth_ui -->|"calls"| node_http_client
node_http_client -->|"sends requests"| node_api_app
node_api_app -->|"registers"| node_api_routes
node_api_app -->|"configures"| node_rate_limiter
node_api_routes -->|"queries and writes"| node_database
node_auth_service -->|"queries and writes"| node_database
node_resume_service -->|"queues parsing"| node_worker_tasks
node_worker_tasks -->|"extracts text"| node_parsing
node_worker_tasks -->|"cleans and extracts"| node_preprocessing
node_worker_tasks -->|"runs matching"| node_ml_matching
node_ml_matching -->|"uses"| node_similarity
node_matching_service -->|"calls"| node_ml_matching
node_worker_tasks -->|"reads and saves analyses"| node_database
node_database -->|"maps records"| node_models
node_api_app -.->|"uses caching"| node_cache

click node_frontend "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/frontend/src/App.jsx"
click node_seeker_workflows "https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/frontend/src/pages/seeker"
click node_employer_workflows "https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/frontend/src/pages/employer"
click node_auth_ui "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/frontend/src/store/authStore.js"
click node_http_client "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/frontend/src/api/axios.js"
click node_api_app "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/main.py"
click node_api_routes "https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/backend/app/api/routes"
click node_auth_service "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/services/auth_service.py"
click node_resume_service "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/services/resume_service.py"
click node_job_service "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/services/job_service.py"
click node_matching_service "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/services/matching_service.py"
click node_worker_tasks "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/workers/tasks.py"
click node_parsing "https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/backend/app/utils"
click node_preprocessing "https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/backend/app/ml/preprocessing"
click node_ml_matching "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/ml/inference/matcher.py"
click node_similarity "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/ml/models/similarity.py"
click node_models "https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/backend/app/models"
click node_database "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/core/database.py"
click node_cache "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/core/cache.py"
click node_rate_limiter "https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/core/rate_limiter.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_frontend,node_seeker_workflows,node_employer_workflows,node_auth_ui,node_http_client toneBlue
class node_api_app,node_api_routes,node_auth_service,node_resume_service,node_job_service,node_matching_service,node_worker_tasks toneAmber
class node_parsing,node_preprocessing,node_ml_matching,node_similarity toneMint
class node_models,node_database,node_cache,node_rate_limiter toneRose
class node_seekers,node_employers toneIndigo
```

## Components

### User experience

- [Role-based app](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Seeker workflows](https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/frontend/src/pages/seeker): `frontend/src/pages/seeker`
- [Employer workflows](https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/frontend/src/pages/employer): `frontend/src/pages/employer`
- [Sign-in and registration](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/frontend/src/store/authStore.js): `frontend/src/store/authStore.js`
- [HTTP client](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### API and services

- [FastAPI application](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/main.py): `backend/app/main.py`
- [REST endpoints](https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/backend/app/api/routes): `backend/app/api/routes`
- [Authentication service](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`
- [Resume service](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/services/resume_service.py): `backend/app/services/resume_service.py`
- [Job service](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/services/job_service.py): `backend/app/services/job_service.py`
- [Matching service](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/services/matching_service.py): `backend/app/services/matching_service.py`
- [Background tasks](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/workers/tasks.py): `backend/app/workers/tasks.py`

### Resume analysis

- [Resume parsing](https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/backend/app/utils): `backend/app/utils`
- [Text and skill processing](https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/backend/app/ml/preprocessing): `backend/app/ml/preprocessing`
- [ML matching](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/ml/inference/matcher.py): `backend/app/ml/inference/matcher.py`
- [Similarity features](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/ml/models/similarity.py): `backend/app/ml/models/similarity.py`

### Persistence and infrastructure

- [Domain records](https://github.com/codewithrishabh09/ai-resume-matcher/tree/main/backend/app/models): `backend/app/models`
- [PostgreSQL](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Redis cache](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/core/cache.py): `backend/app/core/cache.py`
- [Rate limiting](https://github.com/codewithrishabh09/ai-resume-matcher/blob/main/backend/app/core/rate_limiter.py): `backend/app/core/rate_limiter.py`

### Other components

- **Job seekers**
- **Employers**

## Connections

- Job seekers → Role-based app: use (evidence: `README.md`)
- Employers → Role-based app: use (evidence: `README.md`)
- Role-based app → Seeker workflows: routes to (evidence: `frontend/src/App.jsx`)
- Role-based app → Employer workflows: routes to (evidence: `frontend/src/App.jsx`)
- Role-based app → Sign-in and registration: reads auth state (evidence: `frontend/src/App.jsx`)
- Seeker workflows → HTTP client: calls (evidence: `frontend/src/pages/seeker/UploadResume.jsx`)
- Employer workflows → HTTP client: calls (evidence: `frontend/src/pages/employer/PostJob.jsx`)
- Sign-in and registration → HTTP client: calls (evidence: `frontend/src/store/authStore.js`)
- HTTP client → FastAPI application: sends requests (evidence: `README.md`)
- FastAPI application → REST endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → Rate limiting: configures (evidence: `backend/app/main.py`)
- REST endpoints → PostgreSQL: queries and writes (evidence: `backend/app/api/routes/applications.py`)
- Authentication service → PostgreSQL: queries and writes (evidence: `backend/app/services/auth_service.py`)
- Resume service → Background tasks: queues parsing (evidence: `backend/app/services/resume_service.py`)
- Background tasks → Resume parsing: extracts text (evidence: `backend/app/workers/tasks.py`)
- Background tasks → Text and skill processing: cleans and extracts (evidence: `backend/app/workers/tasks.py`)
- Background tasks → ML matching: runs matching (evidence: `backend/app/workers/tasks.py`)
- ML matching → Similarity features: uses (evidence: `backend/app/ml/inference/matcher.py`)
- Matching service → ML matching: calls (evidence: `backend/app/services/matching_service.py`)
- Background tasks → PostgreSQL: reads and saves analyses (evidence: `backend/app/workers/tasks.py`)
- PostgreSQL → Domain records: maps records (evidence: `backend/app/core/database.py`)
- FastAPI application → Redis cache: uses caching
