# mhemanthsai456/major-project architecture

> Architecture diagram of the GitHub repository mhemanthsai456/major-project, 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/mhemanthsai456/major-project
- Repository: https://github.com/mhemanthsai456/major-project

## Overview

PathFinder.AI helps students choose career targets, assess skills and topic knowledge, follow personalized recommendations and roadmaps, study learning resources, and track progress. The main workflow runs from the browser through the React API client to Flask feature routes, recommendation logic, and relational storage. The graph also preserves career/project exploration and assessment-based skill updates. Route-to-feature details are grouped where source is not sampled; README architecture supports the main request flow, while inspected source confirms app registration and selected route behavior.

Main entry points: [`backend/app.py`](https://github.com/mhemanthsai456/major-project/blob/main/backend/app.py) (Flask API), [`frontend/src/services/api.js`](https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/services/api.js) (API client), [`backend/models.py`](https://github.com/mhemanthsai456/major-project/blob/main/backend/models.py) (Domain models), [`backend/recommendation.py`](https://github.com/mhemanthsai456/major-project/blob/main/backend/recommendation.py) (Recommendation engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learner["Student experience"]
  node_webapp["React application<br/>[App.jsx]"]
  node_authui["Authentication state<br/>[AuthContext.jsx]"]
  node_apiclient["API client<br/>[api.js]"]
  node_careerview["Career exploration<br/>[Careers.jsx]"]
  node_dashboard["Learning dashboard<br/>[Dashboard.jsx]"]
  node_gapview["Skill gap view<br/>[SkillGapPage.jsx]"]
  node_topicview["Topic learning<br/>[TopicDetail.jsx]"]
  node_progressui["Progress indicators<br/>[ProgressRing.jsx]"]
end

subgraph group_backend["API and domain"]
  node_flask["Flask API<br/>[app.py]"]
  node_authroutes["Account routes<br/>[auth_routes.py]"]
  node_careerroute["Career routes<br/>[career_routes.py]"]
  node_topicroute["Topic routes<br/>[topic_routes.py]"]
  node_engine["Recommendation engine<br/>[recommendation.py]"]
  node_authlogic["Token and auth logic<br/>[auth_utils.py]"]
end

subgraph group_learning["Learning journey"]
  node_assessment["Assessment routes"]
  node_recommendationroutes["Recommendation routes"]
  node_roadmaproutes["Roadmap routes<br/>[roadmap_routes.py]"]
  node_progressroutes["Progress routes<br/>[progress_routes.py]"]
  node_projectroute["Projects and resources"]
end

subgraph group_persistence["State and storage"]
  node_models["Domain models<br/>[models.py]"]
  node_database["SQLAlchemy layer<br/>[database.py]"]
  node_sqlite[("SQLite database")]
end

node_student(("Student"))

node_student -->|"uses"| node_webapp
node_webapp -.->|"requests data"| node_apiclient
node_webapp -->|"provides auth"| node_authui
node_authui -->|"calls"| node_apiclient
node_careerview -->|"requests data"| node_apiclient
node_dashboard -->|"requests data"| node_apiclient
node_gapview -->|"requests data"| node_apiclient
node_topicview -->|"requests data"| node_apiclient
node_dashboard -->|"renders"| node_progressui
node_apiclient -->|"sends JSON"| node_flask
node_flask -->|"registers"| node_authroutes
node_flask -->|"registers"| node_careerroute
node_flask -->|"registers"| node_topicroute
node_flask -->|"registers"| node_assessment
node_flask -->|"registers"| node_recommendationroutes
node_flask -->|"registers"| node_roadmaproutes
node_flask -->|"registers"| node_progressroutes
node_flask -->|"registers routes"| node_projectroute
node_authroutes -->|"uses"| node_authlogic
node_authroutes -->|"reads and writes"| node_models
node_careerroute -->|"calls"| node_engine
node_recommendationroutes -->|"calls"| node_engine
node_roadmaproutes -->|"calls"| node_engine
node_assessment -->|"records attempts"| node_models
node_assessment -->|"updates mastery"| node_models
node_topicroute -->|"queries topics"| node_models
node_progressroutes -->|"tracks completion"| node_models
node_engine -->|"queries learning state"| node_models
node_models -->|"uses ORM"| node_database
node_database -->|"persists data"| node_sqlite

click node_webapp "https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/context/AuthContext.jsx"
click node_apiclient "https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/services/api.js"
click node_careerview "https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/pages/Careers.jsx"
click node_dashboard "https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/pages/Dashboard.jsx"
click node_gapview "https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/pages/SkillGapPage.jsx"
click node_topicview "https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/pages/TopicDetail.jsx"
click node_progressui "https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/components/ProgressRing.jsx"
click node_flask "https://github.com/mhemanthsai456/major-project/blob/main/backend/app.py"
click node_authroutes "https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/auth_routes.py"
click node_careerroute "https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/career_routes.py"
click node_topicroute "https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/topic_routes.py"
click node_assessment "https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/assessment_routes.py"
click node_recommendationroutes "https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/recommendation_routes.py"
click node_roadmaproutes "https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/roadmap_routes.py"
click node_progressroutes "https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/progress_routes.py"
click node_projectroute "https://github.com/mhemanthsai456/major-project/tree/main/backend/routes"
click node_engine "https://github.com/mhemanthsai456/major-project/blob/main/backend/recommendation.py"
click node_authlogic "https://github.com/mhemanthsai456/major-project/blob/main/backend/utils/auth_utils.py"
click node_models "https://github.com/mhemanthsai456/major-project/blob/main/backend/models.py"
click node_database "https://github.com/mhemanthsai456/major-project/blob/main/backend/database.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_webapp,node_authui,node_apiclient,node_careerview,node_dashboard,node_gapview,node_topicview,node_progressui toneBlue
class node_flask,node_authroutes,node_careerroute,node_topicroute,node_engine,node_authlogic toneAmber
class node_assessment,node_recommendationroutes,node_roadmaproutes,node_progressroutes,node_projectroute toneMint
class node_models,node_database,node_sqlite toneRose
class node_student toneIndigo
```

## Components

### Student experience

- [React application](https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Authentication state](https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Career exploration](https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/pages/Careers.jsx): `frontend/src/pages/Careers.jsx`
- [Learning dashboard](https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Skill gap view](https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/pages/SkillGapPage.jsx): `frontend/src/pages/SkillGapPage.jsx`
- [Topic learning](https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/pages/TopicDetail.jsx): `frontend/src/pages/TopicDetail.jsx`
- [Progress indicators](https://github.com/mhemanthsai456/major-project/blob/main/frontend/src/components/ProgressRing.jsx): `frontend/src/components/ProgressRing.jsx`

### API and domain

- [Flask API](https://github.com/mhemanthsai456/major-project/blob/main/backend/app.py): `backend/app.py`
- [Account routes](https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/auth_routes.py): `backend/routes/auth_routes.py`
- [Career routes](https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/career_routes.py): `backend/routes/career_routes.py`
- [Topic routes](https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/topic_routes.py): `backend/routes/topic_routes.py`
- [Recommendation engine](https://github.com/mhemanthsai456/major-project/blob/main/backend/recommendation.py): `backend/recommendation.py`
- [Token and auth logic](https://github.com/mhemanthsai456/major-project/blob/main/backend/utils/auth_utils.py): `backend/utils/auth_utils.py`

### Learning journey

- [Assessment routes](https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/assessment_routes.py): `backend/routes/assessment_routes.py`
- [Recommendation routes](https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/recommendation_routes.py): `backend/routes/recommendation_routes.py`
- [Roadmap routes](https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/roadmap_routes.py): `backend/routes/roadmap_routes.py`
- [Progress routes](https://github.com/mhemanthsai456/major-project/blob/main/backend/routes/progress_routes.py): `backend/routes/progress_routes.py`
- [Projects and resources](https://github.com/mhemanthsai456/major-project/tree/main/backend/routes): `backend/routes`

### State and storage

- [Domain models](https://github.com/mhemanthsai456/major-project/blob/main/backend/models.py): `backend/models.py`
- [SQLAlchemy layer](https://github.com/mhemanthsai456/major-project/blob/main/backend/database.py): `backend/database.py`
- **SQLite database**

### Other components

- **Student**

## Connections

- Student → React application: uses
- React application → API client: requests data
- React application → Authentication state: provides auth (evidence: `frontend/src/App.jsx`)
- Authentication state → API client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Career exploration → API client: requests data (evidence: `frontend/src/pages/Careers.jsx`)
- Learning dashboard → API client: requests data (evidence: `frontend/src/pages/Dashboard.jsx`)
- Skill gap view → API client: requests data (evidence: `frontend/src/pages/SkillGapPage.jsx`)
- Topic learning → API client: requests data (evidence: `frontend/src/pages/TopicDetail.jsx`)
- Learning dashboard → Progress indicators: renders (evidence: `frontend/src/pages/Dashboard.jsx`)
- API client → Flask API: sends JSON
- Flask API → Account routes: registers (evidence: `backend/app.py`)
- Flask API → Career routes: registers (evidence: `backend/app.py`)
- Flask API → Topic routes: registers (evidence: `backend/app.py`)
- Flask API → Assessment routes: registers (evidence: `backend/app.py`)
- Flask API → Recommendation routes: registers (evidence: `backend/app.py`)
- Flask API → Roadmap routes: registers (evidence: `backend/app.py`)
- Flask API → Progress routes: registers (evidence: `backend/app.py`)
- Flask API → Projects and resources: registers routes (evidence: `backend/app.py`)
- Account routes → Token and auth logic: uses (evidence: `backend/routes/auth_routes.py`)
- Account routes → Domain models: reads and writes (evidence: `backend/routes/auth_routes.py`)
- Career routes → Recommendation engine: calls (evidence: `backend/routes/career_routes.py`)
- Recommendation routes → Recommendation engine: calls (evidence: `backend/routes/recommendation_routes.py`)
- Roadmap routes → Recommendation engine: calls (evidence: `backend/routes/roadmap_routes.py`)
- Assessment routes → Domain models: records attempts (evidence: `backend/routes/assessment_routes.py`)
- Assessment routes → Domain models: updates mastery (evidence: `backend/routes/assessment_routes.py`)
- Topic routes → Domain models: queries topics (evidence: `backend/routes/topic_routes.py`)
- Progress routes → Domain models: tracks completion (evidence: `backend/routes/progress_routes.py`)
- Recommendation engine → Domain models: queries learning state (evidence: `backend/recommendation.py`)
- Domain models → SQLAlchemy layer: uses ORM (evidence: `backend/models.py`)
- SQLAlchemy layer → SQLite database: persists data
