# angkon-kar/campushub architecture

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

- Interactive diagram: https://gitdiagram.com/angkon-kar/campushub
- Repository: https://github.com/angkon-kar/campushub

## Overview

CampusHub is a student academic-resource and community hub. Students browse and share resources, manage profiles, and use academic tools; posts and reviews enter moderator workflows before becoming public. The client also exposes CV guidance and resume checking, CGPA tools, and syllabus content. The server provides API routes backed by MongoDB models and Firebase token verification. Edges reflect the supplied excerpts, SOURCE INDEX references, or documented capabilities; unsampled page-to-API and tool internals are not inferred.

Main entry points: [`client/src/App.jsx`](https://github.com/angkon-kar/campushub/blob/main/client/src/App.jsx) (App Router), [`server/server.js`](https://github.com/angkon-kar/campushub/blob/main/server/server.js) (API Server), [`server/routes/reviewRoutes.js`](https://github.com/angkon-kar/campushub/blob/main/server/routes/reviewRoutes.js) (Review Routes), [`server/routes/adminRoutes.js`](https://github.com/angkon-kar/campushub/blob/main/server/routes/adminRoutes.js) (Admin Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Student Web App"]
  node_app["App Router<br/>[App.jsx]"]
  node_api_client["API Client<br/>[apiClient.js]"]
end

subgraph group_academic["Academic Tools"]
  node_cv_guide["CV Guide<br/>[CvGuidePage.jsx]"]
  node_resume_checker["Resume Checker"]
  node_cgpa["CGPA Tools<br/>[CgpaPage.jsx]"]
  node_syllabus["Syllabus<br/>[SyllabusPage.jsx]"]
end

subgraph group_community["Community Platform"]
  node_resource_hub["Resource Hub"]
  node_post_detail["Post Detail<br/>[PostDetailPage.jsx]"]
  node_create_post["Create Post<br/>[CreatePostPage.jsx]"]
  node_public_profile["Public Profile"]
  node_reviews_page["Reviews<br/>[ReviewsPage.jsx]"]
  node_review_form["Review Form<br/>[ReviewForm.jsx]"]
  node_admin_page["Admin Dashboard"]
end

subgraph group_backend["API and Identity"]
  node_server["API Server<br/>[server.js]"]
  node_auth_routes["Auth Routes<br/>[authRoutes.js]"]
  node_post_routes["Post Routes<br/>[postRoutes.js]"]
  node_profile_routes["Profile Routes<br/>[profileRoutes.js]"]
  node_review_routes["Review Routes<br/>[reviewRoutes.js]"]
  node_admin_routes["Admin Routes<br/>[adminRoutes.js]"]
  node_auth_middleware["Token Verification<br/>[authMiddleware.js]"]
  node_firebase_admin["Firebase Admin<br/>[firebaseAdmin.js]"]
end

subgraph group_data["Platform Data"]
  node_users[("User Records<br/>[User.js]")]
  node_posts[("Post Records<br/>[Post.js]")]
  node_reviews[("Review Records<br/>[Review.js]")]
end

node_student(("Student"))

node_student -->|"uses"| node_app
node_app -->|"routes to"| node_resource_hub
node_app -->|"routes to"| node_post_detail
node_app -->|"routes to"| node_create_post
node_app -->|"routes to"| node_cgpa
node_app -->|"routes to"| node_syllabus
node_app -->|"routes to"| node_reviews_page
node_app -->|"routes to"| node_admin_page
node_app -->|"routes to"| node_cv_guide
node_app -->|"routes to"| node_resume_checker
node_reviews_page -->|"requests data"| node_api_client
node_review_form -->|"submits review"| node_api_client
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_post_routes
node_server -->|"mounts"| node_profile_routes
node_server -->|"mounts"| node_review_routes
node_server -->|"mounts"| node_admin_routes
node_auth_routes -->|"verifies tokens"| node_auth_middleware
node_post_routes -->|"verifies tokens"| node_auth_middleware
node_review_routes -->|"verifies tokens"| node_auth_middleware
node_admin_routes -->|"verifies tokens"| node_auth_middleware
node_auth_middleware -->|"verifies identity"| node_firebase_admin
node_auth_routes -->|"reads and writes"| node_users
node_post_routes -->|"reads"| node_users
node_post_routes -->|"reads and writes"| node_posts
node_profile_routes -->|"reads and writes"| node_users
node_profile_routes -->|"reads"| node_posts
node_review_routes -->|"reads and writes"| node_reviews
node_review_routes -->|"aggregates"| node_posts
node_review_routes -->|"reads"| node_users
node_admin_routes -->|"moderates"| node_posts
node_admin_routes -->|"queries"| node_users
node_admin_routes -->|"moderates"| node_reviews

click node_app "https://github.com/angkon-kar/campushub/blob/main/client/src/App.jsx"
click node_resource_hub "https://github.com/angkon-kar/campushub/blob/main/client/src/pages/ResourceHubPage.jsx"
click node_post_detail "https://github.com/angkon-kar/campushub/blob/main/client/src/pages/PostDetailPage.jsx"
click node_create_post "https://github.com/angkon-kar/campushub/blob/main/client/src/pages/CreatePostPage.jsx"
click node_public_profile "https://github.com/angkon-kar/campushub/blob/main/client/src/pages/PublicProfilePage.jsx"
click node_reviews_page "https://github.com/angkon-kar/campushub/blob/main/client/src/pages/ReviewsPage.jsx"
click node_review_form "https://github.com/angkon-kar/campushub/blob/main/client/src/components/reviews/ReviewForm.jsx"
click node_admin_page "https://github.com/angkon-kar/campushub/blob/main/client/src/pages/AdminDashboardPage.jsx"
click node_cv_guide "https://github.com/angkon-kar/campushub/blob/main/client/src/pages/CvGuidePage.jsx"
click node_resume_checker "https://github.com/angkon-kar/campushub/blob/main/client/src/pages/ResumeCheckerPage.jsx"
click node_cgpa "https://github.com/angkon-kar/campushub/blob/main/client/src/pages/CgpaPage.jsx"
click node_syllabus "https://github.com/angkon-kar/campushub/blob/main/client/src/pages/SyllabusPage.jsx"
click node_api_client "https://github.com/angkon-kar/campushub/blob/main/client/src/utils/apiClient.js"
click node_server "https://github.com/angkon-kar/campushub/blob/main/server/server.js"
click node_auth_routes "https://github.com/angkon-kar/campushub/blob/main/server/routes/authRoutes.js"
click node_post_routes "https://github.com/angkon-kar/campushub/blob/main/server/routes/postRoutes.js"
click node_profile_routes "https://github.com/angkon-kar/campushub/blob/main/server/routes/profileRoutes.js"
click node_review_routes "https://github.com/angkon-kar/campushub/blob/main/server/routes/reviewRoutes.js"
click node_admin_routes "https://github.com/angkon-kar/campushub/blob/main/server/routes/adminRoutes.js"
click node_auth_middleware "https://github.com/angkon-kar/campushub/blob/main/server/middlewares/authMiddleware.js"
click node_firebase_admin "https://github.com/angkon-kar/campushub/blob/main/server/config/firebaseAdmin.js"
click node_users "https://github.com/angkon-kar/campushub/blob/main/server/models/User.js"
click node_posts "https://github.com/angkon-kar/campushub/blob/main/server/models/Post.js"
click node_reviews "https://github.com/angkon-kar/campushub/blob/main/server/models/Review.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_app,node_api_client toneBlue
class node_cv_guide,node_resume_checker,node_cgpa,node_syllabus toneAmber
class node_resource_hub,node_post_detail,node_create_post,node_public_profile,node_reviews_page,node_review_form,node_admin_page toneMint
class node_server,node_auth_routes,node_post_routes,node_profile_routes,node_review_routes,node_admin_routes,node_auth_middleware,node_firebase_admin toneRose
class node_users,node_posts,node_reviews,node_student toneIndigo
```

## Components

### Student Web App

- [App Router](https://github.com/angkon-kar/campushub/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [API Client](https://github.com/angkon-kar/campushub/blob/main/client/src/utils/apiClient.js): `client/src/utils/apiClient.js`

### Academic Tools

- [CV Guide](https://github.com/angkon-kar/campushub/blob/main/client/src/pages/CvGuidePage.jsx): `client/src/pages/CvGuidePage.jsx`
- [Resume Checker](https://github.com/angkon-kar/campushub/blob/main/client/src/pages/ResumeCheckerPage.jsx): `client/src/pages/ResumeCheckerPage.jsx`
- [CGPA Tools](https://github.com/angkon-kar/campushub/blob/main/client/src/pages/CgpaPage.jsx): `client/src/pages/CgpaPage.jsx`
- [Syllabus](https://github.com/angkon-kar/campushub/blob/main/client/src/pages/SyllabusPage.jsx): `client/src/pages/SyllabusPage.jsx`

### Community Platform

- [Resource Hub](https://github.com/angkon-kar/campushub/blob/main/client/src/pages/ResourceHubPage.jsx): `client/src/pages/ResourceHubPage.jsx`
- [Post Detail](https://github.com/angkon-kar/campushub/blob/main/client/src/pages/PostDetailPage.jsx): `client/src/pages/PostDetailPage.jsx`
- [Create Post](https://github.com/angkon-kar/campushub/blob/main/client/src/pages/CreatePostPage.jsx): `client/src/pages/CreatePostPage.jsx`
- [Public Profile](https://github.com/angkon-kar/campushub/blob/main/client/src/pages/PublicProfilePage.jsx): `client/src/pages/PublicProfilePage.jsx`
- [Reviews](https://github.com/angkon-kar/campushub/blob/main/client/src/pages/ReviewsPage.jsx): `client/src/pages/ReviewsPage.jsx`
- [Review Form](https://github.com/angkon-kar/campushub/blob/main/client/src/components/reviews/ReviewForm.jsx): `client/src/components/reviews/ReviewForm.jsx`
- [Admin Dashboard](https://github.com/angkon-kar/campushub/blob/main/client/src/pages/AdminDashboardPage.jsx): `client/src/pages/AdminDashboardPage.jsx`

### API and Identity

- [API Server](https://github.com/angkon-kar/campushub/blob/main/server/server.js): `server/server.js`
- [Auth Routes](https://github.com/angkon-kar/campushub/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Post Routes](https://github.com/angkon-kar/campushub/blob/main/server/routes/postRoutes.js): `server/routes/postRoutes.js`
- [Profile Routes](https://github.com/angkon-kar/campushub/blob/main/server/routes/profileRoutes.js): `server/routes/profileRoutes.js`
- [Review Routes](https://github.com/angkon-kar/campushub/blob/main/server/routes/reviewRoutes.js): `server/routes/reviewRoutes.js`
- [Admin Routes](https://github.com/angkon-kar/campushub/blob/main/server/routes/adminRoutes.js): `server/routes/adminRoutes.js`
- [Token Verification](https://github.com/angkon-kar/campushub/blob/main/server/middlewares/authMiddleware.js): `server/middlewares/authMiddleware.js`
- [Firebase Admin](https://github.com/angkon-kar/campushub/blob/main/server/config/firebaseAdmin.js): `server/config/firebaseAdmin.js`

### Platform Data

- [User Records](https://github.com/angkon-kar/campushub/blob/main/server/models/User.js): `server/models/User.js`
- [Post Records](https://github.com/angkon-kar/campushub/blob/main/server/models/Post.js): `server/models/Post.js`
- [Review Records](https://github.com/angkon-kar/campushub/blob/main/server/models/Review.js): `server/models/Review.js`

### Other components

- **Student**

## Connections

- Student → App Router: uses
- App Router → Resource Hub: routes to (evidence: `client/src/App.jsx`)
- App Router → Post Detail: routes to (evidence: `client/src/App.jsx`)
- App Router → Create Post: routes to (evidence: `client/src/App.jsx`)
- App Router → CGPA Tools: routes to (evidence: `client/src/App.jsx`)
- App Router → Syllabus: routes to (evidence: `client/src/App.jsx`)
- App Router → Reviews: routes to (evidence: `client/src/App.jsx`)
- App Router → Admin Dashboard: routes to (evidence: `client/src/App.jsx`)
- App Router → CV Guide: routes to (evidence: `client/src/App.jsx`)
- App Router → Resume Checker: routes to (evidence: `client/src/App.jsx`)
- Reviews → API Client: requests data (evidence: `client/src/pages/ReviewsPage.jsx`)
- Review Form → API Client: submits review (evidence: `client/src/components/reviews/ReviewForm.jsx`)
- API Server → Auth Routes: mounts (evidence: `server/server.js`)
- API Server → Post Routes: mounts (evidence: `server/server.js`)
- API Server → Profile Routes: mounts (evidence: `server/server.js`)
- API Server → Review Routes: mounts (evidence: `server/server.js`)
- API Server → Admin Routes: mounts (evidence: `server/server.js`)
- Auth Routes → Token Verification: verifies tokens (evidence: `server/routes/authRoutes.js`)
- Post Routes → Token Verification: verifies tokens (evidence: `server/routes/postRoutes.js`)
- Review Routes → Token Verification: verifies tokens (evidence: `server/routes/reviewRoutes.js`)
- Admin Routes → Token Verification: verifies tokens (evidence: `server/routes/adminRoutes.js`)
- Token Verification → Firebase Admin: verifies identity (evidence: `server/middlewares/authMiddleware.js`)
- Auth Routes → User Records: reads and writes (evidence: `server/routes/authRoutes.js`)
- Post Routes → User Records: reads (evidence: `server/routes/postRoutes.js`)
- Post Routes → Post Records: reads and writes (evidence: `server/routes/postRoutes.js`)
- Profile Routes → User Records: reads and writes (evidence: `server/routes/profileRoutes.js`)
- Profile Routes → Post Records: reads (evidence: `server/routes/profileRoutes.js`)
- Review Routes → Review Records: reads and writes (evidence: `server/routes/reviewRoutes.js`)
- Review Routes → Post Records: aggregates (evidence: `server/routes/reviewRoutes.js`)
- Review Routes → User Records: reads (evidence: `server/routes/reviewRoutes.js`)
- Admin Routes → Post Records: moderates (evidence: `server/routes/adminRoutes.js`)
- Admin Routes → User Records: queries (evidence: `server/routes/adminRoutes.js`)
- Admin Routes → Review Records: moderates (evidence: `server/routes/adminRoutes.js`)
