How msyathin10/ccms_portal works
CCMS takes a student grievance from authenticated submission through administrative review and staff assignment, work, student verification, and feedback. The React portal presents separate student, administrator, and staff workflows; its API client calls the Express API, whose controllers apply domain operations to MongoDB models. The README also describes analytics, campus intelligence, AI-assisted suggestions and duplicate detection, notifications, and theme switching. Some page and controller implementations were not sampled, so those capabilities and links are shown only where documented or supported by the source index.
Main entry points: api.js API routing · App.jsx Role-based portal · authController.js Authentication · adminController.js Admin operations
Components 31
Web portal
- Role-based portal
client/src/App.jsx - Session and roles
client/src/context/AuthContext.jsx - Student complaints
client/src/pages/student - Admin console
client/src/pages/admin - Staff task board
client/src/pages/staff - Status timeline
client/src/components/StatusTimeline.jsx - Notification center
client/src/context/NotificationContext.jsx - Theme switcher
client/src/context/ThemeContext.jsx
API and workflows
- HTTP API client
client/src/services/api.js - Express API server
server/src/app.js - API routing
server/src/routes/api.js - Authentication
server/src/controllers/authController.js - Complaint handling
server/src/controllers/complaintController.js - Technician assignment
server/src/controllers/assignmentController.js - Status progression
server/src/controllers/statusController.js - Resolution feedback
server/src/controllers/feedbackController.js - Activity updates
server/src/controllers/updateController.js - Admin operations
server/src/controllers/adminController.js - AI and duplicates
server/src/controllers/aiHelperController.js - Notification service
server/src/controllers/notificationController.js
Complaint domain
- Complaint record
server/src/models/Complaint.js - User identity
server/src/models/User.js - Student profile
server/src/models/Student.js - Staff profile
server/src/models/Staff.js - Issue categories
server/src/models/Category.js - Departments
server/src/models/Department.js
Persistence and signals
- Notification record
server/src/models/Notification.js - MongoDB
server/src/config/db.js
Other components
- Student
- Administrator
- Department staff
Connections 48
- Student → Role-based portal: uses portal
README.md - Administrator → Role-based portal: uses portal
README.md - Department staff → Role-based portal: uses portal
README.md - Role-based portal → Student complaints: routes to
client/src/App.jsx - Role-based portal → Admin console: routes to
client/src/App.jsx - Role-based portal → Staff task board: routes to
client/src/App.jsx - Role-based portal → Session and roles: provides session
client/src/App.jsx - Student complaints → HTTP API client: calls
client/src/pages/student/SubmitComplaint.jsx - Admin console → HTTP API client: calls
client/src/pages/admin/AdminComplaintDetails.jsx - Staff task board → HTTP API client: calls
client/src/pages/staff/StaffComplaintDetails.jsx - Session and roles → HTTP API client: requests session
client/src/context/AuthContext.jsx - Notification center → HTTP API client: polls notifications
client/src/context/NotificationContext.jsx - Student complaints → Status timeline: renders progress
client/src/pages/student/StudentComplaintDetails.jsx - HTTP API client → Express API server: sends HTTP requests
client/src/services/api.js - Express API server → API routing: mounts routes
server/src/app.js - API routing → Authentication: dispatches auth
server/src/routes/api.js - API routing → Complaint handling: dispatches complaints
server/src/routes/api.js - API routing → Technician assignment: dispatches assignment
server/src/routes/api.js - API routing → Status progression: dispatches status
server/src/routes/api.js - API routing → Resolution feedback: dispatches feedback
server/src/routes/api.js - API routing → Activity updates: dispatches updates
server/src/routes/api.js - API routing → Admin operations: dispatches admin
server/src/routes/api.js - API routing → AI and duplicates: dispatches AI
server/src/routes/api.js - API routing → Notification service: dispatches notices
server/src/routes/api.js - Authentication → User identity: reads identity
server/src/controllers/authController.js - Authentication → Student profile: reads student profile
server/src/controllers/authController.js - Authentication → Staff profile: reads staff profile
server/src/controllers/authController.js - Authentication → Departments: reads department
server/src/controllers/authController.js - Authentication → Issue categories: reads categories
server/src/controllers/authController.js - Complaint handling → Complaint record: creates and queries
server/src/controllers/complaintController.js - Complaint handling → Issue categories: reads category
server/src/controllers/complaintController.js - Complaint handling → User identity: populates user
server/src/controllers/complaintController.js - Complaint handling → Student profile: reads profile
server/src/controllers/complaintController.js - Technician assignment → Complaint record: assigns complaint
server/src/controllers/assignmentController.js - Technician assignment → Notification record: creates notice
server/src/controllers/assignmentController.js - Technician assignment → User identity: reads user
server/src/controllers/assignmentController.js - Status progression → Complaint record: updates status
server/src/controllers/statusController.js - Status progression → Notification record: creates notice
server/src/controllers/statusController.js - Status progression → User identity: reads user
server/src/controllers/statusController.js - Admin operations → Complaint record: aggregates issues
server/src/controllers/adminController.js - Admin operations → Departments: manages departments
server/src/controllers/adminController.js - Admin operations → Issue categories: manages categories
server/src/controllers/adminController.js - Admin operations → User identity: manages accounts
server/src/controllers/adminController.js - Admin operations → Staff profile: creates staff
server/src/controllers/adminController.js - AI and duplicates → Complaint record: checks issues
server/src/controllers/aiHelperController.js - AI and duplicates → Issue categories: suggests category
server/src/controllers/aiHelperController.js - Notification service → Notification record: serves notices
- Student complaints → Complaint handling: submits and tracks
README.md