# iamvivekdatta/careerconnect-v2 architecture

> Architecture diagram of the GitHub repository iamvivekdatta/careerconnect-v2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iamvivekdatta/careerconnect-v2
- Repository: https://github.com/iamvivekdatta/careerconnect-v2

## Overview

CareerConnect is a role-based network for students, alumni, and administrators. Users enter through public authentication, then use the protected community app to build profiles, connect, share posts, message, and find jobs or training; achievements and recommendations support ongoing engagement. Admins govern users, content, opportunities, and platform health. The client communicates with an Express API backed by MongoDB. The graph preserves documented feature areas, while some unsampled module wiring is omitted or marked unverified.

Main entry points: [`client/src/main.tsx`](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/main.tsx) (Client entry and routes), [`server/src/server.ts`](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/server.ts) (Express API routing), [`server/src/routes/opportunityRoutes.ts`](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/routes/opportunityRoutes.ts) (Opportunity routes), [`server/src/routes/achievementRoutes.ts`](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/routes/achievementRoutes.ts) (Achievement routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client application"]
  node_client_entry["Client entry and routes<br/>[main.tsx]"]
  node_auth_ui["Authentication pages"]
  node_auth_state["Auth state<br/>[useAuthStore.ts]"]
end

subgraph group_community["Community features"]
  node_feed["Feed and posts<br/>[FeedPage.tsx]"]
  node_profile["Profiles<br/>[ProfilePage.tsx]"]
  node_connections["Connections"]
  node_alumni["Alumni directory"]
  node_messaging["Messaging UI<br/>[MessagesPage.tsx]"]
  node_socket_client["Realtime client<br/>[SocketProvider.tsx]"]
end

subgraph group_growth["Opportunities and growth"]
  node_opportunities["Opportunity discovery"]
  node_training["Training recommendations"]
  node_achievements["Achievements and badges"]
end

subgraph group_backend["API and persistence"]
  node_api["Express API routing<br/>[server.ts]"]
  node_auth_middleware["Authentication guard<br/>[authMiddleware.ts]"]
  node_opportunity_routes["Opportunity routes"]
  node_achievement_routes["Achievement routes"]
  node_achievement_logic["Achievement logic"]
  node_message_logic["Messaging logic"]
  node_user_model["User records<br/>[User.ts]"]
  node_mongo[("MongoDB")]
end

subgraph group_admin["Administration"]
  node_admin_ui["Admin portal"]
  node_admin_logic["Admin governance<br/>[adminController.ts]"]
end

node_members(("Students and alumni"))
node_admins(("Administrators"))
node_cloudinary["Cloudinary uploads"]

node_members -->|"use"| node_client_entry
node_admins -->|"use"| node_client_entry
node_client_entry -->|"routes to"| node_auth_ui
node_client_entry -->|"routes to"| node_feed
node_client_entry -->|"routes to"| node_profile
node_client_entry -->|"routes to"| node_connections
node_client_entry -->|"routes to"| node_alumni
node_client_entry -->|"routes to"| node_messaging
node_client_entry -->|"routes to"| node_opportunities
node_client_entry -->|"routes to"| node_achievements
node_client_entry -->|"routes to"| node_admin_ui
node_client_entry -.->|"provides auth state"| node_auth_state
node_client_entry -->|"sends API requests"| node_api
node_client_entry -->|"mounts"| node_socket_client
node_client_entry -.->|"shows recommendations"| node_training
node_api -->|"mounts"| node_opportunity_routes
node_api -->|"mounts"| node_achievement_routes
node_api -.->|"uses for protected routes"| node_auth_middleware
node_opportunity_routes -->|"guards requests"| node_auth_middleware
node_opportunity_routes -->|"dispatches approval"| node_admin_logic
node_achievement_routes -->|"guards requests"| node_auth_middleware
node_achievement_routes -->|"dispatches"| node_achievement_logic
node_achievement_logic -->|"reads and updates"| node_user_model
node_achievement_logic -.->|"persists records"| node_mongo
node_message_logic -.->|"reads and writes messages"| node_mongo
node_message_logic -.->|"emits conversation events"| node_socket_client
node_admin_ui -.->|"requests governance actions"| node_api
node_admin_logic -->|"queries users"| node_user_model
node_admin_logic -.->|"queries platform records"| node_mongo
node_api -.->|"uploads assets"| node_cloudinary

click node_client_entry "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/main.tsx"
click node_auth_ui "https://github.com/iamvivekdatta/careerconnect-v2/tree/main/client/src/pages/public"
click node_auth_state "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/store/useAuthStore.ts"
click node_feed "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/FeedPage.tsx"
click node_profile "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/ProfilePage.tsx"
click node_connections "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/ConnectionsPage.tsx"
click node_alumni "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/AlumniDirectoryPage.tsx"
click node_messaging "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/MessagesPage.tsx"
click node_socket_client "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/providers/SocketProvider.tsx"
click node_opportunities "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/OpportunitiesPage.tsx"
click node_training "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/components/organisms/TrainingOpportunitiesCarousel.tsx"
click node_achievements "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/AchievementsPage.tsx"
click node_api "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/server.ts"
click node_auth_middleware "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/middlewares/authMiddleware.ts"
click node_opportunity_routes "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/routes/opportunityRoutes.ts"
click node_achievement_routes "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/routes/achievementRoutes.ts"
click node_achievement_logic "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/controllers/achievementController.ts"
click node_message_logic "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/controllers/messagingController.ts"
click node_admin_ui "https://github.com/iamvivekdatta/careerconnect-v2/tree/main/client/src/pages/admin"
click node_admin_logic "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/controllers/adminController.ts"
click node_user_model "https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/models/User.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_client_entry,node_auth_ui,node_auth_state toneBlue
class node_feed,node_profile,node_connections,node_alumni,node_messaging,node_socket_client toneAmber
class node_opportunities,node_training,node_achievements toneMint
class node_api,node_auth_middleware,node_opportunity_routes,node_achievement_routes,node_achievement_logic,node_message_logic,node_user_model,node_mongo toneRose
class node_admin_ui,node_admin_logic,node_members,node_admins,node_cloudinary toneIndigo
```

## Components

### Client application

- [Client entry and routes](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/main.tsx): `client/src/main.tsx`
- [Authentication pages](https://github.com/iamvivekdatta/careerconnect-v2/tree/main/client/src/pages/public): `client/src/pages/public`
- [Auth state](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/store/useAuthStore.ts): `client/src/store/useAuthStore.ts`

### Community features

- [Feed and posts](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/FeedPage.tsx): `client/src/pages/FeedPage.tsx`
- [Profiles](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/ProfilePage.tsx): `client/src/pages/ProfilePage.tsx`
- [Connections](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/ConnectionsPage.tsx): `client/src/pages/ConnectionsPage.tsx`
- [Alumni directory](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/AlumniDirectoryPage.tsx): `client/src/pages/AlumniDirectoryPage.tsx`
- [Messaging UI](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/MessagesPage.tsx): `client/src/pages/MessagesPage.tsx`
- [Realtime client](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/providers/SocketProvider.tsx): `client/src/providers/SocketProvider.tsx`

### Opportunities and growth

- [Opportunity discovery](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/OpportunitiesPage.tsx): `client/src/pages/OpportunitiesPage.tsx`
- [Training recommendations](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/components/organisms/TrainingOpportunitiesCarousel.tsx): `client/src/components/organisms/TrainingOpportunitiesCarousel.tsx`
- [Achievements and badges](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/client/src/pages/AchievementsPage.tsx): `client/src/pages/AchievementsPage.tsx`

### API and persistence

- [Express API routing](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/server.ts): `server/src/server.ts`
- [Authentication guard](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/middlewares/authMiddleware.ts): `server/src/middlewares/authMiddleware.ts`
- [Opportunity routes](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/routes/opportunityRoutes.ts): `server/src/routes/opportunityRoutes.ts`
- [Achievement routes](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/routes/achievementRoutes.ts): `server/src/routes/achievementRoutes.ts`
- [Achievement logic](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/controllers/achievementController.ts): `server/src/controllers/achievementController.ts`
- [Messaging logic](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/controllers/messagingController.ts): `server/src/controllers/messagingController.ts`
- [User records](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/models/User.ts): `server/src/models/User.ts`
- **MongoDB**

### Administration

- [Admin portal](https://github.com/iamvivekdatta/careerconnect-v2/tree/main/client/src/pages/admin): `client/src/pages/admin`
- [Admin governance](https://github.com/iamvivekdatta/careerconnect-v2/blob/main/server/src/controllers/adminController.ts): `server/src/controllers/adminController.ts`

### Other components

- **Students and alumni**
- **Administrators**
- **Cloudinary uploads**

## Connections

- Students and alumni → Client entry and routes: use (evidence: `README.md`)
- Administrators → Client entry and routes: use (evidence: `README.md`)
- Client entry and routes → Authentication pages: routes to
- Client entry and routes → Feed and posts: routes to
- Client entry and routes → Profiles: routes to
- Client entry and routes → Connections: routes to
- Client entry and routes → Alumni directory: routes to
- Client entry and routes → Messaging UI: routes to
- Client entry and routes → Opportunity discovery: routes to
- Client entry and routes → Achievements and badges: routes to
- Client entry and routes → Admin portal: routes to
- Client entry and routes → Auth state: provides auth state
- Client entry and routes → Express API routing: sends API requests (evidence: `README.md`)
- Client entry and routes → Realtime client: mounts (evidence: `client/src/main.tsx`)
- Client entry and routes → Training recommendations: shows recommendations
- Express API routing → Opportunity routes: mounts (evidence: `server/src/server.ts`)
- Express API routing → Achievement routes: mounts (evidence: `server/src/server.ts`)
- Express API routing → Authentication guard: uses for protected routes
- Opportunity routes → Authentication guard: guards requests (evidence: `server/src/routes/opportunityRoutes.ts`)
- Opportunity routes → Admin governance: dispatches approval (evidence: `server/src/routes/opportunityRoutes.ts`)
- Achievement routes → Authentication guard: guards requests (evidence: `server/src/routes/achievementRoutes.ts`)
- Achievement routes → Achievement logic: dispatches (evidence: `server/src/routes/achievementRoutes.ts`)
- Achievement logic → User records: reads and updates (evidence: `server/src/controllers/achievementController.ts`)
- Achievement logic → MongoDB: persists records
- Messaging logic → MongoDB: reads and writes messages
- Messaging logic → Realtime client: emits conversation events
- Admin portal → Express API routing: requests governance actions
- Admin governance → User records: queries users (evidence: `server/src/controllers/adminController.ts`)
- Admin governance → MongoDB: queries platform records
- Express API routing → Cloudinary uploads: uploads assets
