# lahari1907/ai-resume-matcher architecture

> Architecture diagram of the GitHub repository lahari1907/ai-resume-matcher, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lahari1907/ai-resume-matcher
- Repository: https://github.com/lahari1907/ai-resume-matcher

## Overview

SkillMatch AI lets a candidate sign in or continue as a guest, upload a resume PDF, and compare it with a job description. The matcher returns an ATS score and skill gaps; users can then generate a learning roadmap or rewrite resume bullets, and authenticated users can review scan history. The React pages call a Spring Boot gateway, which the README documents as using internal HTTP to reach the Python NLP service. Backend persistence and several gateway-to-NLP endpoint mappings are represented cautiously because their implementation excerpts were not provided.

Main entry points: [`backend-gateway/src/main/java/com/example/demo`](https://github.com/lahari1907/ai-resume-matcher/tree/main/backend-gateway/src/main/java/com/example/demo) (REST API gateway), [`frontend-ui/src/App.jsx`](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/App.jsx) (Routes and access), [`frontend-ui/src/pages/AuthPage.jsx`](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/AuthPage.jsx) (Login and guest), [`frontend-ui/src/pages/MatcherPage.jsx`](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/MatcherPage.jsx) (Resume matcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Candidate experience"]
  node_app["Routes and access<br/>[App.jsx]"]
  node_auth_ui["Login and guest<br/>[AuthPage.jsx]"]
  node_session["Session context<br/>[AuthContext.jsx]"]
  node_dashboard["Workspace overview<br/>[DashboardPage.jsx]"]
  node_matcher["Resume matcher<br/>[MatcherPage.jsx]"]
  node_roadmap_ui["Roadmap view<br/>[RoadmapPage.jsx]"]
  node_rewriter_ui["Resume editor<br/>[RewriterPage.jsx]"]
  node_history_ui["Scan history<br/>[HistoryPage.jsx]"]
end

subgraph group_gateway["API and identity"]
  node_gateway_api["REST API gateway"]
  node_auth_api["Authentication API"]
end

subgraph group_nlp["Resume intelligence"]
  node_nlp_service["NLP endpoints<br/>[main.py]"]
end

subgraph group_persistence["Account and history"]
  node_user_store[("User repository")]
  node_history_store[("Scan history repository")]
end

node_candidate(("Candidate"))

node_candidate -->|"uses"| node_app
node_app -->|"routes to"| node_auth_ui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_matcher
node_app -->|"routes to"| node_roadmap_ui
node_app -->|"routes to"| node_rewriter_ui
node_app -->|"routes to"| node_history_ui
node_auth_ui -->|"saves session"| node_session
node_auth_ui -->|"requests access"| node_auth_api
node_matcher -->|"reads and updates"| node_session
node_matcher -->|"submits scan"| node_gateway_api
node_gateway_api -->|"calls internally"| node_nlp_service
node_nlp_service -->|"returns analysis"| node_gateway_api
node_roadmap_ui -->|"requests roadmap"| node_gateway_api
node_rewriter_ui -->|"requests rewrite"| node_gateway_api
node_rewriter_ui -->|"extracts resume"| node_gateway_api
node_dashboard -->|"loads history"| node_gateway_api
node_history_ui -->|"reads and deletes"| node_gateway_api
node_gateway_api -.->|"uses"| node_user_store
node_gateway_api -.->|"uses"| node_history_store

click node_app "https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/App.jsx"
click node_auth_ui "https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/AuthPage.jsx"
click node_session "https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/context/AuthContext.jsx"
click node_dashboard "https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/DashboardPage.jsx"
click node_matcher "https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/MatcherPage.jsx"
click node_roadmap_ui "https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/RoadmapPage.jsx"
click node_rewriter_ui "https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/RewriterPage.jsx"
click node_history_ui "https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/HistoryPage.jsx"
click node_gateway_api "https://github.com/lahari1907/ai-resume-matcher/tree/main/backend-gateway/src/main/java/com/example/demo"
click node_auth_api "https://github.com/lahari1907/ai-resume-matcher/blob/main/backend-gateway/src/main/java/com/example/demo/AuthController.java"
click node_nlp_service "https://github.com/lahari1907/ai-resume-matcher/blob/main/nlp-service/main.py"
click node_user_store "https://github.com/lahari1907/ai-resume-matcher/blob/main/backend-gateway/src/main/java/com/example/demo/UserRepository.java"
click node_history_store "https://github.com/lahari1907/ai-resume-matcher/blob/main/backend-gateway/src/main/java/com/example/demo/ScanHistoryRepository.java"

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_auth_ui,node_session,node_dashboard,node_matcher,node_roadmap_ui,node_rewriter_ui,node_history_ui toneBlue
class node_gateway_api,node_auth_api toneAmber
class node_nlp_service toneMint
class node_user_store,node_history_store toneRose
class node_candidate toneIndigo
```

## Components

### Candidate experience

- [Routes and access](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/App.jsx): `frontend-ui/src/App.jsx`
- [Login and guest](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/AuthPage.jsx): `frontend-ui/src/pages/AuthPage.jsx`
- [Session context](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/context/AuthContext.jsx): `frontend-ui/src/context/AuthContext.jsx`
- [Workspace overview](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/DashboardPage.jsx): `frontend-ui/src/pages/DashboardPage.jsx`
- [Resume matcher](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/MatcherPage.jsx): `frontend-ui/src/pages/MatcherPage.jsx`
- [Roadmap view](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/RoadmapPage.jsx): `frontend-ui/src/pages/RoadmapPage.jsx`
- [Resume editor](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/RewriterPage.jsx): `frontend-ui/src/pages/RewriterPage.jsx`
- [Scan history](https://github.com/lahari1907/ai-resume-matcher/blob/main/frontend-ui/src/pages/HistoryPage.jsx): `frontend-ui/src/pages/HistoryPage.jsx`

### API and identity

- [REST API gateway](https://github.com/lahari1907/ai-resume-matcher/tree/main/backend-gateway/src/main/java/com/example/demo): `backend-gateway/src/main/java/com/example/demo`
- [Authentication API](https://github.com/lahari1907/ai-resume-matcher/blob/main/backend-gateway/src/main/java/com/example/demo/AuthController.java): `backend-gateway/src/main/java/com/example/demo/AuthController.java`

### Resume intelligence

- [NLP endpoints](https://github.com/lahari1907/ai-resume-matcher/blob/main/nlp-service/main.py): `nlp-service/main.py`

### Account and history

- [User repository](https://github.com/lahari1907/ai-resume-matcher/blob/main/backend-gateway/src/main/java/com/example/demo/UserRepository.java): `backend-gateway/src/main/java/com/example/demo/UserRepository.java`
- [Scan history repository](https://github.com/lahari1907/ai-resume-matcher/blob/main/backend-gateway/src/main/java/com/example/demo/ScanHistoryRepository.java): `backend-gateway/src/main/java/com/example/demo/ScanHistoryRepository.java`

### Other components

- **Candidate**

## Connections

- Candidate → Routes and access: uses (evidence: `README.md`)
- Routes and access → Login and guest: routes to (evidence: `frontend-ui/src/App.jsx`)
- Routes and access → Workspace overview: routes to (evidence: `frontend-ui/src/App.jsx`)
- Routes and access → Resume matcher: routes to (evidence: `frontend-ui/src/App.jsx`)
- Routes and access → Roadmap view: routes to (evidence: `frontend-ui/src/App.jsx`)
- Routes and access → Resume editor: routes to (evidence: `frontend-ui/src/App.jsx`)
- Routes and access → Scan history: routes to (evidence: `frontend-ui/src/App.jsx`)
- Login and guest → Session context: saves session (evidence: `frontend-ui/src/pages/AuthPage.jsx`)
- Login and guest → Authentication API: requests access (evidence: `frontend-ui/src/pages/AuthPage.jsx`)
- Resume matcher → Session context: reads and updates (evidence: `frontend-ui/src/pages/MatcherPage.jsx`)
- Resume matcher → REST API gateway: submits scan (evidence: `frontend-ui/src/pages/MatcherPage.jsx`)
- REST API gateway → NLP endpoints: calls internally (evidence: `README.md`)
- NLP endpoints → REST API gateway: returns analysis (evidence: `README.md`)
- Roadmap view → REST API gateway: requests roadmap (evidence: `frontend-ui/src/pages/RoadmapPage.jsx`)
- Resume editor → REST API gateway: requests rewrite (evidence: `frontend-ui/src/pages/RewriterPage.jsx`)
- Resume editor → REST API gateway: extracts resume (evidence: `frontend-ui/src/pages/RewriterPage.jsx`)
- Workspace overview → REST API gateway: loads history (evidence: `frontend-ui/src/pages/DashboardPage.jsx`)
- Scan history → REST API gateway: reads and deletes (evidence: `frontend-ui/src/pages/HistoryPage.jsx`)
- REST API gateway → User repository: uses
- REST API gateway → Scan history repository: uses
