How sanjairajeshkumar/smart-school-connect-ai works
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: app.js Express API · App.jsx Role router · api.js HTTP client · db.js MongoDB
Components 32
Role Workspaces
- Role router
frontend/src/App.jsx - Login and onboarding
frontend/src/pages/LoginPage.jsx - Role dashboards
frontend/src/pages/TeacherDashboard.jsx
Identity and Tenancy
- Session state
frontend/src/context/AuthContext.jsx - Auth API client
frontend/src/services/authService.js - Auth routes
backend/src/routes/authRoutes.js - Auth handler
backend/src/controllers/authController.js - Authentication
backend/src/services/authService.js - Session and role guards
backend/src/middleware/authMiddleware.js
Academic Workflows
- Homework workspace
frontend/src/pages/HomeworkTasksPage.jsx - Parent batching
frontend/src/components/tasks/TaskBatchManager.jsx - Family messaging
frontend/src/pages/MessagesPage.jsx - School AI
frontend/src/pages/AIAssistantPage.jsx - Task API client
frontend/src/services/taskService.js - Task routes
backend/src/routes/taskRoutes.js - Task handler
backend/src/controllers/taskController.js - Task and batch logic
backend/src/services/taskService.js - Task records
backend/src/models/Task.js - Message routes
backend/src/routes/messageRoutes.js - AI assistant and digest
backend/src/services/ai/aiOrchestrator.js
School Operations
- School administration
frontend/src/pages/SchoolAdminDashboard.jsx - School API client
frontend/src/services/schoolService.js - Fee routes
backend/src/routes/feeRoutes.js - Attendance routes
backend/src/routes/attendanceRoutes.js - School routes
backend/src/routes/schoolRoutes.js - School handler
backend/src/controllers/schoolController.js
Backend Platform
- HTTP client
frontend/src/services/api.js - Express API
backend/src/app.js - Runtime startup
backend/src/server.js - MongoDB
backend/src/config/db.js - Live notifications
backend/src/services/socketService.js
Other components
- School users
Connections 40
- School users → Role router: use workspaces
- Role router → Session state: reads session
frontend/src/App.jsx - Role router → Login and onboarding: shows login
frontend/src/App.jsx - Role router → Role dashboards: routes roles
frontend/src/App.jsx - Role router → Homework workspace: routes homework
frontend/src/App.jsx - Role router → Family messaging: routes messages
frontend/src/App.jsx - Role router → School AI: routes assistant
frontend/src/App.jsx - Session state → Auth API client: calls
frontend/src/context/AuthContext.jsx - Session state → Live notifications: starts session socket
frontend/src/context/AuthContext.jsx - Homework workspace → Task API client: loads and updates
frontend/src/pages/HomeworkTasksPage.jsx - Parent batching → Task API client: manages batches
frontend/src/components/tasks/TaskBatchManager.jsx - School administration → School API client: loads school data
frontend/src/pages/SchoolAdminDashboard.jsx - HTTP client → Express API: sends API requests
- Auth API client → HTTP client: uses
frontend/src/services/authService.js - Task API client → HTTP client: uses
frontend/src/services/taskService.js - School API client → HTTP client: uses
frontend/src/services/schoolService.js - Express API → Auth routes: mounts
backend/src/app.js - Express API → Task routes: mounts
backend/src/app.js - Express API → Message routes: mounts
backend/src/app.js - Express API → Fee routes: mounts
backend/src/app.js - Express API → Attendance routes: mounts
backend/src/app.js - Express API → School routes: mounts
backend/src/app.js - Auth routes → Session and role guards: protects routes
backend/src/routes/authRoutes.js - Auth routes → Auth handler: dispatches
backend/src/routes/authRoutes.js - Auth handler → Authentication: calls
backend/src/controllers/authController.js - Task routes → Task handler: dispatches
backend/src/routes/taskRoutes.js - Task handler → Task and batch logic: calls
backend/src/controllers/taskController.js - Task and batch logic → Task records: reads and writes
backend/src/services/taskService.js - School routes → School handler: dispatches
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
backend/src/server.js - Runtime startup → MongoDB: connects
backend/src/server.js - Runtime startup → Live notifications: initializes
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