# revaldo007/resume-scanner architecture

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

## Overview

This is a full-stack resume analysis and candidate-screening application. A user signs in, defines job requirements, uploads resumes for parsing and NLP extraction, then screens and compares candidates using explainable scores and reviews results in analysis, history, and dashboard views. The graph connects evidenced frontend routes and API calls to backend handlers and processing stages; schema/model storage and authentication are included. Some UI pages and backend implementation details were not excerpted, so their internal links are omitted where evidence is unavailable.

Main entry points: [`backend/app/database.py`](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/database.py) (Database session), [`frontend/src/App.jsx`](https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/App.jsx) (App routes), [`backend/app/main.py`](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/routers/screening.py`](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/screening.py) (Screening routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_routes["App routes<br/>[App.jsx]"]
  node_authstate["Auth session<br/>[AuthContext.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_authui["Login and register<br/>[Login.jsx]"]
  node_jobsui["Job management<br/>[Jobs.jsx]"]
  node_resumeui["Resume upload<br/>[ResumeUpload.jsx]"]
  node_analysisui["Analysis and compare"]
  node_historyui["History and dashboard"]
end

subgraph group_backend["API and workflows"]
  node_app["FastAPI application<br/>[main.py]"]
  node_auth["Authentication routes<br/>[auth.py]"]
  node_jobroutes["Job routes<br/>[jobs.py]"]
  node_resumeroutes["Resume routes<br/>[resumes.py]"]
  node_screenroutes["Screening routes<br/>[screening.py]"]
  node_dashboard["Dashboard statistics<br/>[dashboard.py]"]
  node_security["Token security<br/>[security.py]"]
end

subgraph group_processing["Resume processing"]
  node_parser["Document parser<br/>[resume_parser.py]"]
  node_nlp["NLP extraction<br/>[nlp_processor.py]"]
  node_matching["Candidate matching<br/>[matching_engine.py]"]
end

subgraph group_data["Persistence"]
  node_dbsession["Database session<br/>[database.py]"]
  node_users[("User records<br/>[user.py]")]
  node_jobs[("Job requirements<br/>[job.py]")]
  node_resumes[("Resume records<br/>[resume.py]")]
  node_results[("Screening results<br/>[screening.py]")]
end

node_user(("User"))
node_sqlite[("SQLite")]

node_user -->|"uses"| node_routes
node_routes -->|"routes to"| node_authui
node_routes -->|"routes to"| node_jobsui
node_routes -->|"routes to"| node_resumeui
node_routes -->|"routes to"| node_analysisui
node_routes -->|"routes to"| node_historyui
node_routes -->|"provides session"| node_authstate
node_authui -->|"signs in"| node_authstate
node_authstate -->|"calls"| node_api
node_jobsui -->|"calls"| node_api
node_resumeui -->|"uploads"| node_api
node_analysisui -->|"requests results"| node_api
node_historyui -.->|"requests history"| node_api
node_api -->|"HTTP requests"| node_app
node_app -->|"registers router"| node_auth
node_app -->|"registers router"| node_jobroutes
node_app -->|"registers router"| node_resumeroutes
node_app -->|"registers router"| node_screenroutes
node_app -->|"registers router"| node_dashboard
node_auth -->|"opens session"| node_dbsession
node_jobroutes -->|"opens session"| node_dbsession
node_resumeroutes -->|"opens session"| node_dbsession
node_screenroutes -->|"opens session"| node_dbsession
node_dashboard -->|"opens session"| node_dbsession
node_auth -->|"hashes and tokens"| node_security
node_auth -->|"queries and writes"| node_users
node_resumeroutes -->|"parses documents"| node_parser
node_resumeroutes -->|"extracts fields"| node_nlp
node_resumeroutes -->|"stores resume"| node_resumes
node_jobroutes -->|"manages requirements"| node_jobs
node_screenroutes -->|"scores candidates"| node_matching
node_screenroutes -->|"loads resume"| node_resumes
node_screenroutes -->|"loads requirement"| node_jobs
node_screenroutes -->|"records scores"| node_results
node_dashboard -->|"reads"| node_resumes
node_dashboard -->|"reads"| node_jobs
node_dashboard -->|"reads"| node_results
node_dbsession -->|"connects"| node_sqlite
node_dbsession -->|"maps"| node_users
node_dbsession -->|"maps"| node_jobs
node_dbsession -->|"maps"| node_resumes
node_dbsession -->|"maps"| node_results

click node_routes "https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/App.jsx"
click node_authstate "https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/context/AuthContext.jsx"
click node_api "https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/services/api.js"
click node_authui "https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/pages/Login.jsx"
click node_jobsui "https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/pages/Jobs.jsx"
click node_resumeui "https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/pages/ResumeUpload.jsx"
click node_analysisui "https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/pages/CandidateComparison.jsx"
click node_historyui "https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/pages/ScreeningHistory.jsx"
click node_app "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/main.py"
click node_auth "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/auth.py"
click node_jobroutes "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/jobs.py"
click node_resumeroutes "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/resumes.py"
click node_screenroutes "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/screening.py"
click node_dashboard "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/dashboard.py"
click node_parser "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/services/resume_parser.py"
click node_nlp "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/services/nlp_processor.py"
click node_matching "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/services/matching_engine.py"
click node_security "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/utils/security.py"
click node_dbsession "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/database.py"
click node_users "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/models/user.py"
click node_jobs "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/models/job.py"
click node_resumes "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/models/resume.py"
click node_results "https://github.com/revaldo007/resume-scanner/blob/main/backend/app/models/screening.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_routes,node_authstate,node_api,node_authui,node_jobsui,node_resumeui,node_analysisui,node_historyui,node_user toneBlue
class node_app,node_auth,node_jobroutes,node_resumeroutes,node_screenroutes,node_dashboard,node_security,node_sqlite toneAmber
class node_parser,node_nlp,node_matching toneMint
class node_dbsession,node_users,node_jobs,node_resumes,node_results toneRose
```

## Components

### Web application

- [App routes](https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth session](https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Login and register](https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Job management](https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/pages/Jobs.jsx): `frontend/src/pages/Jobs.jsx`
- [Resume upload](https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/pages/ResumeUpload.jsx): `frontend/src/pages/ResumeUpload.jsx`
- [Analysis and compare](https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/pages/CandidateComparison.jsx): `frontend/src/pages/CandidateComparison.jsx`
- [History and dashboard](https://github.com/revaldo007/resume-scanner/blob/main/frontend/src/pages/ScreeningHistory.jsx): `frontend/src/pages/ScreeningHistory.jsx`

### API and workflows

- [FastAPI application](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication routes](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [Job routes](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/jobs.py): `backend/app/routers/jobs.py`
- [Resume routes](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/resumes.py): `backend/app/routers/resumes.py`
- [Screening routes](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/screening.py): `backend/app/routers/screening.py`
- [Dashboard statistics](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/routers/dashboard.py): `backend/app/routers/dashboard.py`
- [Token security](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/utils/security.py): `backend/app/utils/security.py`

### Resume processing

- [Document parser](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/services/resume_parser.py): `backend/app/services/resume_parser.py`
- [NLP extraction](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/services/nlp_processor.py): `backend/app/services/nlp_processor.py`
- [Candidate matching](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/services/matching_engine.py): `backend/app/services/matching_engine.py`

### Persistence

- [Database session](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/database.py): `backend/app/database.py`
- [User records](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/models/user.py): `backend/app/models/user.py`
- [Job requirements](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/models/job.py): `backend/app/models/job.py`
- [Resume records](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/models/resume.py): `backend/app/models/resume.py`
- [Screening results](https://github.com/revaldo007/resume-scanner/blob/main/backend/app/models/screening.py): `backend/app/models/screening.py`

### Other components

- **User**
- **SQLite**

## Connections

- User → App routes: uses (evidence: `README.md`)
- App routes → Login and register: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Job management: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Resume upload: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Analysis and compare: routes to (evidence: `frontend/src/App.jsx`)
- App routes → History and dashboard: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Auth session: provides session (evidence: `frontend/src/App.jsx`)
- Login and register → Auth session: signs in (evidence: `frontend/src/pages/Login.jsx`)
- Auth session → API client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Job management → API client: calls
- Resume upload → API client: uploads (evidence: `frontend/src/pages/ResumeUpload.jsx`)
- Analysis and compare → API client: requests results (evidence: `frontend/src/pages/CandidateComparison.jsx`)
- History and dashboard → API client: requests history
- API client → FastAPI application: HTTP requests (evidence: `frontend/src/services/api.js`)
- FastAPI application → Authentication routes: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Job routes: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Resume routes: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Screening routes: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Dashboard statistics: registers router (evidence: `backend/app/main.py`)
- Authentication routes → Database session: opens session (evidence: `backend/app/routers/auth.py`)
- Job routes → Database session: opens session (evidence: `backend/app/routers/jobs.py`)
- Resume routes → Database session: opens session (evidence: `backend/app/routers/resumes.py`)
- Screening routes → Database session: opens session (evidence: `backend/app/routers/screening.py`)
- Dashboard statistics → Database session: opens session (evidence: `backend/app/routers/dashboard.py`)
- Authentication routes → Token security: hashes and tokens (evidence: `backend/app/routers/auth.py`)
- Authentication routes → User records: queries and writes (evidence: `backend/app/routers/auth.py`)
- Resume routes → Document parser: parses documents (evidence: `backend/app/routers/resumes.py`)
- Resume routes → NLP extraction: extracts fields (evidence: `backend/app/routers/resumes.py`)
- Resume routes → Resume records: stores resume (evidence: `backend/app/routers/resumes.py`)
- Job routes → Job requirements: manages requirements (evidence: `backend/app/routers/jobs.py`)
- Screening routes → Candidate matching: scores candidates (evidence: `backend/app/routers/screening.py`)
- Screening routes → Resume records: loads resume (evidence: `backend/app/routers/screening.py`)
- Screening routes → Job requirements: loads requirement (evidence: `backend/app/routers/screening.py`)
- Screening routes → Screening results: records scores (evidence: `backend/app/routers/screening.py`)
- Dashboard statistics → Resume records: reads (evidence: `backend/app/routers/dashboard.py`)
- Dashboard statistics → Job requirements: reads (evidence: `backend/app/routers/dashboard.py`)
- Dashboard statistics → Screening results: reads (evidence: `backend/app/routers/dashboard.py`)
- Database session → SQLite: connects (evidence: `backend/app/database.py`)
- Database session → User records: maps (evidence: `backend/app/models/user.py`)
- Database session → Job requirements: maps (evidence: `backend/app/models/job.py`)
- Database session → Resume records: maps (evidence: `backend/app/models/resume.py`)
- Database session → Screening results: maps (evidence: `backend/app/models/screening.py`)
