How hakamtechsol/school-attendance-system works
This is a multi-tenant school attendance portal. Staff authenticate, view today’s attendance, and check in or out through server-side RPCs; they can also review personal history. Administrators manage staff and network access, monitor attendance, view period-based reports, and configure school calendars. The frontend routes role-protected pages and uses Supabase for authentication and data operations. Edges reflect explicit route wiring, sampled imports/calls, or README-documented behavior; unsampled database and calendar details are represented only where documented.
Main entry points: App.jsx Role routing · queries.js Data query hooks · StaffPortal.jsx Check-in portal · supabase.js Supabase client
Components 30
Application and identity
- Role routing
src/App.jsx - Session and profile
src/context/AuthContext.jsx - Auth access
src/context/auth.js - Protected routes
src/routes/ProtectedRoute.jsx - Toast context
src/context/toast.js - Toast provider
src/context/ToastContext.jsx
Staff attendance
- Check-in portal
src/pages/staff/StaffPortal.jsx - Attendance history
src/pages/staff/StaffHistory.jsx - Attendance RPC actions
src/lib/attendanceActions.js
Administration
- Live dashboard
src/pages/admin/AdminDashboard.jsx - Staff management
src/pages/admin/StaffManagement.jsx - Staff provisioning
supabase/functions/manage-staff/index.ts - Attendance review
src/pages/admin/Attendance.jsx - Attendance reports
src/pages/admin/Reports.jsx - Network controls
src/pages/admin/Network.jsx - School calendar
src/components/SchoolCalendar.jsx
Data and services
- IP restriction logic
src/lib/ipHooks.js - Data query hooks
src/lib/queries.js - Supabase client
src/lib/supabase.js - School data and RPCs
supabase/schema.sql
Shared interface
- Shared UI components
src/components/Layout.jsx - Loading and error states
src/components/Feedback.jsx - Buttons
src/components/Button.jsx - Form inputs
src/components/Input.jsx - Status and stats
src/components/Badge.jsx - Dialog and sheet
src/components/Modal.jsx - Date and CSV helpers
src/utils/format.js - Clock and page hooks
src/utils/hooks.js
Other components
- Staff
- Administrator
Connections 42
- Staff → Role routing: opens portal
src/App.jsx - Administrator → Role routing: opens portal
src/App.jsx - Role routing → Protected routes: routes through
src/App.jsx - Role routing → Session and profile: provides session
src/App.jsx - Role routing → Toast provider: provides toasts
src/App.jsx - Session and profile → Supabase client: uses client
src/context/AuthContext.jsx - Session and profile → Auth access: provides context
src/context/AuthContext.jsx - Toast provider → Toast context: provides context
src/context/ToastContext.jsx - Role routing → Check-in portal: routes to
src/App.jsx - Role routing → Attendance history: routes to
src/App.jsx - Role routing → Live dashboard: routes to
src/App.jsx - Role routing → Staff management: routes to
src/App.jsx - Role routing → Attendance review: routes to
src/App.jsx - Role routing → Attendance reports: routes to
src/App.jsx - Role routing → Network controls: routes to
src/App.jsx - Check-in portal → Attendance RPC actions: invokes actions
src/pages/staff/StaffPortal.jsx - Check-in portal → Data query hooks: loads attendance
src/pages/staff/StaffPortal.jsx - Check-in portal → IP restriction logic: checks IP status
src/pages/staff/StaffPortal.jsx - Attendance history → Data query hooks: loads history
src/pages/staff/StaffHistory.jsx - Attendance RPC actions → Supabase client: calls RPC
src/lib/attendanceActions.js - Attendance RPC actions → Toast context: reports errors
src/lib/attendanceActions.js - Live dashboard → Data query hooks: loads metrics
src/pages/admin/AdminDashboard.jsx - Live dashboard → School calendar: renders calendar
src/pages/admin/AdminDashboard.jsx - Staff management → Data query hooks: loads staff data
src/pages/admin/StaffManagement.jsx - Staff management → Staff provisioning: manages accounts
README.md - Attendance review → Data query hooks: loads attendance
src/pages/admin/Attendance.jsx - Attendance reports → Data query hooks: loads reports
src/pages/admin/Reports.jsx - Network controls → IP restriction logic: manages restrictions
src/pages/admin/Network.jsx - Network controls → Attendance RPC actions: uses error mapping
src/pages/admin/Network.jsx - School calendar → Data query hooks: loads schedules
src/components/SchoolCalendar.jsx - School calendar → Supabase client: reads and writes
src/components/SchoolCalendar.jsx - Data query hooks → Supabase client: queries data
src/lib/queries.js - IP restriction logic → Supabase client: checks restrictions
src/lib/ipHooks.js - Supabase client → School data and RPCs: accesses backend
README.md - Check-in portal → Shared UI components: renders layout
src/pages/staff/StaffPortal.jsx - Live dashboard → Shared UI components: renders layout
src/pages/admin/AdminDashboard.jsx - Attendance review → Shared UI components: renders layout
src/pages/admin/Attendance.jsx - Staff management → Form inputs: uses forms
src/pages/admin/StaffManagement.jsx - Staff management → Dialog and sheet: uses dialogs
src/pages/admin/StaffManagement.jsx - Attendance review → Status and stats: displays status
src/pages/admin/Attendance.jsx - Attendance reports → Date and CSV helpers: exports CSV
src/pages/admin/Reports.jsx - Check-in portal → Clock and page hooks: tracks current time
src/pages/staff/StaffPortal.jsx