How chiraggupta777/campusfix works
CampusFix is a student complaint-reporting and administrator workflow application. Students register or sign in, submit issues with images, and track issue status and notifications; administrators review issues, view dashboard statistics, and update status or remarks. The frontend routes those experiences through shared API services to an Express REST API, whose controllers use MongoDB models and notification logic. The README documents MongoDB Atlas and Cloudinary integrations. Some page-to-service and backend route relationships are supported by the SOURCE INDEX rather than fully sampled implementations; those limits are reflected in the evidence paths.
Main entry points: app.js REST API · App.jsx Route views · authMiddleware.js JWT and role guard · uploadRoutes.js Upload routes
Components 32
Frontend experience
- React application
Frontend/src/main.jsx - Route views
Frontend/src/App.jsx - Landing page
Frontend/src/pages/Landing.jsx - Student issue views
Frontend/src/pages/dashboard - Admin views
Frontend/src/pages/admin
Authentication
- Login and register
Frontend/src/pages - Auth state
Frontend/src/context/AuthContext.jsx - Auth client
Frontend/src/services/authService.js - Auth routes
backend/src/routes/authRoutes.js - Auth controller
backend/src/controllers/authController.js - JWT and role guard
backend/src/middleware/authMiddleware.js
Issue workflow
- API client
Frontend/src/services/api.js - Issue client
Frontend/src/services/issueService.js - Issue routes
backend/src/routes/issueRoutes.js - Student issue handling
backend/src/controllers/issueController.js - Admin routes
backend/src/routes/adminRoutes.js - Admin issue handling
backend/src/controllers/adminController.js
Notifications and media
- Notification routes
backend/src/routes/notificationRoutes.js - Notification handling
backend/src/controllers/notificationController.js - Notification creation
backend/src/services/notificationService.js - Upload routes
backend/src/routes/uploadRoutes.js - Upload handling
backend/src/middleware/uploadMiddleware.js - Image upload
backend/src/controllers/uploadController.js - Cloudinary setup
backend/src/config/cloudinary.js
Backend API and data
- REST API
backend/src/app.js - User records
backend/src/models/User.js - Issue records
backend/src/models/Issue.js - Notification records
backend/src/models/Notification.js
Other components
- Student
- Administrator
- MongoDB Atlas
- Cloudinary
Connections 43
- Student → React application: uses
README.md - Administrator → React application: uses
README.md - React application → Route views: renders
Frontend/src/main.jsx - Route views → Landing page: routes to
Frontend/src/App.jsx - Route views → Student issue views: routes to
Frontend/src/App.jsx - Route views → Admin views: routes to
Frontend/src/App.jsx - Route views → Login and register: routes to
Frontend/src/App.jsx - Login and register → Auth state: uses
Frontend/src/pages/Login.jsx - Auth state → Auth client: calls
Frontend/src/context/AuthContext.jsx - Auth client → API client: calls
Frontend/src/services/authService.js - Student issue views → Issue client: calls
Frontend/src/pages/dashboard/ReportIssue.jsx - Admin views → Issue client: calls
Frontend/src/pages/admin/AdminDashboard.jsx - Issue client → API client: calls
Frontend/src/services/issueService.js - API client → REST API: sends API calls
README.md - REST API → Auth routes: mounts
backend/src/app.js - REST API → Issue routes: mounts
backend/src/app.js - REST API → Admin routes: mounts
backend/src/app.js - REST API → Notification routes: mounts
backend/src/app.js - REST API → Upload routes: mounts
backend/src/app.js - Auth routes → Auth controller: routes to
backend/src/routes/authRoutes.js - Auth controller → User records: reads and writes
backend/src/controllers/authController.js - Admin routes → JWT and role guard: applies
backend/src/routes/adminRoutes.js - Issue routes → JWT and role guard: applies
backend/src/routes/issueRoutes.js - Notification routes → JWT and role guard: applies
backend/src/routes/notificationRoutes.js - Upload routes → JWT and role guard: applies
backend/src/routes/uploadRoutes.js - JWT and role guard → User records: loads user
backend/src/middleware/authMiddleware.js - Issue routes → Student issue handling: routes to
backend/src/routes/issueRoutes.js - Student issue handling → Issue records: reads and writes
backend/src/controllers/issueController.js - Admin routes → Admin issue handling: routes to
backend/src/routes/adminRoutes.js - Admin issue handling → Issue records: reads and updates
backend/src/controllers/adminController.js - Student issue handling → Notification creation: notifies
backend/src/controllers/issueController.js - Admin issue handling → Notification creation: notifies
backend/src/controllers/adminController.js - Notification routes → Notification handling: routes to
backend/src/routes/notificationRoutes.js - Notification handling → Notification records: reads and updates
backend/src/controllers/notificationController.js - Notification creation → Notification records: creates
backend/src/services/notificationService.js - Upload routes → Upload handling: uses
backend/src/routes/uploadRoutes.js - Upload routes → Image upload: routes to
backend/src/routes/uploadRoutes.js - Image upload → Cloudinary setup: uses
backend/src/controllers/uploadController.js - User records → MongoDB Atlas: persists in
README.md - Issue records → MongoDB Atlas: persists in
README.md - Notification records → MongoDB Atlas: persists in
README.md - Cloudinary setup → Cloudinary: configures
README.md - Image upload → Cloudinary: uploads images
README.md