# samiksha267/career-prep-platform architecture

> Architecture diagram of the GitHub repository samiksha267/career-prep-platform, 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/samiksha267/career-prep-platform
- Repository: https://github.com/samiksha267/career-prep-platform

## Overview

This is a career-preparation app: users upload resumes and job descriptions, compare them for fit, rewrite resumes, practise interviews, and review a dashboard. The frontend routes these workflows and sends authenticated requests to a FastAPI backend. Backend routes coordinate parsing and domain services, which use structured LLM generation and persist user-scoped records. The graph retains the documented feature branches, but several service implementations were not sampled; their links are included only where the source index or route excerpts support them.

Main entry points: [`backend/app/api/router.py`](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/router.py) (API router), [`frontend/src/api/client.js`](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/api/client.js) (API client), [`frontend/src/App.jsx`](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/App.jsx) (Page routing), [`backend/app/api/routes/resumes.py`](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/resumes.py) (Resume API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Page routing<br/>[App.jsx]"]
  node_authui["Browser auth<br/>[AuthContext.jsx]"]
  node_supabaseui["Supabase client<br/>[supabaseClient.js]"]
  node_api_client["API client<br/>[client.js]"]
  node_resume_ui["Resume page<br/>[Resumes.jsx]"]
  node_jd_ui["Job descriptions page"]
  node_match_ui["Match page<br/>[Match.jsx]"]
  node_interview_ui["Interview page<br/>[Interview.jsx]"]
  node_dashboard_ui["Dashboard page<br/>[Dashboard.jsx]"]
end

subgraph group_api["API and identity"]
  node_rewrite_route["Resume rewrite API<br/>[resume_rewrite.py]"]
  node_api_router["API router<br/>[router.py]"]
  node_resume_route["Resume API<br/>[resumes.py]"]
  node_jd_route["Job description API"]
  node_match_route["Matching API<br/>[match.py]"]
  node_interview_route["Interview API<br/>[interview.py]"]
  node_dashboard_route["Dashboard API<br/>[dashboard.py]"]
  node_auth["JWT verification<br/>[auth.py]"]
end

subgraph group_career["Career workflows"]
  node_file_parse["File parsing<br/>[file_parsing.py]"]
  node_resume_parse["Resume analysis<br/>[resume_parser.py]"]
  node_jd_parse["Job analysis<br/>[jd_parser.py]"]
  node_matching["Fit assessment<br/>[matching.py]"]
  node_ats["ATS check<br/>[ats_check.py]"]
  node_rewrite["Resume rewriting<br/>[resume_rewrite.py]"]
  node_dashboard_service["Dashboard aggregation<br/>[dashboard.py]"]
end

subgraph group_interview["Interview practice"]
  node_interview_engine["Interview engine"]
end

subgraph group_platform["Persistence and AI"]
  node_user_service["User records<br/>[user_service.py]"]
  node_db_session["Database sessions<br/>[session.py]"]
  node_models["Domain records"]
  node_database[("Supabase database")]
  node_structured["Structured LLM<br/>[structured.py]"]
  node_llm_router["Provider fallback<br/>[router.py]"]
  node_gemini["Gemini provider<br/>[gemini_client.py]"]
  node_groq["Groq provider<br/>[groq_client.py]"]
end

node_candidate(("Candidate"))

node_candidate -->|"uses"| node_app
node_app -->|"routes to"| node_resume_ui
node_app -->|"routes to"| node_jd_ui
node_app -->|"routes to"| node_match_ui
node_app -->|"routes to"| node_interview_ui
node_app -->|"routes to"| node_dashboard_ui
node_authui -->|"authenticates with"| node_supabaseui
node_api_client -->|"gets session"| node_supabaseui
node_resume_ui -->|"requests data"| node_api_client
node_jd_ui -->|"requests data"| node_api_client
node_match_ui -->|"requests match"| node_api_client
node_interview_ui -->|"requests interview"| node_api_client
node_dashboard_ui -->|"requests summary"| node_api_client
node_api_client -.->|"sends HTTP requests"| node_api_router
node_api_router -->|"registers"| node_resume_route
node_api_router -->|"registers"| node_jd_route
node_api_router -->|"registers"| node_match_route
node_api_router -->|"registers"| node_rewrite_route
node_api_router -->|"registers"| node_interview_route
node_api_router -->|"registers"| node_dashboard_route
node_resume_route -->|"verifies identity"| node_auth
node_jd_route -->|"verifies identity"| node_auth
node_match_route -->|"verifies identity"| node_auth
node_interview_route -->|"verifies identity"| node_auth
node_dashboard_route -->|"verifies identity"| node_auth
node_resume_route -->|"uses"| node_file_parse
node_resume_route -->|"uses"| node_resume_parse
node_jd_route -->|"uses"| node_file_parse
node_jd_route -->|"uses"| node_jd_parse
node_match_route -->|"uses"| node_matching
node_match_route -->|"uses"| node_ats
node_rewrite_route -->|"uses"| node_rewrite
node_interview_route -->|"uses"| node_interview_engine
node_dashboard_route -->|"uses"| node_dashboard_service
node_resume_route -->|"gets session"| node_db_session
node_jd_route -->|"gets session"| node_db_session
node_match_route -->|"gets session"| node_db_session
node_interview_route -->|"gets session"| node_db_session
node_dashboard_route -->|"gets session"| node_db_session
node_db_session -.->|"connects"| node_database
node_user_service -->|"uses"| node_models
node_resume_route -->|"uses"| node_user_service
node_jd_route -->|"uses"| node_user_service
node_interview_route -->|"uses"| node_user_service
node_interview_engine -->|"generates structured output"| node_structured
node_jd_parse -->|"generates structured output"| node_structured
node_structured -->|"requests text"| node_llm_router
node_llm_router -->|"tries provider"| node_gemini

click node_app "https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/context/AuthContext.jsx"
click node_supabaseui "https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/api/supabaseClient.js"
click node_api_client "https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/api/client.js"
click node_resume_ui "https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/pages/Resumes.jsx"
click node_jd_ui "https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/pages/JobDescriptions.jsx"
click node_match_ui "https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/pages/Match.jsx"
click node_rewrite_route "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/resume_rewrite.py"
click node_interview_ui "https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/pages/Interview.jsx"
click node_dashboard_ui "https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/pages/Dashboard.jsx"
click node_api_router "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/router.py"
click node_resume_route "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/resumes.py"
click node_jd_route "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/job_descriptions.py"
click node_match_route "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/match.py"
click node_interview_route "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/interview.py"
click node_dashboard_route "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/dashboard.py"
click node_auth "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/core/auth.py"
click node_file_parse "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/file_parsing.py"
click node_resume_parse "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/resume_parser.py"
click node_jd_parse "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/jd_parser.py"
click node_matching "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/matching.py"
click node_ats "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/ats_check.py"
click node_rewrite "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/resume_rewrite.py"
click node_interview_engine "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/interview_engine.py"
click node_dashboard_service "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/dashboard.py"
click node_user_service "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/user_service.py"
click node_db_session "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/db/session.py"
click node_models "https://github.com/samiksha267/career-prep-platform/tree/main/backend/app/models"
click node_structured "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/llm/structured.py"
click node_llm_router "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/llm/router.py"
click node_gemini "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/llm/gemini_client.py"
click node_groq "https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/llm/groq_client.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_authui,node_supabaseui,node_api_client,node_resume_ui,node_jd_ui,node_match_ui,node_interview_ui,node_dashboard_ui toneBlue
class node_rewrite_route,node_api_router,node_resume_route,node_jd_route,node_match_route,node_interview_route,node_dashboard_route,node_auth toneAmber
class node_file_parse,node_resume_parse,node_jd_parse,node_matching,node_ats,node_rewrite,node_dashboard_service toneMint
class node_interview_engine toneRose
class node_user_service,node_db_session,node_models,node_database,node_structured,node_llm_router,node_gemini,node_groq,node_candidate toneIndigo
```

## Components

### Web application

- [Page routing](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Browser auth](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Supabase client](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/api/supabaseClient.js): `frontend/src/api/supabaseClient.js`
- [API client](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`
- [Resume page](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/pages/Resumes.jsx): `frontend/src/pages/Resumes.jsx`
- [Job descriptions page](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/pages/JobDescriptions.jsx): `frontend/src/pages/JobDescriptions.jsx`
- [Match page](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/pages/Match.jsx): `frontend/src/pages/Match.jsx`
- [Interview page](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/pages/Interview.jsx): `frontend/src/pages/Interview.jsx`
- [Dashboard page](https://github.com/samiksha267/career-prep-platform/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`

### API and identity

- [Resume rewrite API](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/resume_rewrite.py): `backend/app/api/routes/resume_rewrite.py`
- [API router](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/router.py): `backend/app/api/router.py`
- [Resume API](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/resumes.py): `backend/app/api/routes/resumes.py`
- [Job description API](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/job_descriptions.py): `backend/app/api/routes/job_descriptions.py`
- [Matching API](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/match.py): `backend/app/api/routes/match.py`
- [Interview API](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/interview.py): `backend/app/api/routes/interview.py`
- [Dashboard API](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/api/routes/dashboard.py): `backend/app/api/routes/dashboard.py`
- [JWT verification](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/core/auth.py): `backend/app/core/auth.py`

### Career workflows

- [File parsing](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/file_parsing.py): `backend/app/services/file_parsing.py`
- [Resume analysis](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/resume_parser.py): `backend/app/services/resume_parser.py`
- [Job analysis](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/jd_parser.py): `backend/app/services/jd_parser.py`
- [Fit assessment](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/matching.py): `backend/app/services/matching.py`
- [ATS check](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/ats_check.py): `backend/app/services/ats_check.py`
- [Resume rewriting](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/resume_rewrite.py): `backend/app/services/resume_rewrite.py`
- [Dashboard aggregation](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/dashboard.py): `backend/app/services/dashboard.py`

### Interview practice

- [Interview engine](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/interview_engine.py): `backend/app/services/interview_engine.py`

### Persistence and AI

- [User records](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/services/user_service.py): `backend/app/services/user_service.py`
- [Database sessions](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- [Domain records](https://github.com/samiksha267/career-prep-platform/tree/main/backend/app/models): `backend/app/models`
- **Supabase database**
- [Structured LLM](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/llm/structured.py): `backend/app/llm/structured.py`
- [Provider fallback](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/llm/router.py): `backend/app/llm/router.py`
- [Gemini provider](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/llm/gemini_client.py): `backend/app/llm/gemini_client.py`
- [Groq provider](https://github.com/samiksha267/career-prep-platform/blob/main/backend/app/llm/groq_client.py): `backend/app/llm/groq_client.py`

### Other components

- **Candidate**

## Connections

- Candidate → Page routing: uses
- Page routing → Resume page: routes to (evidence: `frontend/src/App.jsx`)
- Page routing → Job descriptions page: routes to (evidence: `frontend/src/App.jsx`)
- Page routing → Match page: routes to (evidence: `frontend/src/App.jsx`)
- Page routing → Interview page: routes to (evidence: `frontend/src/App.jsx`)
- Page routing → Dashboard page: routes to (evidence: `frontend/src/App.jsx`)
- Browser auth → Supabase client: authenticates with (evidence: `frontend/src/context/AuthContext.jsx`)
- API client → Supabase client: gets session (evidence: `frontend/src/api/client.js`)
- Resume page → API client: requests data (evidence: `frontend/src/pages/Resumes.jsx`)
- Job descriptions page → API client: requests data (evidence: `frontend/src/pages/JobDescriptions.jsx`)
- Match page → API client: requests match (evidence: `frontend/src/pages/Match.jsx`)
- Interview page → API client: requests interview (evidence: `frontend/src/pages/Interview.jsx`)
- Dashboard page → API client: requests summary (evidence: `frontend/src/pages/Dashboard.jsx`)
- API client → API router: sends HTTP requests
- API router → Resume API: registers (evidence: `backend/app/api/router.py`)
- API router → Job description API: registers (evidence: `backend/app/api/router.py`)
- API router → Matching API: registers (evidence: `backend/app/api/router.py`)
- API router → Resume rewrite API: registers (evidence: `backend/app/api/router.py`)
- API router → Interview API: registers (evidence: `backend/app/api/router.py`)
- API router → Dashboard API: registers (evidence: `backend/app/api/router.py`)
- Resume API → JWT verification: verifies identity (evidence: `backend/app/api/routes/resumes.py`)
- Job description API → JWT verification: verifies identity (evidence: `backend/app/api/routes/job_descriptions.py`)
- Matching API → JWT verification: verifies identity (evidence: `backend/app/api/routes/match.py`)
- Interview API → JWT verification: verifies identity (evidence: `backend/app/api/routes/interview.py`)
- Dashboard API → JWT verification: verifies identity (evidence: `backend/app/api/routes/dashboard.py`)
- Resume API → File parsing: uses (evidence: `backend/app/api/routes/resumes.py`)
- Resume API → Resume analysis: uses (evidence: `backend/app/api/routes/resumes.py`)
- Job description API → File parsing: uses (evidence: `backend/app/api/routes/job_descriptions.py`)
- Job description API → Job analysis: uses (evidence: `backend/app/api/routes/job_descriptions.py`)
- Matching API → Fit assessment: uses (evidence: `backend/app/api/routes/match.py`)
- Matching API → ATS check: uses (evidence: `backend/app/api/routes/match.py`)
- Resume rewrite API → Resume rewriting: uses (evidence: `backend/app/api/routes/resume_rewrite.py`)
- Interview API → Interview engine: uses (evidence: `backend/app/api/routes/interview.py`)
- Dashboard API → Dashboard aggregation: uses (evidence: `backend/app/api/routes/dashboard.py`)
- Resume API → Database sessions: gets session (evidence: `backend/app/api/routes/resumes.py`)
- Job description API → Database sessions: gets session (evidence: `backend/app/api/routes/job_descriptions.py`)
- Matching API → Database sessions: gets session (evidence: `backend/app/api/routes/match.py`)
- Interview API → Database sessions: gets session (evidence: `backend/app/api/routes/interview.py`)
- Dashboard API → Database sessions: gets session (evidence: `backend/app/api/routes/dashboard.py`)
- Database sessions → Supabase database: connects
- User records → Domain records: uses (evidence: `backend/app/services/user_service.py`)
- Resume API → User records: uses (evidence: `backend/app/api/routes/resumes.py`)
- Job description API → User records: uses (evidence: `backend/app/api/routes/job_descriptions.py`)
- Interview API → User records: uses (evidence: `backend/app/api/routes/interview.py`)
- Interview engine → Structured LLM: generates structured output (evidence: `backend/app/services/interview_engine.py`)
- Job analysis → Structured LLM: generates structured output (evidence: `backend/app/services/jd_parser.py`)
- Structured LLM → Provider fallback: requests text (evidence: `backend/app/llm/structured.py`)
- Provider fallback → Gemini provider: tries provider (evidence: `backend/app/llm/router.py`)
