How sowmiyacodes/srms works
SRMS is a role-based student and staff management application. Users select a portal, authenticate, and enter role-specific dashboards; HOD/admin workflows manage student records and staff, while staff workflows expose faculty-advisor and project-student views. The backend separates HTTP routing, controllers, services, and query construction over PostgreSQL, with Supabase used in authentication. The README documents the broader role and session capabilities; some page-to-API and auth wiring is not shown in the excerpts, so those links are omitted.
Main entry points: App.jsx Role routing · AdminDashboard.jsx Student dashboard · staff.api.js Staff API · app.js Express entrypoint
Components 28
Web application
- Role routing
frontend/src/App.jsx - Login and registration
frontend/src/pages/LoginPage.jsx - Student dashboard
frontend/src/pages/AdminDashboard.jsx - Staff management
frontend/src/pages/StaffManagement.jsx - Advisor management
frontend/src/components/staff/FAManagement.jsx - Project students
frontend/src/components/staff/ProjectStudentsModal.jsx - Student filters
frontend/src/components/students/StudentFilters.jsx - Student table and profile
frontend/src/components/students/StudentTable.jsx
API and access
- HTTP client
frontend/src/api/axios.js - Student API
frontend/src/api/student.api.js - Staff API
frontend/src/api/staff.api.js - Express entrypoint
backend/app.js - Authentication routes
backend/src/routes/authRoutes.js - Student routes
backend/src/routes/student.routes.js - Staff routes
backend/src/routes/staff.routes.js - Authentication controller
backend/src/controllers/authController.js
Student management
- Student controller
backend/src/controllers/student.controller.js - Student service
backend/src/services/student.service.js - Student listing query
backend/src/queries/student/studentListQuery.js - Query filters and stats
backend/src/filters/student
Staff management
- Staff controller
backend/src/controllers/staff.controller.js - Staff service
backend/src/services/staff.service.js - Staff queries
backend/src/queries/staff - Project-student service
backend/src/services/projectStudents.service.js - Project-student query
backend/src/queries/projectStudents/projectStudentsQuery.js
Other components
- Portal user
- PostgreSQL
backend/src/config/db.js - Supabase
backend/src/config/supabase.js
Connections 30
- Portal user → Role routing: navigates
frontend/src/App.jsx - Role routing → Login and registration: routes to
frontend/src/App.jsx - Role routing → Student dashboard: routes to
frontend/src/App.jsx - Role routing → Staff management: routes to
frontend/src/App.jsx - Staff management → Staff API: requests staff
frontend/src/pages/StaffManagement.jsx - Staff management → Student API: requests advisor students
frontend/src/pages/StaffManagement.jsx - Advisor management → Staff API: uses API
frontend/src/components/staff/FAManagement.jsx - Project students → Staff API: uses API
frontend/src/components/staff/ProjectStudentsModal.jsx - Student dashboard → Student API: requests student data
frontend/src/pages/AdminDashboard.jsx - Student dashboard → Student filters: renders
frontend/src/pages/AdminDashboard.jsx - Student dashboard → Student table and profile: renders
frontend/src/pages/AdminDashboard.jsx - Student API → HTTP client: sends requests
frontend/src/api/student.api.js - Staff API → HTTP client: sends requests
frontend/src/api/staff.api.js - Express entrypoint → Authentication routes: mounts
backend/app.js - Express entrypoint → Student routes: mounts
backend/app.js - Express entrypoint → Staff routes: mounts
backend/app.js - Student routes → Student controller: dispatches
backend/src/routes/student.routes.js - Staff routes → Staff controller: dispatches
backend/src/routes/staff.routes.js - Student controller → Student service: delegates
backend/src/controllers/student.controller.js - Student service → Student listing query: requests listing
backend/src/services/student.service.js - Student listing query → Query filters and stats: applies filters
backend/src/queries/student/studentListQuery.js - Query filters and stats → PostgreSQL: queries database
backend/src/filters/student/baseQuery.js - Staff controller → Staff service: delegates
backend/src/controllers/staff.controller.js - Staff controller → Project-student service: requests project students
backend/src/controllers/staff.controller.js - Staff service → Staff queries: uses queries
backend/src/services/staff.service.js - Staff queries → PostgreSQL: queries database
backend/src/queries/staff/faStudentsQuery.js - Project-student service → Project-student query: delegates
backend/src/services/projectStudents.service.js - Project-student query → PostgreSQL: queries database
backend/src/queries/projectStudents/projectStudentsQuery.js - Authentication routes → Authentication controller: routes auth
- Authentication controller → Supabase: reads and writes users
backend/src/controllers/authController.js