# zohaib-0/ai-based-career-suggesting-system architecture

> Architecture diagram of the GitHub repository zohaib-0/ai-based-career-suggesting-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zohaib-0/ai-based-career-suggesting-system
- Repository: https://github.com/zohaib-0/ai-based-career-suggesting-system

## Overview

This is an AI career-counseling web app: users create or recover a profile, receive career recommendations, and compare their skills with suggested paths; a chatbot is also a documented product feature. The frontend routes these experiences and keeps user and recommendation state in browser storage. Django handles profile, recommendation, and chatbot requests, with MongoDB for profiles and a local Ollama service for generated advice. Learning materials and roadmaps are described in the README, but their implementation is not identifiable in the sampled sources. Connections are limited to shown calls and routing references.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/App.jsx) (App router), [`Backend/Career/myapp/views.py`](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Backend/Career/myapp/views.py) (Profile and AI handlers), [`Frontend/src/components/UserContext.jsx`](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/UserContext.jsx) (User state), [`Frontend/src/pages/CourseRecommendation.jsx`](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/pages/CourseRecommendation.jsx) (Career recommendations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Career guidance UI"]
  node_app["App router<br/>[App.jsx]"]
  node_dashboard["Dashboard shell<br/>[Dashboard.jsx]"]
  node_home["Career home<br/>[Home.jsx]"]
  node_chatui["Advisor chatbot UI<br/>[Chatbot.jsx]"]
  node_recommendations_ui["Career recommendations"]
  node_skillgap["Skill gap analysis<br/>[SkillGap.jsx]"]
  node_sidenav["Side navigation<br/>[SideNav.jsx]"]
  node_sidetab["Navigation tab<br/>[SideTab.jsx]"]
  node_logout["Logout control<br/>[Logout.jsx]"]
  node_learning["Learning materials and roadmaps"]
end

subgraph group_profile["Profile and state"]
  node_login["Email login<br/>[LoginPage.jsx]"]
  node_profile_form["Profile form<br/>[ProfileForm.jsx]"]
  node_user_state["User state<br/>[UserContext.jsx]"]
  node_recommendation_state["Recommendation state"]
end

subgraph group_backend["Django services"]
  node_django_urls["App API routes<br/>[urls.py]"]
  node_api_views["Profile and AI handlers<br/>[views.py]"]
  node_django_models["Data models<br/>[models.py]"]
end

subgraph group_integrations["Data and AI"]
  node_mongo[("MongoDB profiles")]
  node_ollama{{"Ollama model service"}}
  node_db_helper["Mongo connection helper<br/>[db_connection.py]"]
end

node_student(("Career seeker"))

node_student -->|"uses"| node_app
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_chatui
node_app -->|"routes to"| node_recommendations_ui
node_app -->|"routes to"| node_skillgap
node_app -->|"provides"| node_user_state
node_app -->|"provides"| node_recommendation_state
node_dashboard -->|"renders"| node_sidenav
node_sidenav -->|"renders"| node_sidetab
node_sidenav -->|"renders"| node_logout
node_login -->|"posts login"| node_api_views
node_login -->|"updates"| node_user_state
node_profile_form -->|"posts profile"| node_api_views
node_profile_form -->|"updates"| node_user_state
node_recommendations_ui -->|"gets recommendations"| node_api_views
node_recommendations_ui -->|"reads"| node_user_state
node_recommendations_ui -->|"stores results"| node_recommendation_state
node_skillgap -->|"reads skills"| node_user_state
node_skillgap -->|"reads results"| node_recommendation_state
node_django_urls -->|"routes to"| node_api_views
node_api_views -->|"reads and writes"| node_mongo
node_api_views -->|"requests generation"| node_ollama
node_django_models -->|"imports"| node_db_helper
node_learning -.->|"supports"| node_student

click node_app "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/App.jsx"
click node_dashboard "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/pages/Dashboard.jsx"
click node_home "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/pages/Home.jsx"
click node_chatui "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/Chatbot.jsx"
click node_recommendations_ui "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/pages/CourseRecommendation.jsx"
click node_skillgap "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/SkillGap.jsx"
click node_sidenav "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/SideNav.jsx"
click node_sidetab "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/SideTab.jsx"
click node_logout "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/Logout.jsx"
click node_login "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/pages/LoginPage.jsx"
click node_profile_form "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/ProfileForm.jsx"
click node_user_state "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/UserContext.jsx"
click node_recommendation_state "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/RecommendationContext.jsx"
click node_django_urls "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Backend/Career/myapp/urls.py"
click node_api_views "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Backend/Career/myapp/views.py"
click node_django_models "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Backend/Career/myapp/models.py"
click node_db_helper "https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Backend/Career/db_connection.py"
click node_learning "https://github.com/zohaib-0/ai-based-career-suggesting-system/tree/main/Frontend/src/pages"

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_dashboard,node_home,node_chatui,node_recommendations_ui,node_skillgap,node_sidenav,node_sidetab,node_logout,node_learning toneBlue
class node_login,node_profile_form,node_user_state,node_recommendation_state toneAmber
class node_django_urls,node_api_views,node_django_models toneMint
class node_mongo,node_ollama,node_db_helper toneRose
class node_student toneIndigo
```

## Components

### Career guidance UI

- [App router](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Dashboard shell](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/pages/Dashboard.jsx): `Frontend/src/pages/Dashboard.jsx`
- [Career home](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/pages/Home.jsx): `Frontend/src/pages/Home.jsx`
- [Advisor chatbot UI](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/Chatbot.jsx): `Frontend/src/components/Chatbot.jsx`
- [Career recommendations](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/pages/CourseRecommendation.jsx): `Frontend/src/pages/CourseRecommendation.jsx`
- [Skill gap analysis](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/SkillGap.jsx): `Frontend/src/components/SkillGap.jsx`
- [Side navigation](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/SideNav.jsx): `Frontend/src/components/SideNav.jsx`
- [Navigation tab](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/SideTab.jsx): `Frontend/src/components/SideTab.jsx`
- [Logout control](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/Logout.jsx): `Frontend/src/components/Logout.jsx`
- [Learning materials and roadmaps](https://github.com/zohaib-0/ai-based-career-suggesting-system/tree/main/Frontend/src/pages): `Frontend/src/pages`

### Profile and state

- [Email login](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/pages/LoginPage.jsx): `Frontend/src/pages/LoginPage.jsx`
- [Profile form](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/ProfileForm.jsx): `Frontend/src/components/ProfileForm.jsx`
- [User state](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/UserContext.jsx): `Frontend/src/components/UserContext.jsx`
- [Recommendation state](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Frontend/src/components/RecommendationContext.jsx): `Frontend/src/components/RecommendationContext.jsx`

### Django services

- [App API routes](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Backend/Career/myapp/urls.py): `Backend/Career/myapp/urls.py`
- [Profile and AI handlers](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Backend/Career/myapp/views.py): `Backend/Career/myapp/views.py`
- [Data models](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Backend/Career/myapp/models.py): `Backend/Career/myapp/models.py`

### Data and AI

- **MongoDB profiles**
- **Ollama model service**
- [Mongo connection helper](https://github.com/zohaib-0/ai-based-career-suggesting-system/blob/main/Backend/Career/db_connection.py): `Backend/Career/db_connection.py`

### Other components

- **Career seeker**

## Connections

- Career seeker → App router: uses (evidence: `README.md`)
- App router → Dashboard shell: routes to (evidence: `Frontend/src/App.jsx`)
- App router → Career home: routes to (evidence: `Frontend/src/App.jsx`)
- App router → Advisor chatbot UI: routes to (evidence: `Frontend/src/App.jsx`)
- App router → Career recommendations: routes to (evidence: `Frontend/src/App.jsx`)
- App router → Skill gap analysis: routes to (evidence: `Frontend/src/App.jsx`)
- App router → User state: provides (evidence: `Frontend/src/App.jsx`)
- App router → Recommendation state: provides (evidence: `Frontend/src/App.jsx`)
- Dashboard shell → Side navigation: renders (evidence: `Frontend/src/pages/Dashboard.jsx`)
- Side navigation → Navigation tab: renders (evidence: `Frontend/src/components/SideNav.jsx`)
- Side navigation → Logout control: renders (evidence: `Frontend/src/components/SideNav.jsx`)
- Email login → Profile and AI handlers: posts login (evidence: `Frontend/src/pages/LoginPage.jsx`)
- Email login → User state: updates (evidence: `Frontend/src/pages/LoginPage.jsx`)
- Profile form → Profile and AI handlers: posts profile (evidence: `Frontend/src/components/ProfileForm.jsx`)
- Profile form → User state: updates (evidence: `Frontend/src/components/ProfileForm.jsx`)
- Career recommendations → Profile and AI handlers: gets recommendations (evidence: `Frontend/src/pages/CourseRecommendation.jsx`)
- Career recommendations → User state: reads (evidence: `Frontend/src/pages/CourseRecommendation.jsx`)
- Career recommendations → Recommendation state: stores results (evidence: `Frontend/src/pages/CourseRecommendation.jsx`)
- Skill gap analysis → User state: reads skills (evidence: `Frontend/src/components/SkillGap.jsx`)
- Skill gap analysis → Recommendation state: reads results (evidence: `Frontend/src/components/SkillGap.jsx`)
- App API routes → Profile and AI handlers: routes to (evidence: `Backend/Career/myapp/urls.py`)
- Profile and AI handlers → MongoDB profiles: reads and writes (evidence: `Backend/Career/myapp/views.py`)
- Profile and AI handlers → Ollama model service: requests generation (evidence: `Backend/Career/myapp/views.py`)
- Data models → Mongo connection helper: imports (evidence: `Backend/Career/myapp/models.py`)
- Learning materials and roadmaps → Career seeker: supports (evidence: `README.md`)
