How bajrangi-it/attendify works
CampusAttend OS is a role-based college attendance and institutional operations platform. Faculty launch live sessions and students check in; the system records attendance for student history, faculty monitoring, reports, and institutional oversight. The product spans the web portal, mobile app, classroom kiosk, attendance API, QR/security functions, and Supabase data services. The README documents capabilities beyond the sampled source, including role-specific administration, dynamic QR rotation, audit controls, and asynchronous reporting; edges for those documented flows cite the README where implementation wiring was not shown.
Main entry points: supabase.ts Supabase Services · App.tsx College Portal · server.ts Engine API · reportQueue.ts Async Reporting
Components 27
User Applications
- College Portal
apps/college-web/src/App.tsx - Web Authentication
apps/college-web/src/context/AuthContext.tsx - Live Session Console
apps/college-web/src/views/teacher/LiveSessionManager.tsx - Timetable Management
apps/college-web/src/views/timetable/TimetableManager.tsx - Governance Views
apps/college-web/src/views/director - Student Portal
apps/college-web/src/views/student/StudentDashboard.tsx - Universal Mobile App
apps/student-mobile/App.tsx - Mobile Authentication
apps/student-mobile/src/context/AuthContext.tsx - Mobile QR Check-in
apps/student-mobile/src/views/student/StudentScannerScreen.tsx - Mobile Faculty Console
apps/student-mobile/src/views/faculty/FacultyLiveSessionScreen.tsx - Smart Display Kiosk
apps/smart-display/src/App.tsx
Attendance Engine
- Engine API
apps/attendance-engine/src/server.ts - API Authentication
apps/attendance-engine/src/middleware/authMiddleware.ts - Session Services
apps/attendance-engine/src/services/sessionService.ts - Display Services
apps/attendance-engine/src/services/displayService.ts - Attendance Processing
apps/attendance-engine/src/services/attendanceService.ts - Async Reporting
apps/attendance-engine/src/services/reportQueue.ts - Audit Services
apps/attendance-engine/src/services/auditService.ts - Report Generation
apps/attendance-engine/src/services/reportGenerator.ts
QR Security
- Attendance SDK
packages/attendance-sdk/src/client.ts - QR Token Issuance
supabase/functions/session-qr-token/index.ts - QR Attendance Verification
supabase/functions/verify-qr-attendance/index.ts
Platform Data
- Supabase Services
apps/college-web/src/lib/supabase.ts - Redis Cache
apps/attendance-engine/src/redis/cache.ts
Other components
- Faculty
- Students
- Institutional Staff
Connections 35
- Faculty → Live Session Console: runs sessions
- Students → Mobile QR Check-in: scan QR
- Institutional Staff → Governance Views: manage institution
- College Portal → Web Authentication: uses auth
apps/college-web/src/App.tsx - College Portal → Live Session Console: routes to
apps/college-web/src/App.tsx - College Portal → Timetable Management: routes to
apps/college-web/src/App.tsx - College Portal → Governance Views: routes to
apps/college-web/src/App.tsx - College Portal → Student Portal: routes to
apps/college-web/src/App.tsx - Web Authentication → Supabase Services: authenticates via
apps/college-web/src/context/AuthContext.tsx - Live Session Console → Supabase Services: reads and writes
apps/college-web/src/views/teacher/LiveSessionManager.tsx - Timetable Management → Supabase Services: reads and writes
apps/college-web/src/views/timetable/TimetableManager.tsx - Universal Mobile App → Mobile Authentication: uses auth
apps/student-mobile/App.tsx - Universal Mobile App → Mobile QR Check-in: routes to
apps/student-mobile/App.tsx - Universal Mobile App → Mobile Faculty Console: routes to
apps/student-mobile/App.tsx - Mobile Authentication → Supabase Services: loads profiles
apps/student-mobile/src/context/AuthContext.tsx - Mobile Faculty Console → Supabase Services: reads attendance
apps/student-mobile/src/views/faculty/FacultyLiveSessionScreen.tsx - Smart Display Kiosk → QR Token Issuance: rotates codes
- Smart Display Kiosk → Display Services: requests display data
- Engine API → Session Services: mounts session routes
apps/attendance-engine/src/server.ts - Engine API → Attendance Processing: mounts attendance routes
apps/attendance-engine/src/server.ts - Engine API → Display Services: mounts display routes
apps/attendance-engine/src/server.ts - Engine API → Async Reporting: mounts report routes
apps/attendance-engine/src/server.ts - Engine API → API Authentication: uses authentication
- Session Services → Supabase Services: reads sessions
apps/attendance-engine/src/services/sessionService.ts - Session Services → Redis Cache: uses cache
apps/attendance-engine/src/services/sessionService.ts - Display Services → Supabase Services: reads display data
apps/attendance-engine/src/services/displayService.ts - Attendance Processing → Supabase Services: records check-ins
- Attendance Processing → Redis Cache: checks rate limits
- Async Reporting → Report Generation: queues generation
- Async Reporting → Supabase Services: tracks reports
- Async Reporting → Audit Services: audits requests
apps/attendance-engine/src/routes/reportRoutes.ts - QR Token Issuance → Attendance SDK: issues HMAC tokens
- QR Attendance Verification → Attendance Processing: verifies check-in
- Attendance SDK → QR Attendance Verification: supports drift verification
- Supabase Services → Students: stores canonical records