How kaditya2006/smart-campus-quickfix works
Smart Campus QuickFix is a mobile issue-reporting and maintenance workflow: campus users register, verify identity, and authenticate; report and track issues; authorities triage, prioritize, and resolve them; and users receive updates. The mobile app calls an Express API, whose controllers coordinate issue, user, OTP, and notification records plus verification and email services. Analytics, dashboards, profiles, and notifications are additional product branches. Some screen and route implementations were not sampled; those capabilities and links are included only where documented or indexed.
Main entry points: authController.ts OTP and registration · issueController.ts User issue operations · RootNavigation.tsx Role navigation · app.ts API routing
Components 32
Mobile app
- App shell
mobile/App.tsx - Role navigation
mobile/src/navigation/RootNavigation.tsx - Sign-in and registration
mobile/src/screens/auth - User dashboard and tracking
mobile/src/screens/user - Issue reporting
mobile/src/screens/user/ReportIssueScreen.tsx - Authority queue and details
mobile/src/screens/authority - API client
mobile/src/services/apiClient.ts
Identity and access
- Session context
mobile/src/context/AuthContext.tsx - Verification status
mobile/src/screens/verification/VerificationPendingScreen.tsx - OTP and registration
server/src/controllers/authController.ts - Identity verification
server/src/services/identityVerificationService.ts - JWT and role checks
server/src/middleware/auth.ts - Document and photo uploads
server/src/middleware/upload.ts - User records
server/src/models/User.ts - OTP records
server/src/models/Otp.ts
Issue workflow
- User issue operations
server/src/controllers/issueController.ts - Authority issue operations
server/src/controllers/authorityController.ts - Status transition rules
server/src/services/statusTransitionService.ts - Issue records
server/src/models/Issue.ts
Updates and insights
- Notification operations
server/src/controllers/notificationController.ts - Notification creation
server/src/services/notificationService.ts - Notification records
server/src/models/Notification.ts - Analytics
server/src/controllers/analyticsController.ts - Email delivery
server/src/services/emailService.ts - SMTP service
API and data
- Authentication routes
server/src/routes/authRoutes.ts - Issue routes
server/src/routes/issueRoutes.ts - Notification routes
server/src/routes/notificationRoutes.ts - API routing
server/src/app.ts - MongoDB
Other components
- Campus user
- Authority
Connections 45
- Campus user → App shell: uses
README.md - Authority → App shell: uses
README.md - App shell → Session context: provides session
mobile/App.tsx - App shell → Role navigation: renders
mobile/App.tsx - Role navigation → Sign-in and registration: routes to
- Role navigation → Verification status: routes to
mobile/src/navigation/RootNavigation.tsx - Role navigation → User dashboard and tracking: routes to
mobile/src/navigation/RootNavigation.tsx - Role navigation → Authority queue and details: routes to
mobile/src/navigation/RootNavigation.tsx - Sign-in and registration → API client: calls
mobile/src/screens/auth/LoginScreen.tsx - Sign-in and registration → Session context: sets session
mobile/src/screens/auth/OtpVerificationScreen.tsx - Issue reporting → API client: submits report
mobile/src/screens/user/ReportIssueScreen.tsx - Authority queue and details → API client: loads and updates
mobile/src/screens/authority/AuthorityIssueDetailsScreen.tsx - User dashboard and tracking → API client: calls
mobile/src/screens/user/ReportIssueScreen.tsx - API client → API routing: sends API requests
mobile/src/services/apiClient.ts - API routing → Authentication routes: mounts
server/src/app.ts - API routing → Issue routes: mounts
server/src/app.ts - API routing → Notification routes: mounts
server/src/app.ts - API routing → Analytics: mounts analytics routes
server/src/app.ts - Authentication routes → OTP and registration: dispatches to
server/src/routes/authRoutes.ts - Authentication routes → Document and photo uploads: accepts ID upload
server/src/routes/authRoutes.ts - Authentication routes → JWT and role checks: protects routes
server/src/routes/authRoutes.ts - OTP and registration → User records: reads and writes
server/src/controllers/authController.ts - OTP and registration → OTP records: creates and verifies
server/src/controllers/authController.ts - OTP and registration → Identity verification: starts verification
server/src/controllers/authController.ts - OTP and registration → Email delivery: sends OTP email
server/src/controllers/authController.ts - JWT and role checks → User records: loads account
server/src/middleware/auth.ts - Issue routes → User issue operations: dispatches to
server/src/routes/issueRoutes.ts - Issue routes → JWT and role checks: protects routes
server/src/routes/issueRoutes.ts - Issue routes → Document and photo uploads: accepts evidence
server/src/routes/issueRoutes.ts - User issue operations → Issue records: reads and writes
server/src/controllers/issueController.ts - User issue operations → User records: loads authorities and reporter
server/src/controllers/issueController.ts - User issue operations → Notification creation: notifies authorities
server/src/controllers/issueController.ts - User issue operations → Email delivery: emails reporter
server/src/controllers/issueController.ts - Authority issue operations → Issue records: reads and updates
server/src/controllers/authorityController.ts - Authority issue operations → Status transition rules: validates status
server/src/controllers/authorityController.ts - Authority issue operations → Notification creation: creates update notices
server/src/controllers/authorityController.ts - Authority issue operations → Email delivery: emails reporter
server/src/controllers/authorityController.ts - Notification routes → Notification operations: dispatches to
server/src/routes/notificationRoutes.ts - Notification operations → Notification records: reads notifications
server/src/controllers/notificationController.ts - Notification creation → Notification records: creates records
server/src/services/notificationService.ts - Notification creation → Issue records: loads issue data
server/src/services/notificationService.ts - OTP and registration → MongoDB: persists account and OTP data
- User issue operations → MongoDB: persists issues
- Email delivery → SMTP service: delivers mail
README.md - Analytics → MongoDB: queries analytics data