# hakamtechsol/school-attendance-system architecture

> Architecture diagram of the GitHub repository hakamtechsol/school-attendance-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hakamtechsol/school-attendance-system
- Repository: https://github.com/hakamtechsol/school-attendance-system

## Overview

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: [`src/App.jsx`](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/App.jsx) (Role routing), [`src/lib/queries.js`](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/lib/queries.js) (Data query hooks), [`src/pages/staff/StaffPortal.jsx`](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/staff/StaffPortal.jsx) (Check-in portal), [`src/lib/supabase.js`](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/lib/supabase.js) (Supabase client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and identity"]
  node_routing["Role routing<br/>[App.jsx]"]
  node_auth["Session and profile<br/>[AuthContext.jsx]"]
  node_auth_hook["Auth access<br/>[auth.js]"]
  node_guard["Protected routes<br/>[ProtectedRoute.jsx]"]
  node_toast["Toast context<br/>[toast.js]"]
  node_toast_provider["Toast provider<br/>[ToastContext.jsx]"]
end

subgraph group_staff["Staff attendance"]
  node_staff_portal["Check-in portal<br/>[StaffPortal.jsx]"]
  node_staff_history["Attendance history<br/>[StaffHistory.jsx]"]
  node_attendance_actions["Attendance RPC actions"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Live dashboard<br/>[AdminDashboard.jsx]"]
  node_staff_management["Staff management"]
  node_staff_function["Staff provisioning<br/>[index.ts]"]
  node_attendance_admin["Attendance review<br/>[Attendance.jsx]"]
  node_reports["Attendance reports<br/>[Reports.jsx]"]
  node_network["Network controls<br/>[Network.jsx]"]
  node_calendar["School calendar<br/>[SchoolCalendar.jsx]"]
end

subgraph group_data["Data and services"]
  node_ip_hooks["IP restriction logic<br/>[ipHooks.js]"]
  node_queries["Data query hooks<br/>[queries.js]"]
  node_supabase_client["Supabase client<br/>[supabase.js]"]
  node_database[("School data and RPCs<br/>[schema.sql]")]
end

subgraph group_shared["Shared interface"]
  node_shared_components["Shared UI components<br/>[Layout.jsx]"]
  node_feedback["Loading and error states<br/>[Feedback.jsx]"]
  node_button["Buttons<br/>[Button.jsx]"]
  node_inputs["Form inputs<br/>[Input.jsx]"]
  node_badges["Status and stats<br/>[Badge.jsx]"]
  node_modal["Dialog and sheet<br/>[Modal.jsx]"]
  node_format["Date and CSV helpers<br/>[format.js]"]
  node_hooks["Clock and page hooks<br/>[hooks.js]"]
end

node_staff_actor(("Staff"))
node_admin_actor(("Administrator"))

node_staff_actor -->|"opens portal"| node_routing
node_admin_actor -->|"opens portal"| node_routing
node_routing -->|"routes through"| node_guard
node_routing -->|"provides session"| node_auth
node_routing -->|"provides toasts"| node_toast_provider
node_auth -->|"uses client"| node_supabase_client
node_auth -->|"provides context"| node_auth_hook
node_toast_provider -->|"provides context"| node_toast
node_routing -->|"routes to"| node_staff_portal
node_routing -->|"routes to"| node_staff_history
node_routing -->|"routes to"| node_admin_dashboard
node_routing -->|"routes to"| node_staff_management
node_routing -->|"routes to"| node_attendance_admin
node_routing -->|"routes to"| node_reports
node_routing -->|"routes to"| node_network
node_staff_portal -->|"invokes actions"| node_attendance_actions
node_staff_portal -->|"loads attendance"| node_queries
node_staff_portal -->|"checks IP status"| node_ip_hooks
node_staff_history -->|"loads history"| node_queries
node_attendance_actions -->|"calls RPC"| node_supabase_client
node_attendance_actions -->|"reports errors"| node_toast
node_admin_dashboard -->|"loads metrics"| node_queries
node_admin_dashboard -->|"renders calendar"| node_calendar
node_staff_management -->|"loads staff data"| node_queries
node_staff_management -.->|"manages accounts"| node_staff_function
node_attendance_admin -->|"loads attendance"| node_queries
node_reports -->|"loads reports"| node_queries
node_network -->|"manages restrictions"| node_ip_hooks
node_network -->|"uses error mapping"| node_attendance_actions
node_calendar -->|"loads schedules"| node_queries
node_calendar -->|"reads and writes"| node_supabase_client
node_queries -->|"queries data"| node_supabase_client
node_ip_hooks -->|"checks restrictions"| node_supabase_client
node_supabase_client -.->|"accesses backend"| node_database
node_staff_portal -->|"renders layout"| node_shared_components
node_admin_dashboard -->|"renders layout"| node_shared_components
node_attendance_admin -->|"renders layout"| node_shared_components
node_staff_management -->|"uses forms"| node_inputs
node_staff_management -->|"uses dialogs"| node_modal
node_attendance_admin -->|"displays status"| node_badges
node_reports -->|"exports CSV"| node_format
node_staff_portal -->|"tracks current time"| node_hooks

click node_routing "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/App.jsx"
click node_auth "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/context/AuthContext.jsx"
click node_auth_hook "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/context/auth.js"
click node_guard "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/routes/ProtectedRoute.jsx"
click node_staff_portal "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/staff/StaffPortal.jsx"
click node_staff_history "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/staff/StaffHistory.jsx"
click node_attendance_actions "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/lib/attendanceActions.js"
click node_admin_dashboard "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/admin/AdminDashboard.jsx"
click node_staff_management "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/admin/StaffManagement.jsx"
click node_staff_function "https://github.com/hakamtechsol/school-attendance-system/blob/main/supabase/functions/manage-staff/index.ts"
click node_attendance_admin "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/admin/Attendance.jsx"
click node_reports "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/admin/Reports.jsx"
click node_network "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/admin/Network.jsx"
click node_calendar "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/SchoolCalendar.jsx"
click node_ip_hooks "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/lib/ipHooks.js"
click node_queries "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/lib/queries.js"
click node_supabase_client "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/lib/supabase.js"
click node_database "https://github.com/hakamtechsol/school-attendance-system/blob/main/supabase/schema.sql"
click node_shared_components "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Layout.jsx"
click node_feedback "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Feedback.jsx"
click node_button "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Button.jsx"
click node_inputs "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Input.jsx"
click node_badges "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Badge.jsx"
click node_modal "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Modal.jsx"
click node_format "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/utils/format.js"
click node_hooks "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/utils/hooks.js"
click node_toast "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/context/toast.js"
click node_toast_provider "https://github.com/hakamtechsol/school-attendance-system/blob/main/src/context/ToastContext.jsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_routing,node_auth,node_auth_hook,node_guard,node_toast,node_toast_provider toneBlue
class node_staff_portal,node_staff_history,node_attendance_actions toneAmber
class node_admin_dashboard,node_staff_management,node_staff_function,node_attendance_admin,node_reports,node_network,node_calendar toneMint
class node_ip_hooks,node_queries,node_supabase_client,node_database toneRose
class node_shared_components,node_feedback,node_button,node_inputs,node_badges,node_modal,node_format,node_hooks,node_staff_actor,node_admin_actor toneIndigo
```

## Components

### Application and identity

- [Role routing](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/App.jsx): `src/App.jsx`
- [Session and profile](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Auth access](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/context/auth.js): `src/context/auth.js`
- [Protected routes](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/routes/ProtectedRoute.jsx): `src/routes/ProtectedRoute.jsx`
- [Toast context](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/context/toast.js): `src/context/toast.js`
- [Toast provider](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/context/ToastContext.jsx): `src/context/ToastContext.jsx`

### Staff attendance

- [Check-in portal](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/staff/StaffPortal.jsx): `src/pages/staff/StaffPortal.jsx`
- [Attendance history](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/staff/StaffHistory.jsx): `src/pages/staff/StaffHistory.jsx`
- [Attendance RPC actions](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/lib/attendanceActions.js): `src/lib/attendanceActions.js`

### Administration

- [Live dashboard](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/admin/AdminDashboard.jsx): `src/pages/admin/AdminDashboard.jsx`
- [Staff management](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/admin/StaffManagement.jsx): `src/pages/admin/StaffManagement.jsx`
- [Staff provisioning](https://github.com/hakamtechsol/school-attendance-system/blob/main/supabase/functions/manage-staff/index.ts): `supabase/functions/manage-staff/index.ts`
- [Attendance review](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/admin/Attendance.jsx): `src/pages/admin/Attendance.jsx`
- [Attendance reports](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/admin/Reports.jsx): `src/pages/admin/Reports.jsx`
- [Network controls](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/pages/admin/Network.jsx): `src/pages/admin/Network.jsx`
- [School calendar](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/SchoolCalendar.jsx): `src/components/SchoolCalendar.jsx`

### Data and services

- [IP restriction logic](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/lib/ipHooks.js): `src/lib/ipHooks.js`
- [Data query hooks](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/lib/queries.js): `src/lib/queries.js`
- [Supabase client](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/lib/supabase.js): `src/lib/supabase.js`
- [School data and RPCs](https://github.com/hakamtechsol/school-attendance-system/blob/main/supabase/schema.sql): `supabase/schema.sql`

### Shared interface

- [Shared UI components](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Layout.jsx): `src/components/Layout.jsx`
- [Loading and error states](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Feedback.jsx): `src/components/Feedback.jsx`
- [Buttons](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Button.jsx): `src/components/Button.jsx`
- [Form inputs](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Input.jsx): `src/components/Input.jsx`
- [Status and stats](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Badge.jsx): `src/components/Badge.jsx`
- [Dialog and sheet](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/components/Modal.jsx): `src/components/Modal.jsx`
- [Date and CSV helpers](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/utils/format.js): `src/utils/format.js`
- [Clock and page hooks](https://github.com/hakamtechsol/school-attendance-system/blob/main/src/utils/hooks.js): `src/utils/hooks.js`

### Other components

- **Staff**
- **Administrator**

## Connections

- Staff → Role routing: opens portal (evidence: `src/App.jsx`)
- Administrator → Role routing: opens portal (evidence: `src/App.jsx`)
- Role routing → Protected routes: routes through (evidence: `src/App.jsx`)
- Role routing → Session and profile: provides session (evidence: `src/App.jsx`)
- Role routing → Toast provider: provides toasts (evidence: `src/App.jsx`)
- Session and profile → Supabase client: uses client (evidence: `src/context/AuthContext.jsx`)
- Session and profile → Auth access: provides context (evidence: `src/context/AuthContext.jsx`)
- Toast provider → Toast context: provides context (evidence: `src/context/ToastContext.jsx`)
- Role routing → Check-in portal: routes to (evidence: `src/App.jsx`)
- Role routing → Attendance history: routes to (evidence: `src/App.jsx`)
- Role routing → Live dashboard: routes to (evidence: `src/App.jsx`)
- Role routing → Staff management: routes to (evidence: `src/App.jsx`)
- Role routing → Attendance review: routes to (evidence: `src/App.jsx`)
- Role routing → Attendance reports: routes to (evidence: `src/App.jsx`)
- Role routing → Network controls: routes to (evidence: `src/App.jsx`)
- Check-in portal → Attendance RPC actions: invokes actions (evidence: `src/pages/staff/StaffPortal.jsx`)
- Check-in portal → Data query hooks: loads attendance (evidence: `src/pages/staff/StaffPortal.jsx`)
- Check-in portal → IP restriction logic: checks IP status (evidence: `src/pages/staff/StaffPortal.jsx`)
- Attendance history → Data query hooks: loads history (evidence: `src/pages/staff/StaffHistory.jsx`)
- Attendance RPC actions → Supabase client: calls RPC (evidence: `src/lib/attendanceActions.js`)
- Attendance RPC actions → Toast context: reports errors (evidence: `src/lib/attendanceActions.js`)
- Live dashboard → Data query hooks: loads metrics (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Live dashboard → School calendar: renders calendar (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Staff management → Data query hooks: loads staff data (evidence: `src/pages/admin/StaffManagement.jsx`)
- Staff management → Staff provisioning: manages accounts (evidence: `README.md`)
- Attendance review → Data query hooks: loads attendance (evidence: `src/pages/admin/Attendance.jsx`)
- Attendance reports → Data query hooks: loads reports (evidence: `src/pages/admin/Reports.jsx`)
- Network controls → IP restriction logic: manages restrictions (evidence: `src/pages/admin/Network.jsx`)
- Network controls → Attendance RPC actions: uses error mapping (evidence: `src/pages/admin/Network.jsx`)
- School calendar → Data query hooks: loads schedules (evidence: `src/components/SchoolCalendar.jsx`)
- School calendar → Supabase client: reads and writes (evidence: `src/components/SchoolCalendar.jsx`)
- Data query hooks → Supabase client: queries data (evidence: `src/lib/queries.js`)
- IP restriction logic → Supabase client: checks restrictions (evidence: `src/lib/ipHooks.js`)
- Supabase client → School data and RPCs: accesses backend (evidence: `README.md`)
- Check-in portal → Shared UI components: renders layout (evidence: `src/pages/staff/StaffPortal.jsx`)
- Live dashboard → Shared UI components: renders layout (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Attendance review → Shared UI components: renders layout (evidence: `src/pages/admin/Attendance.jsx`)
- Staff management → Form inputs: uses forms (evidence: `src/pages/admin/StaffManagement.jsx`)
- Staff management → Dialog and sheet: uses dialogs (evidence: `src/pages/admin/StaffManagement.jsx`)
- Attendance review → Status and stats: displays status (evidence: `src/pages/admin/Attendance.jsx`)
- Attendance reports → Date and CSV helpers: exports CSV (evidence: `src/pages/admin/Reports.jsx`)
- Check-in portal → Clock and page hooks: tracks current time (evidence: `src/pages/staff/StaffPortal.jsx`)
