# rumanuddin-syed/classconnect architecture

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

- Interactive diagram: https://gitdiagram.com/rumanuddin-syed/classconnect
- Repository: https://github.com/rumanuddin-syed/classconnect

## Overview

Class Connect is a classroom-management and collaboration platform: users authenticate, create or join classrooms, and use classroom features such as attendance, events, announcements, chat, and shared memories. The graph follows the documented React/Redux client and Express API into feature controllers and MongoDB-backed models. Sampled evidence supports the app routing, server route mounting, authentication, and several controller-to-model relationships; other feature branches are included from documented capabilities, with unsampled internal wiring left out where it could not be verified.

Main entry points: [`server/server.js`](https://github.com/rumanuddin-syed/classconnect/blob/main/server/server.js) (Express server), [`server/models`](https://github.com/rumanuddin-syed/classconnect/tree/main/server/models) (MongoDB models), [`client/ClassConnect/src/App.jsx`](https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/App.jsx) (App routing), [`server/controllers/attendanceController.js`](https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/attendanceController.js) (Attendance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Sign-in and signup<br/>[SignupPage.jsx]"]
  node_dashboard["Class dashboard<br/>[ClassDashboard.jsx]"]
  node_state["Redux state<br/>[store.js]"]
  node_http["HTTP client<br/>[axiosInstance.js]"]
  node_socket["Live socket client<br/>[socket.js]"]
end

subgraph group_api["API and access"]
  node_server["Express server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_auth["Authentication<br/>[authController.js]"]
  node_session["Session verification<br/>[isLoggedIn.js]"]
  node_rbac["Class permissions<br/>[rbac.js]"]
end

subgraph group_classroom["Classroom features"]
  node_classrooms["Class and membership"]
  node_attendance["Attendance"]
  node_subjects["Subjects"]
  node_chat["Class chat<br/>[chatController.js]"]
  node_announcements["Announcements"]
  node_memories["Shared memories"]
  node_events["Calendar events<br/>[eventController.js]"]
end

subgraph group_data["Persistence and services"]
  node_models[("MongoDB models")]
  node_mailer["Email delivery<br/>[nodemailer.js]"]
  node_cloudinary["Image storage"]
end

node_user(("Educators and students"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_dashboard
node_app -->|"dispatches auth check"| node_state
node_authui -.->|"updates session"| node_state
node_dashboard -->|"uses classroom state"| node_state
node_state -->|"makes requests"| node_http
node_dashboard -.->|"connects live"| node_socket
node_http -->|"sends API requests"| node_server
node_server -->|"mounts routes"| node_authroutes
node_authroutes -->|"dispatches auth"| node_auth
node_authroutes -->|"guards sessions"| node_session
node_session -->|"checks user version"| node_models
node_auth -->|"reads and writes users"| node_models
node_auth -->|"sends verification mail"| node_mailer
node_server -->|"mounts class API"| node_classrooms
node_classrooms -->|"reads and writes class data"| node_models
node_server -->|"mounts attendance API"| node_attendance
node_attendance -->|"reads and writes attendance"| node_models
node_attendance -.->|"requires class permissions"| node_rbac
node_server -->|"mounts subject API"| node_subjects
node_subjects -->|"reads and writes subjects"| node_models
node_server -->|"mounts chat API"| node_chat
node_chat -->|"reads and writes chat"| node_models
node_server -->|"mounts announcement API"| node_announcements
node_announcements -->|"reads and writes announcements"| node_models
node_server -->|"mounts memory API"| node_memories
node_memories -->|"reads and writes memories"| node_models
node_memories -->|"stores images"| node_cloudinary
node_server -->|"mounts event API"| node_events
node_events -.->|"reads and writes events"| node_models
node_user -->|"creates or joins"| node_classrooms
node_user -->|"records attendance"| node_attendance
node_user -->|"discusses in class"| node_chat
node_user -->|"publishes updates"| node_announcements
node_user -->|"manages calendar"| node_events

click node_app "https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/App.jsx"
click node_authui "https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/pages/SignupPage.jsx"
click node_dashboard "https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/pages/ClassDashboard.jsx"
click node_state "https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/redux/store.js"
click node_http "https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/utils/axiosInstance.js"
click node_socket "https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/utils/socket.js"
click node_server "https://github.com/rumanuddin-syed/classconnect/blob/main/server/server.js"
click node_authroutes "https://github.com/rumanuddin-syed/classconnect/blob/main/server/routes/authRoutes.js"
click node_auth "https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/authController.js"
click node_session "https://github.com/rumanuddin-syed/classconnect/blob/main/server/middleware/isLoggedIn.js"
click node_rbac "https://github.com/rumanuddin-syed/classconnect/blob/main/server/middleware/rbac.js"
click node_classrooms "https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/userClassController.js"
click node_attendance "https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/attendanceController.js"
click node_subjects "https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/subjectsController.js"
click node_chat "https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/chatController.js"
click node_announcements "https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/announcementController.js"
click node_memories "https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/memoryController.js"
click node_events "https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/eventController.js"
click node_models "https://github.com/rumanuddin-syed/classconnect/tree/main/server/models"
click node_mailer "https://github.com/rumanuddin-syed/classconnect/blob/main/server/config/nodemailer.js"
click node_cloudinary "https://github.com/rumanuddin-syed/classconnect/blob/main/server/config/cloudinaryConfig.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_authui,node_dashboard,node_state,node_http,node_socket toneBlue
class node_server,node_authroutes,node_auth,node_session,node_rbac toneAmber
class node_classrooms,node_attendance,node_subjects,node_chat,node_announcements,node_memories,node_events toneMint
class node_models,node_mailer,node_cloudinary toneRose
class node_user toneIndigo
```

## Components

### Web client

- [App routing](https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/App.jsx): `client/ClassConnect/src/App.jsx`
- [Sign-in and signup](https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/pages/SignupPage.jsx): `client/ClassConnect/src/pages/SignupPage.jsx`
- [Class dashboard](https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/pages/ClassDashboard.jsx): `client/ClassConnect/src/pages/ClassDashboard.jsx`
- [Redux state](https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/redux/store.js): `client/ClassConnect/src/redux/store.js`
- [HTTP client](https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/utils/axiosInstance.js): `client/ClassConnect/src/utils/axiosInstance.js`
- [Live socket client](https://github.com/rumanuddin-syed/classconnect/blob/main/client/ClassConnect/src/utils/socket.js): `client/ClassConnect/src/utils/socket.js`

### API and access

- [Express server](https://github.com/rumanuddin-syed/classconnect/blob/main/server/server.js): `server/server.js`
- [Auth routes](https://github.com/rumanuddin-syed/classconnect/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Authentication](https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Session verification](https://github.com/rumanuddin-syed/classconnect/blob/main/server/middleware/isLoggedIn.js): `server/middleware/isLoggedIn.js`
- [Class permissions](https://github.com/rumanuddin-syed/classconnect/blob/main/server/middleware/rbac.js): `server/middleware/rbac.js`

### Classroom features

- [Class and membership](https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/userClassController.js): `server/controllers/userClassController.js`
- [Attendance](https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/attendanceController.js): `server/controllers/attendanceController.js`
- [Subjects](https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/subjectsController.js): `server/controllers/subjectsController.js`
- [Class chat](https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/chatController.js): `server/controllers/chatController.js`
- [Announcements](https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/announcementController.js): `server/controllers/announcementController.js`
- [Shared memories](https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/memoryController.js): `server/controllers/memoryController.js`
- [Calendar events](https://github.com/rumanuddin-syed/classconnect/blob/main/server/controllers/eventController.js): `server/controllers/eventController.js`

### Persistence and services

- [MongoDB models](https://github.com/rumanuddin-syed/classconnect/tree/main/server/models): `server/models`
- [Email delivery](https://github.com/rumanuddin-syed/classconnect/blob/main/server/config/nodemailer.js): `server/config/nodemailer.js`
- [Image storage](https://github.com/rumanuddin-syed/classconnect/blob/main/server/config/cloudinaryConfig.js): `server/config/cloudinaryConfig.js`

### Other components

- **Educators and students**

## Connections

- Educators and students → App routing: uses
- App routing → Sign-in and signup: routes to (evidence: `client/ClassConnect/src/App.jsx`)
- App routing → Class dashboard: routes to (evidence: `client/ClassConnect/src/App.jsx`)
- App routing → Redux state: dispatches auth check (evidence: `client/ClassConnect/src/App.jsx`)
- Sign-in and signup → Redux state: updates session
- Class dashboard → Redux state: uses classroom state (evidence: `client/ClassConnect/src/pages/ClassDashboard.jsx`)
- Redux state → HTTP client: makes requests
- Class dashboard → Live socket client: connects live
- HTTP client → Express server: sends API requests
- Express server → Auth routes: mounts routes (evidence: `server/server.js`)
- Auth routes → Authentication: dispatches auth (evidence: `server/routes/authRoutes.js`)
- Auth routes → Session verification: guards sessions (evidence: `server/routes/authRoutes.js`)
- Session verification → MongoDB models: checks user version (evidence: `server/middleware/isLoggedIn.js`)
- Authentication → MongoDB models: reads and writes users (evidence: `server/controllers/authController.js`)
- Authentication → Email delivery: sends verification mail (evidence: `server/controllers/authController.js`)
- Express server → Class and membership: mounts class API (evidence: `server/server.js`)
- Class and membership → MongoDB models: reads and writes class data (evidence: `server/controllers/userClassController.js`)
- Express server → Attendance: mounts attendance API (evidence: `server/server.js`)
- Attendance → MongoDB models: reads and writes attendance (evidence: `server/controllers/attendanceController.js`)
- Attendance → Class permissions: requires class permissions
- Express server → Subjects: mounts subject API (evidence: `server/server.js`)
- Subjects → MongoDB models: reads and writes subjects (evidence: `server/controllers/subjectsController.js`)
- Express server → Class chat: mounts chat API (evidence: `server/server.js`)
- Class chat → MongoDB models: reads and writes chat (evidence: `server/controllers/chatController.js`)
- Express server → Announcements: mounts announcement API (evidence: `server/server.js`)
- Announcements → MongoDB models: reads and writes announcements (evidence: `server/controllers/announcementController.js`)
- Express server → Shared memories: mounts memory API (evidence: `server/server.js`)
- Shared memories → MongoDB models: reads and writes memories (evidence: `server/controllers/memoryController.js`)
- Shared memories → Image storage: stores images (evidence: `server/controllers/memoryController.js`)
- Express server → Calendar events: mounts event API (evidence: `server/server.js`)
- Calendar events → MongoDB models: reads and writes events
- Educators and students → Class and membership: creates or joins
- Educators and students → Attendance: records attendance
- Educators and students → Class chat: discusses in class
- Educators and students → Announcements: publishes updates
- Educators and students → Calendar events: manages calendar
