# anikethgowda-cr/career-guru architecture

> Architecture diagram of the GitHub repository anikethgowda-cr/career-guru, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anikethgowda-cr/career-guru
- Repository: https://github.com/anikethgowda-cr/career-guru

## Overview

CareerGuru is a career-development and mentorship platform for learners and mentors. Learners build profiles, explore mentors, access learning and interview resources, take assessments, and communicate with mentors; mentors manage mentees and create assessments and reports. The backend exposes these capabilities through an Express API, with MongoDB-backed domain data and AI-assisted assessment/report generation. The graph combines sampled routing and assessment flows with major subsystems identified in the source index; unsampled subsystem internals and frontend-to-API wiring are not asserted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/anikethgowda-cr/career-guru/blob/main/frontend/src/App.jsx) (Role-based app), [`backend/server.js`](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/server.js) (Express API server), [`backend/routes/userRoutes.js`](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/userRoutes.js) (User API routes), [`backend/routes/assessmentRoutes.js`](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/assessmentRoutes.js) (Assessment routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_webapp["Role-based app<br/>[App.jsx]"]
  node_authui["Authentication state<br/>[AuthSlice.jsx]"]
  node_careerui["Career pages"]
  node_assessmentui["Assessment experience<br/>[Assessment.jsx]"]
  node_reportui["Assessment reports"]
  node_mentorui["Mentor workspace"]
end

subgraph group_identity["Accounts and profiles"]
  node_userapi["User API routes<br/>[userRoutes.js]"]
  node_identitylogic["User account logic<br/>[user-cltr.js]"]
  node_profiledata[("User and mentor profiles")]
end

subgraph group_career["Career development"]
  node_careerapi["Career resource routes"]
  node_careerlogic["Career resource services"]
  node_assessmentapi["Assessment routes"]
  node_assessmentlogic["Assessment workflow<br/>[assessment-cltr.js]"]
  node_assessmentdata[("Assessment records")]
  node_aiengine["AI generation<br/>[aiServices.js]"]
end

subgraph group_mentorship["Mentorship"]
  node_mentorapi["Mentor API routes<br/>[mentorRoutes.js]"]
  node_mentorlogic["Mentor and mentee logic<br/>[mentor-cltr.js]"]
  node_conversationapi["Conversation routes"]
  node_chatservice["Realtime chat<br/>[chatSocket.js]"]
  node_chatdata[("Conversation and messages")]
  node_planpayment["Plans and payments"]
end

subgraph group_platform["API and services"]
  node_api["Express API server<br/>[server.js]"]
  node_authguard["Authentication and roles<br/>[authentication.js]"]
  node_database[("MongoDB<br/>[db.js]")]
  node_cloudinary["Cloudinary media<br/>[cloudinary.js]"]
end

node_learner(("Learner"))
node_mentor(("Mentor"))

node_learner -->|"uses"| node_webapp
node_mentor -->|"uses"| node_webapp
node_webapp -->|"checks auth"| node_authui
node_webapp -->|"routes to"| node_careerui
node_webapp -->|"routes to"| node_assessmentui
node_webapp -->|"routes to"| node_reportui
node_webapp -->|"routes to"| node_mentorui
node_authui -->|"requests account"| node_userapi
node_userapi -->|"routes requests"| node_identitylogic
node_mentorapi -->|"routes requests"| node_mentorlogic
node_userapi -->|"authenticates"| node_authguard
node_mentorapi -->|"authenticates"| node_authguard
node_identitylogic -->|"reads and writes"| node_profiledata
node_mentorlogic -->|"reads and writes"| node_profiledata
node_webapp -.->|"assessment requests"| node_assessmentapi
node_assessmentapi -->|"routes requests"| node_assessmentlogic
node_assessmentapi -->|"authenticates"| node_authguard
node_assessmentlogic -->|"reads and writes"| node_assessmentdata
node_assessmentlogic -->|"generates content"| node_aiengine
node_webapp -.->|"career requests"| node_careerapi
node_careerapi -.->|"dispatches"| node_careerlogic
node_webapp -.->|"mentor requests"| node_mentorapi
node_mentorlogic -->|"reads conversation data"| node_chatdata
node_webapp -.->|"chat requests"| node_conversationapi
node_api -->|"mounts routes"| node_conversationapi
node_api -->|"mounts routes"| node_assessmentapi
node_api -->|"mounts routes"| node_userapi
node_api -->|"mounts routes"| node_mentorapi
node_api -->|"starts sockets"| node_chatservice
node_chatservice -->|"reads and writes"| node_chatdata
node_api -->|"connects"| node_database
node_api -->|"initializes media"| node_cloudinary
node_api -->|"mounts plans"| node_planpayment

click node_webapp "https://github.com/anikethgowda-cr/career-guru/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/anikethgowda-cr/career-guru/blob/main/frontend/src/slices/AuthSlice.jsx"
click node_careerui "https://github.com/anikethgowda-cr/career-guru/tree/main/frontend/src/pages/user"
click node_assessmentui "https://github.com/anikethgowda-cr/career-guru/blob/main/frontend/src/pages/user/Assessment.jsx"
click node_reportui "https://github.com/anikethgowda-cr/career-guru/blob/main/frontend/src/components/shared/AssessmentReportFullPage.jsx"
click node_mentorui "https://github.com/anikethgowda-cr/career-guru/tree/main/frontend/src/pages/mentor"
click node_userapi "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/userRoutes.js"
click node_mentorapi "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/mentorRoutes.js"
click node_identitylogic "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/controller/user-cltr.js"
click node_mentorlogic "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/controller/mentor-cltr.js"
click node_profiledata "https://github.com/anikethgowda-cr/career-guru/tree/main/backend/models"
click node_careerapi "https://github.com/anikethgowda-cr/career-guru/tree/main/backend/routes"
click node_careerlogic "https://github.com/anikethgowda-cr/career-guru/tree/main/backend/controller"
click node_assessmentapi "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/assessmentRoutes.js"
click node_assessmentlogic "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/controller/assessment-cltr.js"
click node_assessmentdata "https://github.com/anikethgowda-cr/career-guru/tree/main/backend/models"
click node_aiengine "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/services/aiServices.js"
click node_conversationapi "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/conversationRoutes.js"
click node_chatservice "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/services/chatSocket.js"
click node_chatdata "https://github.com/anikethgowda-cr/career-guru/tree/main/backend/models"
click node_planpayment "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/mentorPlanRoutes.js"
click node_api "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/server.js"
click node_authguard "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/middleware/authentication.js"
click node_database "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/config/db.js"
click node_cloudinary "https://github.com/anikethgowda-cr/career-guru/blob/main/backend/config/cloudinary.js"

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_careerui,node_assessmentui,node_reportui,node_mentorui toneBlue
class node_userapi,node_identitylogic,node_profiledata toneAmber
class node_careerapi,node_careerlogic,node_assessmentapi,node_assessmentlogic,node_assessmentdata,node_aiengine toneMint
class node_mentorapi,node_mentorlogic,node_conversationapi,node_chatservice,node_chatdata,node_planpayment toneRose
class node_api,node_authguard,node_database,node_cloudinary,node_learner,node_mentor toneIndigo
```

## Components

### Web application

- [Role-based app](https://github.com/anikethgowda-cr/career-guru/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Authentication state](https://github.com/anikethgowda-cr/career-guru/blob/main/frontend/src/slices/AuthSlice.jsx): `frontend/src/slices/AuthSlice.jsx`
- [Career pages](https://github.com/anikethgowda-cr/career-guru/tree/main/frontend/src/pages/user): `frontend/src/pages/user`
- [Assessment experience](https://github.com/anikethgowda-cr/career-guru/blob/main/frontend/src/pages/user/Assessment.jsx): `frontend/src/pages/user/Assessment.jsx`
- [Assessment reports](https://github.com/anikethgowda-cr/career-guru/blob/main/frontend/src/components/shared/AssessmentReportFullPage.jsx): `frontend/src/components/shared/AssessmentReportFullPage.jsx`
- [Mentor workspace](https://github.com/anikethgowda-cr/career-guru/tree/main/frontend/src/pages/mentor): `frontend/src/pages/mentor`

### Accounts and profiles

- [User API routes](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [User account logic](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/controller/user-cltr.js): `backend/controller/user-cltr.js`
- [User and mentor profiles](https://github.com/anikethgowda-cr/career-guru/tree/main/backend/models): `backend/models`

### Career development

- [Career resource routes](https://github.com/anikethgowda-cr/career-guru/tree/main/backend/routes): `backend/routes`
- [Career resource services](https://github.com/anikethgowda-cr/career-guru/tree/main/backend/controller): `backend/controller`
- [Assessment routes](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/assessmentRoutes.js): `backend/routes/assessmentRoutes.js`
- [Assessment workflow](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/controller/assessment-cltr.js): `backend/controller/assessment-cltr.js`
- [Assessment records](https://github.com/anikethgowda-cr/career-guru/tree/main/backend/models): `backend/models`
- [AI generation](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/services/aiServices.js): `backend/services/aiServices.js`

### Mentorship

- [Mentor API routes](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/mentorRoutes.js): `backend/routes/mentorRoutes.js`
- [Mentor and mentee logic](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/controller/mentor-cltr.js): `backend/controller/mentor-cltr.js`
- [Conversation routes](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/conversationRoutes.js): `backend/routes/conversationRoutes.js`
- [Realtime chat](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/services/chatSocket.js): `backend/services/chatSocket.js`
- [Conversation and messages](https://github.com/anikethgowda-cr/career-guru/tree/main/backend/models): `backend/models`
- [Plans and payments](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/routes/mentorPlanRoutes.js): `backend/routes/mentorPlanRoutes.js`

### API and services

- [Express API server](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/server.js): `backend/server.js`
- [Authentication and roles](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/middleware/authentication.js): `backend/middleware/authentication.js`
- [MongoDB](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/config/db.js): `backend/config/db.js`
- [Cloudinary media](https://github.com/anikethgowda-cr/career-guru/blob/main/backend/config/cloudinary.js): `backend/config/cloudinary.js`

### Other components

- **Learner**
- **Mentor**

## Connections

- Learner → Role-based app: uses (evidence: `frontend/src/App.jsx`)
- Mentor → Role-based app: uses (evidence: `frontend/src/App.jsx`)
- Role-based app → Authentication state: checks auth (evidence: `frontend/src/App.jsx`)
- Role-based app → Career pages: routes to (evidence: `frontend/src/App.jsx`)
- Role-based app → Assessment experience: routes to (evidence: `frontend/src/App.jsx`)
- Role-based app → Assessment reports: routes to (evidence: `frontend/src/App.jsx`)
- Role-based app → Mentor workspace: routes to (evidence: `frontend/src/App.jsx`)
- Authentication state → User API routes: requests account (evidence: `frontend/src/slices/AuthSlice.jsx`)
- User API routes → User account logic: routes requests (evidence: `backend/routes/userRoutes.js`)
- Mentor API routes → Mentor and mentee logic: routes requests (evidence: `backend/routes/mentorRoutes.js`)
- User API routes → Authentication and roles: authenticates (evidence: `backend/routes/userRoutes.js`)
- Mentor API routes → Authentication and roles: authenticates (evidence: `backend/routes/mentorRoutes.js`)
- User account logic → User and mentor profiles: reads and writes (evidence: `backend/controller/user-cltr.js`)
- Mentor and mentee logic → User and mentor profiles: reads and writes (evidence: `backend/controller/mentor-cltr.js`)
- Role-based app → Assessment routes: assessment requests
- Assessment routes → Assessment workflow: routes requests (evidence: `backend/routes/assessmentRoutes.js`)
- Assessment routes → Authentication and roles: authenticates (evidence: `backend/routes/assessmentRoutes.js`)
- Assessment workflow → Assessment records: reads and writes (evidence: `backend/controller/assessment-cltr.js`)
- Assessment workflow → AI generation: generates content (evidence: `backend/controller/assessment-cltr.js`)
- Role-based app → Career resource routes: career requests
- Career resource routes → Career resource services: dispatches (evidence: `backend/routes/assessmentRoutes.js`)
- Role-based app → Mentor API routes: mentor requests
- Mentor and mentee logic → Conversation and messages: reads conversation data (evidence: `backend/controller/mentor-cltr.js`)
- Role-based app → Conversation routes: chat requests
- Express API server → Conversation routes: mounts routes (evidence: `backend/server.js`)
- Express API server → Assessment routes: mounts routes (evidence: `backend/server.js`)
- Express API server → User API routes: mounts routes (evidence: `backend/server.js`)
- Express API server → Mentor API routes: mounts routes (evidence: `backend/server.js`)
- Express API server → Realtime chat: starts sockets (evidence: `backend/server.js`)
- Realtime chat → Conversation and messages: reads and writes (evidence: `backend/services/chatSocket.js`)
- Express API server → MongoDB: connects (evidence: `backend/server.js`)
- Express API server → Cloudinary media: initializes media (evidence: `backend/server.js`)
- Express API server → Plans and payments: mounts plans (evidence: `backend/server.js`)
