How shintoo-engineer/apr-academic-presence-register works
APR is an academic management portal presented through role-specific dashboards for students, faculty, HODs, and administrators. The principal workflow is sign-in, role-based dashboard access, and academic operations such as attendance, marks, and leave requests, with monitoring and report export for staff. The sampled implementation is a browser-side React app backed by localStorage and bundled sample data; README claims about a database backend, secure authentication, and synchronization are not verified by the excerpts. Several feature details are documented but their implementation was not sampled.
Main entry points: App.tsx App Router · storageService.ts Storage Service · FacultyDashboard.tsx Faculty Dashboard · StudentDashboard.tsx Student Dashboard
Components 19
Portal and Access
- App Router
src/App.tsx - Login Page
src/components/LoginPage.tsx - Login Modal
src/components/LoginModal.tsx - Navigation
src/components/Navbar.tsx
Academic Workflows
- Student Dashboard
src/components/StudentDashboard.tsx - Faculty Dashboard
src/components/FacultyDashboard.tsx
Administration and Reporting
- HOD Dashboard
src/components/HodDashboard.tsx - Admin Dashboard
src/components/AdminDashboard.tsx - Report Export
src/components/ReportsExportModal.tsx - Geofence Configuration
src/components/GeofenceModal.tsx
Local Data and Rules
- Student Records
src/data/studentsData.ts - Academic Master Data
src/data/academicMasterData.ts - Campus Geofence Rules
src/data/geofenceData.ts - Storage Service
src/services/storageService.ts - Browser Local Storage
Other components
- Students
- Faculty
- HOD
- Admin
Connections 29
- Students → App Router: use portal
- Faculty → App Router: use portal
- HOD → App Router: use portal
- Admin → App Router: use portal
- App Router → Login Page: renders
src/App.tsx - App Router → Login Modal: renders
src/App.tsx - App Router → Navigation: renders
src/App.tsx - App Router → Student Dashboard: routes to
src/App.tsx - App Router → Faculty Dashboard: routes to
src/App.tsx - App Router → HOD Dashboard: routes to
src/App.tsx - App Router → Admin Dashboard: routes to
src/App.tsx - App Router → Geofence Configuration: renders
src/App.tsx - App Router → Storage Service: reads and writes
src/App.tsx - App Router → Campus Geofence Rules: checks location
src/App.tsx - Student Dashboard → Storage Service: reads and writes
src/components/StudentDashboard.tsx - Faculty Dashboard → Storage Service: reads and writes
src/components/FacultyDashboard.tsx - HOD Dashboard → Storage Service: reads and writes
src/components/HodDashboard.tsx - Admin Dashboard → Storage Service: reads and writes
src/components/AdminDashboard.tsx - Faculty Dashboard → Report Export: opens export
src/components/FacultyDashboard.tsx - HOD Dashboard → Report Export: opens export
src/components/HodDashboard.tsx - Geofence Configuration → Storage Service: updates settings
src/components/GeofenceModal.tsx - Faculty Dashboard → Campus Geofence Rules: checks location
src/components/FacultyDashboard.tsx - Student Dashboard → Campus Geofence Rules: uses geofence
src/components/StudentDashboard.tsx - App Router → Student Records: loads records
src/App.tsx - Storage Service → Academic Master Data: initializes sample data
src/services/storageService.ts - Storage Service → Browser Local Storage: persists records
src/services/storageService.ts - Login Modal → Storage Service: accesses session
src/components/LoginModal.tsx - Login Page → Storage Service: accesses session
src/components/LoginPage.tsx - Report Export → Student Records: uses student records
src/components/ReportsExportModal.tsx