# naveenk1139/u-think architecture

> Architecture diagram of the GitHub repository naveenk1139/u-think, 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/naveenk1139/u-think
- Repository: https://github.com/naveenk1139/u-think

## Overview

U-THINK is a student education and career navigation platform focused on Karnataka. Students explore post-10th pathways, institutions, exams, and careers, then use personalized guidance and student tools to plan next steps. The graph shows the React entry and key catalog and guidance branches alongside backend services and persistent data. Several feature subsystems are represented from README descriptions and tree paths because their implementation files were not sampled; those relationships are documented rather than claims of inspected calls.

Main entry points: [`backend/src/index.ts`](https://github.com/naveenk1139/u-think/blob/main/backend/src/index.ts) (Express API server), [`frontend/src/App.tsx`](https://github.com/naveenk1139/u-think/blob/main/frontend/src/App.tsx) (Web application), [`backend/src/routes/educationGraphRoutes.ts`](https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/educationGraphRoutes.ts) (Knowledge graph API), [`frontend/src/contexts/AuthContext.tsx`](https://github.com/naveenk1139/u-think/blob/main/frontend/src/contexts/AuthContext.tsx) (Account context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Student experience"]
  node_app["Web application<br/>[App.tsx]"]
  node_authui["Account context<br/>[AuthContext.tsx]"]
  node_collegeui["College directory"]
  node_jobui["Job finder<br/>[JobFinder.tsx]"]
  node_dashboard["Student dashboard"]
  node_pathwaysui["Pathways explorer"]
  node_specializations["Engineering specializations"]
  node_http["HTTP API client<br/>[axios.ts]"]
end

subgraph group_api["API and catalogs"]
  node_server["Express API server<br/>[index.ts]"]
  node_auth["Authentication<br/>[authController.ts]"]
  node_collegeapi["College catalog API<br/>[collegeRoutes.ts]"]
  node_pathwayapi["Education catalog"]
  node_graphapi["Knowledge graph API"]
end

subgraph group_guidance["Guidance services"]
  node_ai["AI counselor<br/>[geminiService.ts]"]
  node_recommendations["Recommendations"]
  node_studenttools["Roadmaps and deadlines<br/>[roadmapRoutes.ts]"]
  node_jobs["Career and job services<br/>[JobService.ts]"]
  node_documents["Document analysis<br/>[documentRoutes.ts]"]
  node_mentorship["Mentorship<br/>[mentorRoutes.ts]"]
end

subgraph group_data["Persistent data"]
  node_userstore[("Student profiles<br/>[User.ts]")]
  node_collegestore[("Institution records<br/>[College.ts]")]
  node_pathwaystore[("Education graph records<br/>[Pathway.ts]")]
end

node_student(("Student"))

node_student -->|"explores"| node_app
node_app -->|"routes to"| node_collegeui
node_app -->|"routes to"| node_pathwaysui
node_student -->|"signs in"| node_authui
node_authui -->|"calls"| node_http
node_http -->|"requests"| node_server
node_server -->|"mounts auth routes"| node_auth
node_server -->|"mounts catalog"| node_collegeapi
node_collegeapi -->|"queries"| node_collegestore
node_server -->|"serves catalog"| node_pathwayapi
node_pathwayapi -->|"reads pathways"| node_pathwaystore
node_pathwaysui -.->|"presents options"| node_specializations
node_student -->|"finds work"| node_jobui
node_student -->|"tracks progress"| node_dashboard
node_student -->|"gets guidance"| node_recommendations
node_student -->|"plans next steps"| node_studenttools
node_student -->|"uploads records"| node_documents
node_student -->|"seeks mentoring"| node_mentorship
node_student -->|"explores routes"| node_graphapi
node_graphapi -->|"builds graph context"| node_pathwaystore
node_graphapi -->|"requests guidance"| node_ai
node_auth -->|"reads accounts"| node_userstore

click node_app "https://github.com/naveenk1139/u-think/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/naveenk1139/u-think/blob/main/frontend/src/contexts/AuthContext.tsx"
click node_collegeui "https://github.com/naveenk1139/u-think/blob/main/frontend/src/components/CollegesDirectory.tsx"
click node_jobui "https://github.com/naveenk1139/u-think/blob/main/frontend/src/components/JobFinder.tsx"
click node_dashboard "https://github.com/naveenk1139/u-think/blob/main/frontend/src/components/StudentDashboard.tsx"
click node_pathwaysui "https://github.com/naveenk1139/u-think/blob/main/frontend/src/components/PathwaysExplorer.tsx"
click node_specializations "https://github.com/naveenk1139/u-think/blob/main/frontend/src/data/engineeringSpecializations.ts"
click node_http "https://github.com/naveenk1139/u-think/blob/main/frontend/src/api/axios.ts"
click node_server "https://github.com/naveenk1139/u-think/blob/main/backend/src/index.ts"
click node_auth "https://github.com/naveenk1139/u-think/blob/main/backend/src/controllers/authController.ts"
click node_collegeapi "https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/collegeRoutes.ts"
click node_pathwayapi "https://github.com/naveenk1139/u-think/blob/main/backend/src/controllers/pathwayController.ts"
click node_graphapi "https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/educationGraphRoutes.ts"
click node_ai "https://github.com/naveenk1139/u-think/blob/main/backend/src/services/geminiService.ts"
click node_recommendations "https://github.com/naveenk1139/u-think/blob/main/backend/src/controllers/recommendationController.ts"
click node_studenttools "https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/roadmapRoutes.ts"
click node_jobs "https://github.com/naveenk1139/u-think/blob/main/backend/src/services/JobService.ts"
click node_documents "https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/documentRoutes.ts"
click node_mentorship "https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/mentorRoutes.ts"
click node_userstore "https://github.com/naveenk1139/u-think/blob/main/backend/src/models/User.ts"
click node_collegestore "https://github.com/naveenk1139/u-think/blob/main/backend/src/models/College.ts"
click node_pathwaystore "https://github.com/naveenk1139/u-think/blob/main/backend/src/models/Pathway.ts"

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_collegeui,node_jobui,node_dashboard,node_pathwaysui,node_specializations,node_http toneBlue
class node_server,node_auth,node_collegeapi,node_pathwayapi,node_graphapi toneAmber
class node_ai,node_recommendations,node_studenttools,node_jobs,node_documents,node_mentorship toneMint
class node_userstore,node_collegestore,node_pathwaystore toneRose
class node_student toneIndigo
```

## Components

### Student experience

- [Web application](https://github.com/naveenk1139/u-think/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Account context](https://github.com/naveenk1139/u-think/blob/main/frontend/src/contexts/AuthContext.tsx): `frontend/src/contexts/AuthContext.tsx`
- [College directory](https://github.com/naveenk1139/u-think/blob/main/frontend/src/components/CollegesDirectory.tsx): `frontend/src/components/CollegesDirectory.tsx`
- [Job finder](https://github.com/naveenk1139/u-think/blob/main/frontend/src/components/JobFinder.tsx): `frontend/src/components/JobFinder.tsx`
- [Student dashboard](https://github.com/naveenk1139/u-think/blob/main/frontend/src/components/StudentDashboard.tsx): `frontend/src/components/StudentDashboard.tsx`
- [Pathways explorer](https://github.com/naveenk1139/u-think/blob/main/frontend/src/components/PathwaysExplorer.tsx): `frontend/src/components/PathwaysExplorer.tsx`
- [Engineering specializations](https://github.com/naveenk1139/u-think/blob/main/frontend/src/data/engineeringSpecializations.ts): `frontend/src/data/engineeringSpecializations.ts`
- [HTTP API client](https://github.com/naveenk1139/u-think/blob/main/frontend/src/api/axios.ts): `frontend/src/api/axios.ts`

### API and catalogs

- [Express API server](https://github.com/naveenk1139/u-think/blob/main/backend/src/index.ts): `backend/src/index.ts`
- [Authentication](https://github.com/naveenk1139/u-think/blob/main/backend/src/controllers/authController.ts): `backend/src/controllers/authController.ts`
- [College catalog API](https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/collegeRoutes.ts): `backend/src/routes/collegeRoutes.ts`
- [Education catalog](https://github.com/naveenk1139/u-think/blob/main/backend/src/controllers/pathwayController.ts): `backend/src/controllers/pathwayController.ts`
- [Knowledge graph API](https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/educationGraphRoutes.ts): `backend/src/routes/educationGraphRoutes.ts`

### Guidance services

- [AI counselor](https://github.com/naveenk1139/u-think/blob/main/backend/src/services/geminiService.ts): `backend/src/services/geminiService.ts`
- [Recommendations](https://github.com/naveenk1139/u-think/blob/main/backend/src/controllers/recommendationController.ts): `backend/src/controllers/recommendationController.ts`
- [Roadmaps and deadlines](https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/roadmapRoutes.ts): `backend/src/routes/roadmapRoutes.ts`
- [Career and job services](https://github.com/naveenk1139/u-think/blob/main/backend/src/services/JobService.ts): `backend/src/services/JobService.ts`
- [Document analysis](https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/documentRoutes.ts): `backend/src/routes/documentRoutes.ts`
- [Mentorship](https://github.com/naveenk1139/u-think/blob/main/backend/src/routes/mentorRoutes.ts): `backend/src/routes/mentorRoutes.ts`

### Persistent data

- [Student profiles](https://github.com/naveenk1139/u-think/blob/main/backend/src/models/User.ts): `backend/src/models/User.ts`
- [Institution records](https://github.com/naveenk1139/u-think/blob/main/backend/src/models/College.ts): `backend/src/models/College.ts`
- [Education graph records](https://github.com/naveenk1139/u-think/blob/main/backend/src/models/Pathway.ts): `backend/src/models/Pathway.ts`

### Other components

- **Student**

## Connections

- Student → Web application: explores (evidence: `README.md`)
- Web application → College directory: routes to (evidence: `frontend/src/App.tsx`)
- Web application → Pathways explorer: routes to (evidence: `frontend/src/App.tsx`)
- Student → Account context: signs in (evidence: `README.md`)
- Account context → HTTP API client: calls (evidence: `frontend/src/contexts/AuthContext.tsx`)
- HTTP API client → Express API server: requests (evidence: `README.md`)
- Express API server → Authentication: mounts auth routes (evidence: `backend/src/index.ts`)
- Express API server → College catalog API: mounts catalog (evidence: `backend/src/index.ts`)
- College catalog API → Institution records: queries (evidence: `backend/src/routes/collegeRoutes.ts`)
- Express API server → Education catalog: serves catalog (evidence: `backend/src/index.ts`)
- Education catalog → Education graph records: reads pathways (evidence: `backend/src/controllers/pathwayController.ts`)
- Pathways explorer → Engineering specializations: presents options
- Student → Job finder: finds work (evidence: `README.md`)
- Student → Student dashboard: tracks progress (evidence: `README.md`)
- Student → Recommendations: gets guidance (evidence: `README.md`)
- Student → Roadmaps and deadlines: plans next steps (evidence: `README.md`)
- Student → Document analysis: uploads records (evidence: `README.md`)
- Student → Mentorship: seeks mentoring (evidence: `README.md`)
- Student → Knowledge graph API: explores routes (evidence: `README.md`)
- Knowledge graph API → Education graph records: builds graph context (evidence: `backend/src/routes/educationGraphRoutes.ts`)
- Knowledge graph API → AI counselor: requests guidance (evidence: `backend/src/routes/educationGraphRoutes.ts`)
- Authentication → Student profiles: reads accounts (evidence: `backend/src/controllers/authController.ts`)
