# sanjairajeshkumar/smart-school-connect-ai architecture

> Architecture diagram of the GitHub repository sanjairajeshkumar/smart-school-connect-ai, 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/sanjairajeshkumar/smart-school-connect-ai
- Repository: https://github.com/sanjairajeshkumar/smart-school-connect-ai

## Overview

Smart School Connect is a multi-tenant school platform for role-based school administration, homework, family communication, attendance, fees, and AI assistance. The main workflow is that teachers create assignments, students submit and track work, parents sequence tasks into batches, and educators review progress and communicate with families. The frontend routes users by role; backend API routes apply authentication and tenant controls before domain handlers operate. README descriptions support several unsampled capabilities, but their internal call paths are not established by the excerpts, so those links are documented at the API boundary rather than inferred between services.

Main entry points: [`backend/src/app.js`](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/app.js) (Express API), [`frontend/src/App.jsx`](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/App.jsx) (Role router), [`frontend/src/services/api.js`](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/services/api.js) (HTTP client), [`backend/src/config/db.js`](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/config/db.js) (MongoDB)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Role Workspaces"]
  node_app["Role router<br/>[App.jsx]"]
  node_login["Login and onboarding<br/>[LoginPage.jsx]"]
  node_dashboards["Role dashboards"]
end

subgraph group_identity["Identity and Tenancy"]
  node_authstate["Session state<br/>[AuthContext.jsx]"]
  node_authclient["Auth API client<br/>[authService.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Auth handler<br/>[authController.js]"]
  node_authservice["Authentication<br/>[authService.js]"]
  node_authguard["Session and role guards<br/>[authMiddleware.js]"]
end

subgraph group_learning["Academic Workflows"]
  node_homeworkui["Homework workspace"]
  node_batchui["Parent batching"]
  node_messagesui["Family messaging<br/>[MessagesPage.jsx]"]
  node_aiui["School AI"]
  node_taskclient["Task API client<br/>[taskService.js]"]
  node_taskroutes["Task routes<br/>[taskRoutes.js]"]
  node_taskcontroller["Task handler<br/>[taskController.js]"]
  node_taskservice["Task and batch logic<br/>[taskService.js]"]
  node_taskstore[("Task records<br/>[Task.js]")]
  node_messageroutes["Message routes<br/>[messageRoutes.js]"]
  node_ai["AI assistant and digest<br/>[aiOrchestrator.js]"]
end

subgraph group_operations["School Operations"]
  node_schoolui["School administration"]
  node_schoolclient["School API client<br/>[schoolService.js]"]
  node_feeroutes["Fee routes<br/>[feeRoutes.js]"]
  node_attendanceroutes["Attendance routes"]
  node_schoolroutes["School routes<br/>[schoolRoutes.js]"]
  node_schoolcontroller["School handler"]
end

subgraph group_platform["Backend Platform"]
  node_frontendapi["HTTP client<br/>[api.js]"]
  node_api["Express API<br/>[app.js]"]
  node_server["Runtime startup<br/>[server.js]"]
  node_database[("MongoDB<br/>[db.js]")]
  node_socket["Live notifications<br/>[socketService.js]"]
end

node_users(("School users"))

node_users -->|"use workspaces"| node_app
node_app -->|"reads session"| node_authstate
node_app -->|"shows login"| node_login
node_app -->|"routes roles"| node_dashboards
node_app -->|"routes homework"| node_homeworkui
node_app -->|"routes messages"| node_messagesui
node_app -->|"routes assistant"| node_aiui
node_authstate -->|"calls"| node_authclient
node_authstate -->|"starts session socket"| node_socket
node_homeworkui -->|"loads and updates"| node_taskclient
node_batchui -->|"manages batches"| node_taskclient
node_schoolui -->|"loads school data"| node_schoolclient
node_frontendapi -->|"sends API requests"| node_api
node_authclient -->|"uses"| node_frontendapi
node_taskclient -->|"uses"| node_frontendapi
node_schoolclient -->|"uses"| node_frontendapi
node_api -->|"mounts"| node_authroutes
node_api -->|"mounts"| node_taskroutes
node_api -->|"mounts"| node_messageroutes
node_api -->|"mounts"| node_feeroutes
node_api -->|"mounts"| node_attendanceroutes
node_api -->|"mounts"| node_schoolroutes
node_authroutes -->|"protects routes"| node_authguard
node_authroutes -->|"dispatches"| node_authcontroller
node_authcontroller -->|"calls"| node_authservice
node_taskroutes -->|"dispatches"| node_taskcontroller
node_taskcontroller -->|"calls"| node_taskservice
node_taskservice -->|"reads and writes"| node_taskstore
node_schoolroutes -->|"dispatches"| node_schoolcontroller
node_messageroutes -.->|"serves messaging records"| node_database
node_feeroutes -.->|"serves fee records"| node_database
node_attendanceroutes -.->|"serves attendance records"| node_database
node_aiui -.->|"asks and summarizes"| node_ai
node_server -->|"creates HTTP server"| node_api
node_server -->|"connects"| node_database
node_server -->|"initializes"| node_socket
node_schoolui -.->|"supports attendance views"| node_attendanceroutes
node_dashboards -.->|"opens task workflow"| node_homeworkui
node_messagesui -.->|"uses messaging API"| node_messageroutes
node_schoolui -.->|"uses school administration API"| node_schoolroutes

