How animation-tech-253/fyp works
SUATS is a role-based university application submission and review system. Students submit applications and supporting files; examiners and department leadership review, request documents, forward or decide them, while administrators manage users, departments and settings. The frontend routes role-specific workspaces through Redux and HTTP APIs, with sockets for live updates. The backend mounts domain APIs and uses controllers, Mongo models, and notification/email/PDF integrations. Analytics, chatbot and VC capabilities are present in the tree but their detailed flows are not shown; edges for them are therefore omitted.
Main entry points: application.controller.js Application workflow · App.jsx Role-based app · app.js Express API · applicationsSlice.js Client state
Components 22
Role Workspaces
- Role-based app
frontend/src/App.jsx - Student submission
frontend/src/pages/student/SubmitApplicationPage.jsx - Review workspaces
frontend/src/pages/hod/HODReviewPage.jsx - Admin workspace
frontend/src/pages/admin/ManageUsersPage.jsx - Client state
frontend/src/store/slices/applicationsSlice.js - HTTP client
frontend/src/services/api.js - Socket client
frontend/src/hooks/useSocket.js
Backend API
- Express API
backend/src/app.js - Application routes
backend/src/routes/application.routes.js - User routes
backend/src/routes/user.routes.js
Application Domain
- Application workflow
backend/src/controllers/application.controller.js - User administration
backend/src/controllers/user.controller.js - Admin operations
backend/src/controllers/admin.controller.js - Other domain APIs
backend/src/controllers - Mongo models
backend/src/models/index.js
Live and Integrations
- Live notifications
backend/src/socket/index.js - Application email
backend/src/services/applicationEmail.service.js - PDF export
backend/src/utils/pdfGenerator.js - Profile image storage
backend/src/utils/cloudinary.js
Other components
- University users
- Email service
- Cloudinary
Connections 24
- University users → Role-based app: use
frontend/src/App.jsx - Role-based app → Student submission: routes to
frontend/src/App.jsx - Role-based app → Review workspaces: routes to
frontend/src/App.jsx - Role-based app → Admin workspace: routes to
frontend/src/App.jsx - Student submission → Client state: dispatches
frontend/src/pages/student/SubmitApplicationPage.jsx - Review workspaces → Client state: dispatches
frontend/src/pages/hod/HODReviewPage.jsx - Client state → HTTP client: requests
frontend/src/store/slices/applicationsSlice.js - HTTP client → Express API: HTTP calls
- Express API → Application routes: mounts
backend/src/app.js - Express API → User routes: mounts
backend/src/app.js - Application routes → Application workflow: routes requests
backend/src/routes/application.routes.js - User routes → User administration: routes requests
backend/src/routes/user.routes.js - Application workflow → Mongo models: reads and writes
backend/src/controllers/application.controller.js - User administration → Mongo models: reads and writes
backend/src/controllers/user.controller.js - Application workflow → Live notifications: emits events
backend/src/controllers/application.controller.js - Application workflow → Application email: sends mail
backend/src/controllers/application.controller.js - Application workflow → PDF export: generates export
backend/src/controllers/application.controller.js - User administration → Profile image storage: uploads images
backend/src/controllers/user.controller.js - Profile image storage → Cloudinary: stores files
- Application email → Email service: delivers mail
- Socket client → Client state: updates state
frontend/src/hooks/useSocket.js - Live notifications → Socket client: pushes events
- Admin operations → Mongo models: uses models
backend/src/controllers/admin.controller.js - Express API → Other domain APIs: mounts domain APIs
backend/src/app.js