How omarkhan56/attendease works
AttendEase is a role-aware attendance and class-management application. Faculty create classes, enroll students, and start scheduled QR attendance sessions; students scan a session QR to record attendance, with optional WebAuthn verification. Users can review attendance history and analytics, while faculty can run spot checks. The graph follows documented UI routes and sampled backend routing/calls. Several page-to-API interactions and the analytics implementation were not sampled, so those connections are not inferred.
Main entry points: App.jsx App routing · server.js Express API · authMiddleware.js JWT and roles · attendanceController.js QR attendance
Components 34
Web application
- App routing
frontend/src/App.jsx - Authentication state
frontend/src/context/AuthContext.jsx - Route protection
frontend/src/components/PrivateRoute.jsx - Login and registration
frontend/src/pages/Login.jsx - Registration
frontend/src/pages/Register.jsx - Class browsing
frontend/src/pages/Classes.jsx - Class creation
frontend/src/pages/CreateClass.jsx - Class details
frontend/src/pages/ClassDetails.jsx - Student enrollment
frontend/src/pages/EnrollStudents.jsx - Mark attendance
frontend/src/pages/MarkAttendance.jsx - Attendance history
frontend/src/pages/AttendanceHistory.jsx - Attendance analytics
frontend/src/pages/Analytics.jsx - Dashboard
frontend/src/pages/Dashboard.jsx - Profile and devices
frontend/src/pages/Profile.jsx - Spot check
frontend/src/pages/SpotCheck.jsx
API and security
- Express API
backend/server.js - Authentication routes
backend/routes/authRoutes.js - Class routes
backend/routes/classRoutes.js - Attendance routes
backend/routes/attendanceRoutes.js - Analytics routes
backend/routes/analyticsRoutes.js - WebAuthn routes
backend/routes/webauthnRoutes.js - Spot-check routes
backend/routes/spotCheckRoutes.js - JWT and roles
backend/middleware/authMiddleware.js
Academic workflows
- Account operations
backend/controllers/authController.js - Class management
backend/controllers/classController.js - QR attendance
backend/controllers/attendanceController.js - Analytics queries
backend/controllers/analyticsController.js - Biometric verification
backend/controllers/webauthnController.js - Spot-check workflow
backend/controllers/spotCheckController.js
Data and integrations
- User records
backend/models/User.js - Class records
backend/models/Class.js - Attendance records
backend/models/Attendance.js - QR sessions
backend/models/QRSession.js
Other components
- Student or faculty
Connections 43
- App routing → Authentication state: provides state
frontend/src/App.jsx - App routing → Route protection: guards pages
frontend/src/App.jsx - App routing → Login and registration: routes to
frontend/src/App.jsx - App routing → Registration: routes to
frontend/src/App.jsx - App routing → Class browsing: routes to
frontend/src/App.jsx - App routing → Class creation: routes to
frontend/src/App.jsx - App routing → Class details: routes to
frontend/src/App.jsx - App routing → Student enrollment: routes to
frontend/src/App.jsx - App routing → Mark attendance: routes to
frontend/src/App.jsx - App routing → Attendance history: routes to
frontend/src/App.jsx - App routing → Attendance analytics: routes to
frontend/src/App.jsx - App routing → Dashboard: routes to
frontend/src/App.jsx - App routing → Profile and devices: routes to
frontend/src/App.jsx - App routing → Spot check: routes to
frontend/src/App.jsx - Express API → Authentication routes: mounts at
backend/server.js - Express API → Class routes: mounts at
backend/server.js - Express API → Attendance routes: mounts at
backend/server.js - Express API → Analytics routes: mounts at
backend/server.js - Express API → WebAuthn routes: mounts at
backend/server.js - Express API → Spot-check routes: mounts at
backend/server.js - Authentication routes → JWT and roles: protects routes
backend/routes/authRoutes.js - Class routes → JWT and roles: protects routes
backend/routes/classRoutes.js - Attendance routes → JWT and roles: protects routes
backend/routes/attendanceRoutes.js - Analytics routes → JWT and roles: protects routes
backend/routes/analyticsRoutes.js - WebAuthn routes → JWT and roles: protects routes
backend/routes/webauthnRoutes.js - Spot-check routes → JWT and roles: protects routes
backend/routes/spotCheckRoutes.js - Authentication routes → Account operations: dispatches to
backend/routes/authRoutes.js - Class routes → Class management: dispatches to
backend/routes/classRoutes.js - Attendance routes → QR attendance: dispatches to
backend/routes/attendanceRoutes.js - Analytics routes → Analytics queries: dispatches to
backend/routes/analyticsRoutes.js - WebAuthn routes → Biometric verification: dispatches to
backend/routes/webauthnRoutes.js - Spot-check routes → Spot-check workflow: dispatches to
backend/routes/spotCheckRoutes.js - JWT and roles → User records: loads account
backend/middleware/authMiddleware.js - Account operations → User records: reads and writes
backend/controllers/authController.js - Class management → Class records: reads and writes
backend/controllers/classController.js - Class management → User records: reads and updates
backend/controllers/classController.js - QR attendance → QR sessions: creates and checks
backend/controllers/attendanceController.js - QR attendance → Attendance records: records and queries
backend/controllers/attendanceController.js - QR attendance → Class records: checks enrollment
backend/controllers/attendanceController.js - QR attendance → Biometric verification: verifies assertion
backend/controllers/attendanceController.js - Biometric verification → User records: updates credentials
backend/controllers/webauthnController.js - Spot-check workflow → Attendance records: checks records
backend/controllers/spotCheckController.js - Spot-check workflow → Class records: checks class
backend/controllers/spotCheckController.js