click node_app "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/App.jsx"
click node_authstate "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/context/AuthContext.jsx"
click node_login "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/LoginPage.jsx"
click node_dashboards "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/TeacherDashboard.jsx"
click node_homeworkui "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/HomeworkTasksPage.jsx"
click node_batchui "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/components/tasks/TaskBatchManager.jsx"
click node_messagesui "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/MessagesPage.jsx"
click node_aiui "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/AIAssistantPage.jsx"
click node_frontendapi "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/services/api.js"
click node_taskclient "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/services/taskService.js"
click node_authclient "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/services/authService.js"
click node_schoolui "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/SchoolAdminDashboard.jsx"
click node_schoolclient "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/services/schoolService.js"
click node_api "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/app.js"
click node_authroutes "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/authRoutes.js"
click node_authcontroller "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/controllers/authController.js"
click node_authservice "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/services/authService.js"
click node_authguard "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/middleware/authMiddleware.js"
click node_taskroutes "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/taskRoutes.js"
click node_taskcontroller "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/controllers/taskController.js"
click node_taskservice "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/services/taskService.js"
click node_taskstore "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/models/Task.js"
click node_messageroutes "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/messageRoutes.js"
click node_feeroutes "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/feeRoutes.js"
click node_attendanceroutes "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/attendanceRoutes.js"
click node_schoolroutes "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/schoolRoutes.js"
click node_schoolcontroller "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/controllers/schoolController.js"
click node_ai "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/services/ai/aiOrchestrator.js"
click node_server "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/server.js"
click node_database "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/config/db.js"
click node_socket "https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/services/socketService.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_login,node_dashboards,node_users toneBlue
class node_authstate,node_authclient,node_authroutes,node_authcontroller,node_authservice,node_authguard toneAmber
class node_homeworkui,node_batchui,node_messagesui,node_aiui,node_taskclient,node_taskroutes,node_taskcontroller,node_taskservice,node_taskstore,node_messageroutes,node_ai toneMint
class node_schoolui,node_schoolclient,node_feeroutes,node_attendanceroutes,node_schoolroutes,node_schoolcontroller toneRose
class node_frontendapi,node_api,node_server,node_database,node_socket toneIndigo
```

## Components

### Role Workspaces

- [Role router](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login and onboarding](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/LoginPage.jsx): `frontend/src/pages/LoginPage.jsx`
- [Role dashboards](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/TeacherDashboard.jsx): `frontend/src/pages/TeacherDashboard.jsx`

### Identity and Tenancy

- [Session state](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Auth API client](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/services/authService.js): `frontend/src/services/authService.js`
- [Auth routes](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Auth handler](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Authentication](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/services/authService.js): `backend/src/services/authService.js`
- [Session and role guards](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/middleware/authMiddleware.js): `backend/src/middleware/authMiddleware.js`

### Academic Workflows

- [Homework workspace](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/HomeworkTasksPage.jsx): `frontend/src/pages/HomeworkTasksPage.jsx`
- [Parent batching](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/components/tasks/TaskBatchManager.jsx): `frontend/src/components/tasks/TaskBatchManager.jsx`
- [Family messaging](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/MessagesPage.jsx): `frontend/src/pages/MessagesPage.jsx`
- [School AI](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/AIAssistantPage.jsx): `frontend/src/pages/AIAssistantPage.jsx`
- [Task API client](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/services/taskService.js): `frontend/src/services/taskService.js`
- [Task routes](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/taskRoutes.js): `backend/src/routes/taskRoutes.js`
- [Task handler](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/controllers/taskController.js): `backend/src/controllers/taskController.js`
- [Task and batch logic](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/services/taskService.js): `backend/src/services/taskService.js`
- [Task records](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/models/Task.js): `backend/src/models/Task.js`
- [Message routes](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/messageRoutes.js): `backend/src/routes/messageRoutes.js`
- [AI assistant and digest](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/services/ai/aiOrchestrator.js): `backend/src/services/ai/aiOrchestrator.js`

### School Operations

- [School administration](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/pages/SchoolAdminDashboard.jsx): `frontend/src/pages/SchoolAdminDashboard.jsx`
- [School API client](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/services/schoolService.js): `frontend/src/services/schoolService.js`
- [Fee routes](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/feeRoutes.js): `backend/src/routes/feeRoutes.js`
- [Attendance routes](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/attendanceRoutes.js): `backend/src/routes/attendanceRoutes.js`
- [School routes](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/routes/schoolRoutes.js): `backend/src/routes/schoolRoutes.js`
- [School handler](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/controllers/schoolController.js): `backend/src/controllers/schoolController.js`

### Backend Platform

- [HTTP client](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Express API](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/app.js): `backend/src/app.js`
- [Runtime startup](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/server.js): `backend/src/server.js`
- [MongoDB](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/config/db.js): `backend/src/config/db.js`
- [Live notifications](https://github.com/sanjairajeshkumar/smart-school-connect-ai/blob/master/backend/src/services/socketService.js): `backend/src/services/socketService.js`

### Other components

- **School users**

## Connections

- School users → Role router: use workspaces
- Role router → Session state: reads session (evidence: `frontend/src/App.jsx`)
- Role router → Login and onboarding: shows login (evidence: `frontend/src/App.jsx`)
- Role router → Role dashboards: routes roles (evidence: `frontend/src/App.jsx`)
- Role router → Homework workspace: routes homework (evidence: `frontend/src/App.jsx`)
- Role router → Family messaging: routes messages (evidence: `frontend/src/App.jsx`)
- Role router → School AI: routes assistant (evidence: `frontend/src/App.jsx`)
- Session state → Auth API client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Session state → Live notifications: starts session socket (evidence: `frontend/src/context/AuthContext.jsx`)
- Homework workspace → Task API client: loads and updates (evidence: `frontend/src/pages/HomeworkTasksPage.jsx`)
- Parent batching → Task API client: manages batches (evidence: `frontend/src/components/tasks/TaskBatchManager.jsx`)
- School administration → School API client: loads school data (evidence: `frontend/src/pages/SchoolAdminDashboard.jsx`)
- HTTP client → Express API: sends API requests
- Auth API client → HTTP client: uses (evidence: `frontend/src/services/authService.js`)
- Task API client → HTTP client: uses (evidence: `frontend/src/services/taskService.js`)
- School API client → HTTP client: uses (evidence: `frontend/src/services/schoolService.js`)
- Express API → Auth routes: mounts (evidence: `backend/src/app.js`)
- Express API → Task routes: mounts (evidence: `backend/src/app.js`)
- Express API → Message routes: mounts (evidence: `backend/src/app.js`)
- Express API → Fee routes: mounts (evidence: `backend/src/app.js`)
- Express API → Attendance routes: mounts (evidence: `backend/src/app.js`)
- Express API → School routes: mounts (evidence: `backend/src/app.js`)
- Auth routes → Session and role guards: protects routes (evidence: `backend/src/routes/authRoutes.js`)
- Auth routes → Auth handler: dispatches (evidence: `backend/src/routes/authRoutes.js`)
- Auth handler → Authentication: calls (evidence: `backend/src/controllers/authController.js`)
- Task routes → Task handler: dispatches (evidence: `backend/src/routes/taskRoutes.js`)
- Task handler → Task and batch logic: calls (evidence: `backend/src/controllers/taskController.js`)
- Task and batch logic → Task records: reads and writes (evidence: `backend/src/services/taskService.js`)
- School routes → School handler: dispatches (evidence: `backend/src/routes/schoolRoutes.js`)
- Message routes → MongoDB: serves messaging records
- Fee routes → MongoDB: serves fee records
- Attendance routes → MongoDB: serves attendance records
- School AI → AI assistant and digest: asks and summarizes
- Runtime startup → Express API: creates HTTP server (evidence: `backend/src/server.js`)
- Runtime startup → MongoDB: connects (evidence: `backend/src/server.js`)
- Runtime startup → Live notifications: initializes (evidence: `backend/src/server.js`)
- School administration → Attendance routes: supports attendance views
- Role dashboards → Homework workspace: opens task workflow
- Family messaging → Message routes: uses messaging API
- School administration → School routes: uses school administration API
