# johnpaul5084/resume-analyzer-python architecture

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

## Overview

This is a resume-analysis and career-assistance product: users sign in, upload a resume, review analysis and job matches, then use optimization, mentoring, market-insight, and application tools. The frontend routes users to these feature screens and its shared API client calls the FastAPI backend. Backend routes expose the product capabilities; sampled evidence also shows AI scoring, role-matching, provider, and persistence layers. Many endpoint and service implementations were not sampled, so their internal call paths are omitted rather than inferred.

Main entry points: [`resume-analyzer-frontend/src/App.jsx`](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/App.jsx) (Application routes), [`resume-analyzer-backend/app/api/api.py`](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/api.py) (API router), [`resume-analyzer-frontend/src/api.js`](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/api.js) (API client), [`resume-analyzer-backend/app/main.py`](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/main.py) (FastAPI app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Application routes<br/>[App.jsx]"]
  node_login["Sign-in<br/>[Login.jsx]"]
  node_upload["Resume upload<br/>[UploadResume.jsx]"]
  node_detail["Resume detail<br/>[ResumeDetail.jsx]"]
  node_optimizer["Resume optimizer"]
  node_pipeline["Smart pipeline<br/>[SmartPipeline.jsx]"]
  node_mentorbot["Mentor bot<br/>[MentorBot.jsx]"]
  node_autoapply["Auto apply<br/>[AutoApply.jsx]"]
  node_market["Market insights<br/>[MarketInsights.jsx]"]
  node_careermentor["Career mentor<br/>[CareerMentor.jsx]"]
  node_client["API client<br/>[api.js]"]
end

subgraph group_api["API and identity"]
  node_backend["FastAPI app<br/>[main.py]"]
  node_router["API router<br/>[api.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_resumeapi["Resume endpoints<br/>[resumes.py]"]
  node_jobs["Job endpoints<br/>[jobs.py]"]
  node_advanced["Advanced features"]
  node_mentorapi["Mentor endpoints<br/>[mentor.py]"]
  node_rewriteapi["Rewrite endpoints<br/>[ai_rewrite.py]"]
end

subgraph group_resume["Resume intelligence"]
  node_parser["Resume parsing"]
  node_fileparser["File extraction"]
  node_scoring["Resume scoring"]
  node_rewrite["Resume rewriting"]
  node_builder["Resume builder"]
end

subgraph group_career["Career tools"]
  node_rag["Role matching<br/>[rag_engine.py]"]
  node_mentor["Mentor service"]
  node_roadmap["Career roadmaps"]
  node_linkedin["LinkedIn tools"]
  node_autoapplyservice["Application automation"]
end

subgraph group_platform["AI and persistence"]
  node_ai["AI provider<br/>[ai_provider.py]"]
  node_aimodel["AI model<br/>[ai_model.py]"]
  node_credits["API credit manager"]
  node_session["Database sessions<br/>[session.py]"]
end

node_user(("Job seeker"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_upload
node_app -->|"routes to"| node_detail
node_app -->|"routes to"| node_optimizer
node_app -->|"routes to"| node_pipeline
node_app -->|"routes to"| node_mentorbot
node_app -->|"routes to"| node_autoapply
node_app -->|"routes to"| node_market
node_app -->|"routes to"| node_careermentor
node_login -->|"calls"| node_client
node_upload -->|"calls"| node_client
node_detail -->|"calls"| node_client
node_optimizer -->|"calls"| node_client
node_pipeline -->|"calls"| node_client
node_mentorbot -->|"calls"| node_client
node_autoapply -->|"calls"| node_client
node_client -->|"HTTP requests"| node_backend
node_backend -->|"mounts"| node_router
node_router -->|"registers"| node_auth
node_router -->|"registers"| node_resumeapi
node_router -->|"registers"| node_jobs
node_router -->|"registers"| node_advanced
node_router -->|"registers"| node_mentorapi
node_router -->|"registers"| node_rewriteapi
node_auth -->|"opens session"| node_session
node_backend -->|"initializes database"| node_session
node_backend -->|"imports"| node_scoring
node_backend -->|"imports"| node_rag
node_fileparser -->|"extracts text for"| node_parser
node_scoring -.->|"uses skills ontology"| node_ai
node_ai -->|"uses"| node_aimodel
node_ai -->|"augments generation"| node_rag
node_ai -->|"tracks usage"| node_credits
node_mentor -->|"uses"| node_roadmap

click node_app "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/App.jsx"
click node_login "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/Login.jsx"
click node_upload "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/UploadResume.jsx"
click node_detail "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/ResumeDetail.jsx"
click node_optimizer "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/ResumeOptimizer.jsx"
click node_pipeline "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/SmartPipeline.jsx"
click node_mentorbot "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/MentorBot.jsx"
click node_autoapply "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/AutoApply.jsx"
click node_market "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/MarketInsights.jsx"
click node_careermentor "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/CareerMentor.jsx"
click node_client "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/api.js"
click node_backend "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/main.py"
click node_router "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/api.py"
click node_auth "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/auth.py"
click node_resumeapi "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/resumes.py"
click node_jobs "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/jobs.py"
click node_advanced "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/advanced_features.py"
click node_mentorapi "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/mentor.py"
click node_rewriteapi "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/ai_rewrite.py"
click node_parser "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/ai_parser_service.py"
click node_fileparser "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/file_parser_service.py"
click node_scoring "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/ai_scoring_engine.py"
click node_rag "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/career_engine/rag_engine.py"
click node_mentor "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/career_engine/mentor_bot_service.py"
click node_roadmap "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/career_engine/roadmap_ai_generator.py"
click node_rewrite "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/ai_rewrite_service.py"
click node_builder "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/resume_builder_service.py"
click node_linkedin "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/linkedin_service.py"
click node_autoapplyservice "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/auto_apply_service.py"
click node_ai "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/core/ai_provider.py"
click node_aimodel "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/core/ai_model.py"
click node_credits "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/api_credit_manager.py"
click node_session "https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/db/session.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_login,node_upload,node_detail,node_optimizer,node_pipeline,node_mentorbot,node_autoapply,node_market,node_careermentor,node_client toneBlue
class node_backend,node_router,node_auth,node_resumeapi,node_jobs,node_advanced,node_mentorapi,node_rewriteapi toneAmber
class node_parser,node_fileparser,node_scoring,node_rewrite,node_builder toneMint
class node_rag,node_mentor,node_roadmap,node_linkedin,node_autoapplyservice toneRose
class node_ai,node_aimodel,node_credits,node_session,node_user toneIndigo
```

## Components

### Web application

- [Application routes](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/App.jsx): `resume-analyzer-frontend/src/App.jsx`
- [Sign-in](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/Login.jsx): `resume-analyzer-frontend/src/components/Login.jsx`
- [Resume upload](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/UploadResume.jsx): `resume-analyzer-frontend/src/components/UploadResume.jsx`
- [Resume detail](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/ResumeDetail.jsx): `resume-analyzer-frontend/src/components/ResumeDetail.jsx`
- [Resume optimizer](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/ResumeOptimizer.jsx): `resume-analyzer-frontend/src/components/ResumeOptimizer.jsx`
- [Smart pipeline](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/SmartPipeline.jsx): `resume-analyzer-frontend/src/components/SmartPipeline.jsx`
- [Mentor bot](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/MentorBot.jsx): `resume-analyzer-frontend/src/components/MentorBot.jsx`
- [Auto apply](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/AutoApply.jsx): `resume-analyzer-frontend/src/components/AutoApply.jsx`
- [Market insights](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/MarketInsights.jsx): `resume-analyzer-frontend/src/components/MarketInsights.jsx`
- [Career mentor](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/components/CareerMentor.jsx): `resume-analyzer-frontend/src/components/CareerMentor.jsx`
- [API client](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-frontend/src/api.js): `resume-analyzer-frontend/src/api.js`

### API and identity

- [FastAPI app](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/main.py): `resume-analyzer-backend/app/main.py`
- [API router](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/api.py): `resume-analyzer-backend/app/api/api.py`
- [Authentication](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/auth.py): `resume-analyzer-backend/app/api/endpoints/auth.py`
- [Resume endpoints](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/resumes.py): `resume-analyzer-backend/app/api/endpoints/resumes.py`
- [Job endpoints](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/jobs.py): `resume-analyzer-backend/app/api/endpoints/jobs.py`
- [Advanced features](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/advanced_features.py): `resume-analyzer-backend/app/api/endpoints/advanced_features.py`
- [Mentor endpoints](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/mentor.py): `resume-analyzer-backend/app/api/endpoints/mentor.py`
- [Rewrite endpoints](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/api/endpoints/ai_rewrite.py): `resume-analyzer-backend/app/api/endpoints/ai_rewrite.py`

### Resume intelligence

- [Resume parsing](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/ai_parser_service.py): `resume-analyzer-backend/app/services/ai_parser_service.py`
- [File extraction](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/file_parser_service.py): `resume-analyzer-backend/app/services/file_parser_service.py`
- [Resume scoring](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/ai_scoring_engine.py): `resume-analyzer-backend/app/services/ai_scoring_engine.py`
- [Resume rewriting](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/ai_rewrite_service.py): `resume-analyzer-backend/app/services/ai_rewrite_service.py`
- [Resume builder](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/resume_builder_service.py): `resume-analyzer-backend/app/services/resume_builder_service.py`

### Career tools

- [Role matching](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/career_engine/rag_engine.py): `resume-analyzer-backend/app/career_engine/rag_engine.py`
- [Mentor service](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/career_engine/mentor_bot_service.py): `resume-analyzer-backend/app/career_engine/mentor_bot_service.py`
- [Career roadmaps](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/career_engine/roadmap_ai_generator.py): `resume-analyzer-backend/app/career_engine/roadmap_ai_generator.py`
- [LinkedIn tools](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/linkedin_service.py): `resume-analyzer-backend/app/services/linkedin_service.py`
- [Application automation](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/auto_apply_service.py): `resume-analyzer-backend/app/services/auto_apply_service.py`

### AI and persistence

- [AI provider](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/core/ai_provider.py): `resume-analyzer-backend/app/core/ai_provider.py`
- [AI model](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/core/ai_model.py): `resume-analyzer-backend/app/core/ai_model.py`
- [API credit manager](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/services/api_credit_manager.py): `resume-analyzer-backend/app/services/api_credit_manager.py`
- [Database sessions](https://github.com/johnpaul5084/resume-analyzer-python/blob/main/resume-analyzer-backend/app/db/session.py): `resume-analyzer-backend/app/db/session.py`

### Other components

- **Job seeker**

## Connections

- Job seeker → Application routes: uses (evidence: `resume-analyzer-frontend/src/App.jsx`)
- Application routes → Sign-in: routes to (evidence: `resume-analyzer-frontend/src/App.jsx`)
- Application routes → Resume upload: routes to (evidence: `resume-analyzer-frontend/src/App.jsx`)
- Application routes → Resume detail: routes to (evidence: `resume-analyzer-frontend/src/App.jsx`)
- Application routes → Resume optimizer: routes to (evidence: `resume-analyzer-frontend/src/App.jsx`)
- Application routes → Smart pipeline: routes to (evidence: `resume-analyzer-frontend/src/App.jsx`)
- Application routes → Mentor bot: routes to (evidence: `resume-analyzer-frontend/src/App.jsx`)
- Application routes → Auto apply: routes to (evidence: `resume-analyzer-frontend/src/App.jsx`)
- Application routes → Market insights: routes to (evidence: `resume-analyzer-frontend/src/App.jsx`)
- Application routes → Career mentor: routes to (evidence: `resume-analyzer-frontend/src/App.jsx`)
- Sign-in → API client: calls (evidence: `resume-analyzer-frontend/src/components/Login.jsx`)
- Resume upload → API client: calls (evidence: `resume-analyzer-frontend/src/components/UploadResume.jsx`)
- Resume detail → API client: calls (evidence: `resume-analyzer-frontend/src/components/ResumeDetail.jsx`)
- Resume optimizer → API client: calls (evidence: `resume-analyzer-frontend/src/components/ResumeOptimizer.jsx`)
- Smart pipeline → API client: calls (evidence: `resume-analyzer-frontend/src/components/SmartPipeline.jsx`)
- Mentor bot → API client: calls (evidence: `resume-analyzer-frontend/src/components/MentorBot.jsx`)
- Auto apply → API client: calls (evidence: `resume-analyzer-frontend/src/components/AutoApply.jsx`)
- API client → FastAPI app: HTTP requests (evidence: `resume-analyzer-frontend/src/api.js`)
- FastAPI app → API router: mounts (evidence: `resume-analyzer-backend/app/main.py`)
- API router → Authentication: registers (evidence: `resume-analyzer-backend/app/api/api.py`)
- API router → Resume endpoints: registers (evidence: `resume-analyzer-backend/app/api/api.py`)
- API router → Job endpoints: registers (evidence: `resume-analyzer-backend/app/api/api.py`)
- API router → Advanced features: registers (evidence: `resume-analyzer-backend/app/api/api.py`)
- API router → Mentor endpoints: registers (evidence: `resume-analyzer-backend/app/api/api.py`)
- API router → Rewrite endpoints: registers (evidence: `resume-analyzer-backend/app/api/api.py`)
- Authentication → Database sessions: opens session (evidence: `resume-analyzer-backend/app/api/endpoints/auth.py`)
- FastAPI app → Database sessions: initializes database (evidence: `resume-analyzer-backend/app/main.py`)
- FastAPI app → Resume scoring: imports (evidence: `resume-analyzer-backend/app/main.py`)
- FastAPI app → Role matching: imports (evidence: `resume-analyzer-backend/app/main.py`)
- File extraction → Resume parsing: extracts text for (evidence: `resume-analyzer-backend/app/services/file_parser_service.py`)
- Resume scoring → AI provider: uses skills ontology
- AI provider → AI model: uses (evidence: `resume-analyzer-backend/app/core/ai_provider.py`)
- AI provider → Role matching: augments generation (evidence: `resume-analyzer-backend/app/core/ai_provider.py`)
- AI provider → API credit manager: tracks usage (evidence: `resume-analyzer-backend/app/core/ai_provider.py`)
- Mentor service → Career roadmaps: uses (evidence: `resume-analyzer-backend/app/career_engine/mentor_bot_service.py`)
