# benny45123/campusconnect architecture

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

## Overview

CampusConnect is a campus article-sharing hub. Students register or sign in, browse/search articles, open a story, and use the writing interface to submit articles and images. The sampled code shows authentication, article search and publishing, and MongoDB models; the README also describes Cloudinary image hosting and academic-resource sharing. Some frontend pages and image-upload details were not sampled, and the article router is not visibly mounted in the sampled app entry point, so those connections are omitted or marked unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/benny45123/campusconnect/blob/main/frontend/src/App.jsx) (App routes), [`backend/routes/articleRoutes.js`](https://github.com/benny45123/campusconnect/blob/main/backend/routes/articleRoutes.js) (Article routes), [`frontend/src/services/BackendHandler.js`](https://github.com/benny45123/campusconnect/blob/main/frontend/src/services/BackendHandler.js) (Backend client), [`backend/controllers/findArticle.js`](https://github.com/benny45123/campusconnect/blob/main/backend/controllers/findArticle.js) (Article search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Student experience"]
  node_router_ui["App routes<br/>[App.jsx]"]
  node_auth_page["Sign-in page<br/>[Auth.jsx]"]
  node_dashboard["Campus dashboard<br/>[DashBoard.jsx]"]
  node_feed["Article feed<br/>[ArticleFeed.jsx]"]
  node_story["Story reader"]
  node_writer["Story editor<br/>[Write.jsx]"]
  node_resource_pages["Resource pages<br/>[LibraryPage.jsx]"]
  node_app_state["App context<br/>[AppContext.jsx]"]
  node_api_client["Backend client<br/>[BackendHandler.js]"]
end

subgraph group_identity["Accounts"]
  node_auth_forms["Auth forms<br/>[SignInComp.jsx]"]
  node_auth_service["Authentication<br/>[Authentication.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_api_app["Express app<br/>[app.js]"]
end

subgraph group_content["Article content"]
  node_article_routes["Article routes<br/>[articleRoutes.js]"]
  node_search["Article search<br/>[findArticle.js]"]
  node_single_article["Single article"]
  node_publish["Publish article<br/>[postArticle.js]"]
  node_tags["Auto-tagging<br/>[generateTags.js]"]
  node_image_upload["Image upload<br/>[uploadImage.js]"]
  node_resources["Academic resources<br/>[LibraryPage.jsx]"]
end

subgraph group_persistence["Persistence and media"]
  node_article_model[("Article records<br/>[articleSchema.js]")]
  node_user_model[("User records<br/>[userSchema.js]")]
  node_mongodb[("MongoDB")]
  node_cloudinary[("Cloudinary")]
end

node_student(("Student"))

node_student -->|"visits"| node_router_ui
node_router_ui -->|"routes to"| node_auth_page
node_router_ui -->|"routes to"| node_dashboard
node_router_ui -->|"routes to"| node_writer
node_router_ui -->|"routes to"| node_story
node_router_ui -->|"routes to"| node_resource_pages
node_auth_page -->|"renders"| node_auth_forms
node_auth_forms -->|"calls"| node_api_client
node_app_state -->|"checks login"| node_api_client
node_app_state -.->|"requests results"| node_search
node_writer -->|"submits content"| node_api_client
node_api_client -->|"calls auth API"| node_auth_routes
node_api_client -.->|"calls article API"| node_article_routes
node_api_app -->|"mounts"| node_auth_routes
node_auth_routes -->|"dispatches"| node_auth_service
node_article_routes -->|"dispatches"| node_publish
node_article_routes -->|"dispatches"| node_search
node_article_routes -->|"dispatches"| node_single_article
node_article_routes -->|"dispatches"| node_image_upload
node_article_routes -->|"guards publishing"| node_auth_service
node_search -->|"queries"| node_article_model
node_search -->|"populates authors"| node_user_model
node_publish -->|"creates records"| node_article_model
node_publish -->|"generates tags"| node_tags
node_single_article -->|"loads story"| node_article_model
node_auth_service -->|"reads and writes"| node_user_model
node_api_app -->|"connects"| node_mongodb
node_image_upload -.->|"uploads media"| node_cloudinary
node_student -.->|"shares resources"| node_resources

click node_router_ui "https://github.com/benny45123/campusconnect/blob/main/frontend/src/App.jsx"
click node_auth_page "https://github.com/benny45123/campusconnect/blob/main/frontend/src/pages/Auth.jsx"
click node_dashboard "https://github.com/benny45123/campusconnect/blob/main/frontend/src/components/DashBoard.jsx"
click node_feed "https://github.com/benny45123/campusconnect/blob/main/frontend/src/components/ArticleFeed.jsx"
click node_story "https://github.com/benny45123/campusconnect/blob/main/frontend/src/components/selectedArticlePage.jsx"
click node_writer "https://github.com/benny45123/campusconnect/blob/main/frontend/src/pages/Write.jsx"
click node_resource_pages "https://github.com/benny45123/campusconnect/blob/main/frontend/src/pages/LibraryPage.jsx"
click node_app_state "https://github.com/benny45123/campusconnect/blob/main/frontend/src/context/AppContext.jsx"
click node_api_client "https://github.com/benny45123/campusconnect/blob/main/frontend/src/services/BackendHandler.js"
click node_auth_forms "https://github.com/benny45123/campusconnect/blob/main/frontend/src/components/SignInComp.jsx"
click node_auth_service "https://github.com/benny45123/campusconnect/blob/main/backend/services/Authentication.js"
click node_auth_routes "https://github.com/benny45123/campusconnect/blob/main/backend/routes/authRoutes.js"
click node_api_app "https://github.com/benny45123/campusconnect/blob/main/backend/app.js"
click node_article_routes "https://github.com/benny45123/campusconnect/blob/main/backend/routes/articleRoutes.js"
click node_search "https://github.com/benny45123/campusconnect/blob/main/backend/controllers/findArticle.js"
click node_single_article "https://github.com/benny45123/campusconnect/blob/main/backend/controllers/findSingleArticle.js"
click node_publish "https://github.com/benny45123/campusconnect/blob/main/backend/controllers/postArticle.js"
click node_tags "https://github.com/benny45123/campusconnect/blob/main/backend/utils/generateTags.js"
click node_image_upload "https://github.com/benny45123/campusconnect/blob/main/backend/controllers/uploadImage.js"
click node_article_model "https://github.com/benny45123/campusconnect/blob/main/backend/models/articleSchema.js"
click node_user_model "https://github.com/benny45123/campusconnect/blob/main/backend/models/userSchema.js"
click node_resources "https://github.com/benny45123/campusconnect/blob/main/frontend/src/pages/LibraryPage.jsx"

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_router_ui,node_auth_page,node_dashboard,node_feed,node_story,node_writer,node_resource_pages,node_app_state,node_api_client toneBlue
class node_auth_forms,node_auth_service,node_auth_routes,node_api_app toneAmber
class node_article_routes,node_search,node_single_article,node_publish,node_tags,node_image_upload,node_resources toneMint
class node_article_model,node_user_model,node_mongodb,node_cloudinary toneRose
class node_student toneIndigo
```

## Components

### Student experience

- [App routes](https://github.com/benny45123/campusconnect/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign-in page](https://github.com/benny45123/campusconnect/blob/main/frontend/src/pages/Auth.jsx): `frontend/src/pages/Auth.jsx`
- [Campus dashboard](https://github.com/benny45123/campusconnect/blob/main/frontend/src/components/DashBoard.jsx): `frontend/src/components/DashBoard.jsx`
- [Article feed](https://github.com/benny45123/campusconnect/blob/main/frontend/src/components/ArticleFeed.jsx): `frontend/src/components/ArticleFeed.jsx`
- [Story reader](https://github.com/benny45123/campusconnect/blob/main/frontend/src/components/selectedArticlePage.jsx): `frontend/src/components/selectedArticlePage.jsx`
- [Story editor](https://github.com/benny45123/campusconnect/blob/main/frontend/src/pages/Write.jsx): `frontend/src/pages/Write.jsx`
- [Resource pages](https://github.com/benny45123/campusconnect/blob/main/frontend/src/pages/LibraryPage.jsx): `frontend/src/pages/LibraryPage.jsx`
- [App context](https://github.com/benny45123/campusconnect/blob/main/frontend/src/context/AppContext.jsx): `frontend/src/context/AppContext.jsx`
- [Backend client](https://github.com/benny45123/campusconnect/blob/main/frontend/src/services/BackendHandler.js): `frontend/src/services/BackendHandler.js`

### Accounts

- [Auth forms](https://github.com/benny45123/campusconnect/blob/main/frontend/src/components/SignInComp.jsx): `frontend/src/components/SignInComp.jsx`
- [Authentication](https://github.com/benny45123/campusconnect/blob/main/backend/services/Authentication.js): `backend/services/Authentication.js`
- [Auth routes](https://github.com/benny45123/campusconnect/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Express app](https://github.com/benny45123/campusconnect/blob/main/backend/app.js): `backend/app.js`

### Article content

- [Article routes](https://github.com/benny45123/campusconnect/blob/main/backend/routes/articleRoutes.js): `backend/routes/articleRoutes.js`
- [Article search](https://github.com/benny45123/campusconnect/blob/main/backend/controllers/findArticle.js): `backend/controllers/findArticle.js`
- [Single article](https://github.com/benny45123/campusconnect/blob/main/backend/controllers/findSingleArticle.js): `backend/controllers/findSingleArticle.js`
- [Publish article](https://github.com/benny45123/campusconnect/blob/main/backend/controllers/postArticle.js): `backend/controllers/postArticle.js`
- [Auto-tagging](https://github.com/benny45123/campusconnect/blob/main/backend/utils/generateTags.js): `backend/utils/generateTags.js`
- [Image upload](https://github.com/benny45123/campusconnect/blob/main/backend/controllers/uploadImage.js): `backend/controllers/uploadImage.js`
- [Academic resources](https://github.com/benny45123/campusconnect/blob/main/frontend/src/pages/LibraryPage.jsx): `frontend/src/pages/LibraryPage.jsx`

### Persistence and media

- [Article records](https://github.com/benny45123/campusconnect/blob/main/backend/models/articleSchema.js): `backend/models/articleSchema.js`
- [User records](https://github.com/benny45123/campusconnect/blob/main/backend/models/userSchema.js): `backend/models/userSchema.js`
- **MongoDB**
- **Cloudinary**

### Other components

- **Student**

## Connections

- Student → App routes: visits (evidence: `frontend/src/App.jsx`)
- App routes → Sign-in page: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Campus dashboard: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Story editor: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Story reader: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Resource pages: routes to (evidence: `frontend/src/App.jsx`)
- Sign-in page → Auth forms: renders (evidence: `frontend/src/pages/Auth.jsx`)
- Auth forms → Backend client: calls (evidence: `frontend/src/components/SignInComp.jsx`)
- App context → Backend client: checks login (evidence: `frontend/src/context/AppContext.jsx`)
- App context → Article search: requests results
- Story editor → Backend client: submits content (evidence: `frontend/src/pages/Write.jsx`)
- Backend client → Auth routes: calls auth API (evidence: `frontend/src/services/BackendHandler.js`)
- Backend client → Article routes: calls article API
- Express app → Auth routes: mounts (evidence: `backend/app.js`)
- Auth routes → Authentication: dispatches (evidence: `backend/routes/authRoutes.js`)
- Article routes → Publish article: dispatches (evidence: `backend/routes/articleRoutes.js`)
- Article routes → Article search: dispatches (evidence: `backend/routes/articleRoutes.js`)
- Article routes → Single article: dispatches (evidence: `backend/routes/articleRoutes.js`)
- Article routes → Image upload: dispatches (evidence: `backend/routes/articleRoutes.js`)
- Article routes → Authentication: guards publishing (evidence: `backend/routes/articleRoutes.js`)
- Article search → Article records: queries (evidence: `backend/controllers/findArticle.js`)
- Article search → User records: populates authors (evidence: `backend/controllers/findArticle.js`)
- Publish article → Article records: creates records (evidence: `backend/controllers/postArticle.js`)
- Publish article → Auto-tagging: generates tags (evidence: `backend/controllers/postArticle.js`)
- Single article → Article records: loads story (evidence: `backend/controllers/findSingleArticle.js`)
- Authentication → User records: reads and writes (evidence: `backend/services/Authentication.js`)
- Express app → MongoDB: connects (evidence: `backend/app.js`)
- Image upload → Cloudinary: uploads media (evidence: `README.md`)
- Student → Academic resources: shares resources (evidence: `README.md`)
