# gautham2117/jnn-campus-connect architecture

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

- Interactive diagram: https://gitdiagram.com/gautham2117/jnn-campus-connect
- Repository: https://github.com/gautham2117/jnn-campus-connect

## Overview

CampusConnect is a college community portal delivered through web and Android clients, backed by an Express/MongoDB API. The main user journey is to sign in, discover campus information and people, then participate in clubs, events, discussions, and other campus services; staff administer and analyze activity. The README documents additional attendance, gate-pass, safety, study-assistant, and alumni capabilities. Some backend feature wiring is unsampled, so the graph retains documented subsystems while limiting implementation-level links to relationships supported by excerpts or the README.

Main entry points: [`client/src/App.jsx`](https://github.com/gautham2117/jnn-campus-connect/blob/main/client/src/App.jsx) (Web application), [`server/src/models`](https://github.com/gautham2117/jnn-campus-connect/tree/main/server/src/models) (MongoDB records), [`server/src/utils/notify.js`](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/utils/notify.js) (Notifications), [`server/src/controllers/chatController.js`](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/chatController.js) (Chat)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_web_app["Web application<br/>[App.jsx]"]
  node_mobile_app["Android application"]
  node_web_api["Web API client<br/>[api.js]"]
  node_mobile_api["Mobile API client<br/>[api.js]"]
end

subgraph group_community["Campus community"]
  node_profiles["Profiles and directory<br/>[userController.js]"]
  node_announcements["Announcements"]
  node_clubs["Clubs<br/>[clubController.js]"]
  node_events["Events<br/>[eventController.js]"]
  node_discussions["Discussions"]
  node_search["Global search"]
  node_alumni["Alumni and mentorship"]
end

subgraph group_services["Campus services"]
  node_chat["Chat<br/>[chatController.js]"]
  node_attendance["Attendance"]
  node_gatepass["Gate passes"]
  node_complaints["Complaints and grievances"]
  node_safety["SOS alerts<br/>[sosController.js]"]
  node_study["Study assistant"]
  node_materials["Study materials"]
end

subgraph group_operations["Administration"]
  node_analytics["Analytics and activity"]
  node_admin["Administration and moderation<br/>[adminController.js]"]
end

subgraph group_backend["API and data"]
  node_auth["Authentication<br/>[authController.js]"]
  node_notifications["Notifications<br/>[notify.js]"]
  node_realtime["Realtime transport<br/>[socket.js]"]
  node_uploads["File uploads<br/>[storage.js]"]
  node_api["Express API<br/>[app.js]"]
  node_database[("MongoDB records")]
end

node_campus_user(("Campus users"))

node_campus_user -->|"uses"| node_web_app
node_campus_user -->|"uses"| node_mobile_app
node_web_app -->|"requests data"| node_web_api
node_web_app -->|"signs in"| node_auth
node_web_app -->|"browses"| node_announcements
node_web_app -->|"joins"| node_clubs
node_web_app -->|"discovers"| node_events
node_web_app -->|"participates"| node_discussions
node_web_app -->|"views"| node_profiles
node_web_app -->|"searches"| node_search
node_web_app -->|"chats"| node_chat
node_web_app -->|"records attendance"| node_attendance
node_web_app -->|"requests passes"| node_gatepass
node_web_app -->|"submits complaints"| node_complaints
node_web_app -->|"raises alerts"| node_safety
node_web_app -->|"gets study help"| node_study
node_web_app -->|"accesses materials"| node_materials
node_web_app -->|"connects alumni"| node_alumni
node_web_app -->|"views analytics"| node_analytics
node_web_app -->|"manages portal"| node_admin
node_mobile_app -.->|"requests data"| node_mobile_api
node_api -->|"serves API data"| node_database
node_api -->|"serves uploads"| node_uploads
node_chat -->|"emits events"| node_realtime
node_realtime -->|"reads records"| node_database
node_chat -->|"notifies users"| node_notifications
node_complaints -->|"notifies users"| node_notifications
node_gatepass -->|"notifies users"| node_notifications
node_notifications -->|"emits updates"| node_realtime
node_study -->|"stores conversations"| node_database
node_study -->|"retrieves sources"| node_materials
node_attendance -->|"reads and writes"| node_database
node_gatepass -->|"reads and writes"| node_database
node_admin -->|"reviews activity"| node_analytics

click node_web_app "https://github.com/gautham2117/jnn-campus-connect/blob/main/client/src/App.jsx"
click node_mobile_app "https://github.com/gautham2117/jnn-campus-connect/tree/main/mobile/src/app"
click node_web_api "https://github.com/gautham2117/jnn-campus-connect/blob/main/client/src/services/api.js"
click node_mobile_api "https://github.com/gautham2117/jnn-campus-connect/blob/main/mobile/src/services/api.js"
click node_auth "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/authController.js"
click node_profiles "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/userController.js"
click node_announcements "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/announcementController.js"
click node_clubs "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/clubController.js"
click node_events "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/eventController.js"
click node_discussions "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/discussionController.js"
click node_search "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/searchController.js"
click node_chat "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/chatController.js"
click node_attendance "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/attendanceController.js"
click node_gatepass "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/gatePassController.js"
click node_complaints "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/complaintController.js"
click node_safety "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/sosController.js"
click node_study "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/services/ai/studyAssistantService.js"
click node_materials "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/studyMaterialController.js"
click node_alumni "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/alumniController.js"
click node_analytics "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/analyticsController.js"
click node_admin "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/adminController.js"
click node_notifications "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/utils/notify.js"
click node_realtime "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/config/socket.js"
click node_uploads "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/utils/storage.js"
click node_api "https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/app.js"
click node_database "https://github.com/gautham2117/jnn-campus-connect/tree/main/server/src/models"

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_web_app,node_mobile_app,node_web_api,node_mobile_api,node_campus_user toneBlue
class node_profiles,node_announcements,node_clubs,node_events,node_discussions,node_search,node_alumni toneAmber
class node_chat,node_attendance,node_gatepass,node_complaints,node_safety,node_study,node_materials toneMint
class node_analytics,node_admin toneRose
class node_auth,node_notifications,node_realtime,node_uploads,node_api,node_database toneIndigo
```

## Components

### User clients

- [Web application](https://github.com/gautham2117/jnn-campus-connect/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Android application](https://github.com/gautham2117/jnn-campus-connect/tree/main/mobile/src/app): `mobile/src/app`
- [Web API client](https://github.com/gautham2117/jnn-campus-connect/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [Mobile API client](https://github.com/gautham2117/jnn-campus-connect/blob/main/mobile/src/services/api.js): `mobile/src/services/api.js`

### Campus community

- [Profiles and directory](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/userController.js): `server/src/controllers/userController.js`
- [Announcements](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/announcementController.js): `server/src/controllers/announcementController.js`
- [Clubs](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/clubController.js): `server/src/controllers/clubController.js`
- [Events](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/eventController.js): `server/src/controllers/eventController.js`
- [Discussions](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/discussionController.js): `server/src/controllers/discussionController.js`
- [Global search](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/searchController.js): `server/src/controllers/searchController.js`
- [Alumni and mentorship](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/alumniController.js): `server/src/controllers/alumniController.js`

### Campus services

- [Chat](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/chatController.js): `server/src/controllers/chatController.js`
- [Attendance](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/attendanceController.js): `server/src/controllers/attendanceController.js`
- [Gate passes](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/gatePassController.js): `server/src/controllers/gatePassController.js`
- [Complaints and grievances](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/complaintController.js): `server/src/controllers/complaintController.js`
- [SOS alerts](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/sosController.js): `server/src/controllers/sosController.js`
- [Study assistant](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/services/ai/studyAssistantService.js): `server/src/services/ai/studyAssistantService.js`
- [Study materials](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/studyMaterialController.js): `server/src/controllers/studyMaterialController.js`

### Administration

- [Analytics and activity](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/analyticsController.js): `server/src/controllers/analyticsController.js`
- [Administration and moderation](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/adminController.js): `server/src/controllers/adminController.js`

### API and data

- [Authentication](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/controllers/authController.js): `server/src/controllers/authController.js`
- [Notifications](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/utils/notify.js): `server/src/utils/notify.js`
- [Realtime transport](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/config/socket.js): `server/src/config/socket.js`
- [File uploads](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/utils/storage.js): `server/src/utils/storage.js`
- [Express API](https://github.com/gautham2117/jnn-campus-connect/blob/main/server/src/app.js): `server/src/app.js`
- [MongoDB records](https://github.com/gautham2117/jnn-campus-connect/tree/main/server/src/models): `server/src/models`

### Other components

- **Campus users**

## Connections

- Campus users → Web application: uses (evidence: `README.md`)
- Campus users → Android application: uses (evidence: `README.md`)
- Web application → Web API client: requests data (evidence: `client/src/App.jsx`)
- Web application → Authentication: signs in (evidence: `README.md`)
- Web application → Announcements: browses (evidence: `README.md`)
- Web application → Clubs: joins (evidence: `README.md`)
- Web application → Events: discovers (evidence: `README.md`)
- Web application → Discussions: participates (evidence: `README.md`)
- Web application → Profiles and directory: views (evidence: `README.md`)
- Web application → Global search: searches (evidence: `README.md`)
- Web application → Chat: chats (evidence: `README.md`)
- Web application → Attendance: records attendance (evidence: `README.md`)
- Web application → Gate passes: requests passes (evidence: `README.md`)
- Web application → Complaints and grievances: submits complaints (evidence: `README.md`)
- Web application → SOS alerts: raises alerts (evidence: `README.md`)
- Web application → Study assistant: gets study help (evidence: `README.md`)
- Web application → Study materials: accesses materials (evidence: `README.md`)
- Web application → Alumni and mentorship: connects alumni (evidence: `README.md`)
- Web application → Analytics and activity: views analytics (evidence: `README.md`)
- Web application → Administration and moderation: manages portal (evidence: `README.md`)
- Android application → Mobile API client: requests data (evidence: `mobile/src/app/(app)/search.js`)
- Express API → MongoDB records: serves API data (evidence: `README.md`)
- Express API → File uploads: serves uploads (evidence: `server/src/app.js`)
- Chat → Realtime transport: emits events (evidence: `server/src/controllers/chatController.js`)
- Realtime transport → MongoDB records: reads records (evidence: `server/src/config/socket.js`)
- Chat → Notifications: notifies users (evidence: `server/src/controllers/chatController.js`)
- Complaints and grievances → Notifications: notifies users (evidence: `server/src/controllers/complaintController.js`)
- Gate passes → Notifications: notifies users (evidence: `server/src/controllers/gatePassController.js`)
- Notifications → Realtime transport: emits updates (evidence: `server/src/utils/notify.js`)
- Study assistant → MongoDB records: stores conversations (evidence: `server/src/services/ai/studyAssistantService.js`)
- Study assistant → Study materials: retrieves sources (evidence: `server/src/services/ai/studyAssistantService.js`)
- Attendance → MongoDB records: reads and writes (evidence: `server/src/controllers/attendanceController.js`)
- Gate passes → MongoDB records: reads and writes (evidence: `server/src/controllers/gatePassController.js`)
- Administration and moderation → Analytics and activity: reviews activity (evidence: `README.md`)
