How shubh02284/face-attendance-app works
FaceAttend is a web-based attendance system for managing students and classes, recording attendance from classroom photos with face recognition, and viewing history and reports. The principal flow is an instructor selecting class details and uploading a photo; the Attendance page obtains enrolled students, asks the AI service to detect faces, matches results, and saves attendance through the backend. The backend also provides authentication and student/class management. Page capabilities are identified from routing and the tree; unsampled page internals and API wiring are not expanded.
Main entry points: App.jsx App routing · server.js API server · models Data models · Attendance.jsx Attendance workflow
Components 21
Web application
- App routing
src/App.jsx - Sign in / register
src/pages - Dashboard
src/pages/Dashboard.jsx - Attendance workflow
src/pages/Attendance.jsx - Student management
src/pages/Students.jsx - Class management
src/pages/Classes.jsx - Attendance history
src/pages/History.jsx - Reports
src/pages/Reports.jsx - Settings
src/pages/Settings.jsx - API client
src/utils/api.js
Face recognition
- Face analysis service
ai-service/main.py
Backend API
- API server
backend/server.js - Authentication routes
backend/routes/authRoutes.js - Token middleware
backend/middleware/authMiddleware.js - Student routes
backend/routes/studentRoutes.js - Class routes
backend/routes/classRoutes.js - Attendance routes
backend/routes/attendanceRoutes.js
Persistent data
- Data models
backend/models - Database connection
backend/config/db.js
Other components
- Instructor
- MongoDB
Connections 27
- Instructor → App routing: uses
- App routing → Sign in / register: routes
- App routing → Dashboard: routes
- App routing → Attendance workflow: routes
- App routing → Student management: routes
- App routing → Class management: routes
- App routing → Attendance history: routes
- App routing → Reports: routes
- App routing → Settings: routes
- Attendance workflow → API client: requests classes, students, attendance
- Attendance workflow → Face analysis service: uploads photo
- Face analysis service → Attendance workflow: returns detected faces
- API client → API server: HTTP requests
- API server → Authentication routes: dispatches
- API server → Student routes: dispatches
- API server → Class routes: dispatches
- API server → Attendance routes: dispatches
- Student routes → Token middleware: authenticates
- Class routes → Token middleware: authenticates
- Attendance routes → Token middleware: authenticates
- Student routes → Data models: reads and writes
- Class routes → Data models: reads and writes
- Attendance routes → Data models: reads and writes
- Authentication routes → Data models: reads and writes
- Token middleware → Data models: loads user
- API server → Database connection: connects
- Database connection → MongoDB: opens connection