# daeviz15/harvesters-attendance architecture

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

- Interactive diagram: https://gitdiagram.com/daeviz15/harvesters-attendance
- Repository: https://github.com/daeviz15/harvesters-attendance

## Overview

This Next.js application supports staff attendance and workforce administration. Staff authenticate, complete onboarding, then use a dashboard for attendance-related activity and leave requests; administrators manage workers, events, live sessions, and reporting, with exports and scheduled email processing as supporting capabilities. The graph reflects relationships shown in excerpts and the SOURCE INDEX; several listed subsystems were not sampled, so their internal flows are left unspecified.

Main entry points: [`utils/supabase/server.ts`](https://github.com/daeviz15/harvesters-attendance/blob/main/utils/supabase/server.ts) (Server Supabase client), [`app/auth/actions.ts`](https://github.com/daeviz15/harvesters-attendance/blob/main/app/auth/actions.ts) (Authentication actions), [`utils/supabase/admin.ts`](https://github.com/daeviz15/harvesters-attendance/blob/main/utils/supabase/admin.ts) (Admin Supabase client), [`app/admin/workers/actions.ts`](https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/workers/actions.ts) (Worker management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_staff["Staff experience"]
  node_staff["Staff dashboard"]
  node_dashdata["Dashboard loader<br/>[page.tsx]"]
  node_leave["Leave requests"]
  node_geo["Location check-in<br/>[useGeolocation.ts]"]
end

subgraph group_identity["Identity and access"]
  node_onboard["Worker onboarding"]
  node_authui["Login and signup<br/>[page.tsx]"]
  node_auth["Authentication actions<br/>[actions.ts]"]
  node_workerids["Worker ID generation<br/>[workerId.ts]"]
  node_rbac["Access control<br/>[rbac.ts]"]
end

subgraph group_admin["Administration"]
  node_adminhome["Admin dashboard"]
  node_workers["Worker management<br/>[actions.ts]"]
  node_events["Event management<br/>[actions.ts]"]
  node_sessions["Live sessions<br/>[actions.ts]"]
  node_reports["Admin reporting<br/>[ReportsClient.tsx]"]
end

subgraph group_support["Notifications and exports"]
  node_attendanceexport["Attendance export<br/>[route.ts]"]
  node_workerexport["Worker export<br/>[route.ts]"]
  node_scheduler["Email scheduler<br/>[route.ts]"]
  node_emailprocessor["Email processing"]
end

subgraph group_platform["Data services"]
  node_browserdb["Browser Supabase client<br/>[client.ts]"]
  node_serverdb["Server Supabase client<br/>[server.ts]"]
  node_admindb["Admin Supabase client<br/>[admin.ts]"]
  node_supabase[("Supabase")]
end

node_staffuser(("Staff member"))
node_adminuser(("Administrator"))

node_staffuser -->|"signs in"| node_authui
node_authui -->|"submits actions"| node_auth
node_auth -->|"authenticates"| node_serverdb
node_staffuser -->|"completes profile"| node_onboard
node_onboard -->|"submits profile"| node_auth
node_auth -->|"generates ID"| node_workerids
node_auth -->|"registers worker"| node_admindb
node_dashdata -->|"loads data"| node_serverdb
node_dashdata -->|"renders dashboard"| node_staff
node_staff -->|"opens request"| node_leave
node_leave -->|"calls actions"| node_dashdata
node_staff -.->|"checks location"| node_geo
node_adminuser -.->|"manages workforce"| node_adminhome
node_adminhome -->|"loads worker data"| node_workers
node_adminhome -->|"loads sessions"| node_sessions
node_workers -->|"queries data"| node_serverdb
node_workers -->|"uses admin access"| node_admindb
node_workers -->|"checks permissions"| node_rbac
node_sessions -->|"queries data"| node_serverdb
node_sessions -->|"uses admin access"| node_admindb
node_sessions -->|"checks permissions"| node_rbac
node_adminuser -.->|"manages events"| node_events
node_adminuser -.->|"views reports"| node_reports
node_attendanceexport -->|"checks access"| node_rbac
node_attendanceexport -->|"queries attendance"| node_serverdb
node_workerexport -->|"checks access"| node_rbac
node_workerexport -->|"queries workers"| node_serverdb
node_workerexport -->|"queries auth data"| node_admindb
node_scheduler -->|"runs processor"| node_emailprocessor
node_auth -->|"uses auth client"| node_serverdb
node_workerids -->|"queries profiles"| node_supabase
node_browserdb -->|"connects browser"| node_supabase
node_serverdb -->|"connects server"| node_supabase
node_admindb -->|"connects admin"| node_supabase

click node_staff "https://github.com/daeviz15/harvesters-attendance/blob/main/app/dashboard/DashboardClient.tsx"
click node_dashdata "https://github.com/daeviz15/harvesters-attendance/blob/main/app/dashboard/page.tsx"
click node_leave "https://github.com/daeviz15/harvesters-attendance/blob/main/components/LeaveRequestModal.tsx"
click node_geo "https://github.com/daeviz15/harvesters-attendance/blob/main/hooks/useGeolocation.ts"
click node_onboard "https://github.com/daeviz15/harvesters-attendance/blob/main/app/onboarding/OnboardingClient.tsx"
click node_authui "https://github.com/daeviz15/harvesters-attendance/blob/main/app/auth/login/page.tsx"
click node_auth "https://github.com/daeviz15/harvesters-attendance/blob/main/app/auth/actions.ts"
click node_workerids "https://github.com/daeviz15/harvesters-attendance/blob/main/lib/workerId.ts"
click node_adminhome "https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/AdminDashboardClient.tsx"
click node_workers "https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/workers/actions.ts"
click node_events "https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/events/actions.ts"
click node_sessions "https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/sessions/actions.ts"
click node_reports "https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/reports/ReportsClient.tsx"
click node_attendanceexport "https://github.com/daeviz15/harvesters-attendance/blob/main/app/api/export/attendance/route.ts"
click node_workerexport "https://github.com/daeviz15/harvesters-attendance/blob/main/app/api/export/workers/route.ts"
click node_scheduler "https://github.com/daeviz15/harvesters-attendance/blob/main/app/api/internal/email-scheduler/route.ts"
click node_emailprocessor "https://github.com/daeviz15/harvesters-attendance/blob/main/lib/email-notification-processor.ts"
click node_rbac "https://github.com/daeviz15/harvesters-attendance/blob/main/lib/rbac.ts"
click node_browserdb "https://github.com/daeviz15/harvesters-attendance/blob/main/utils/supabase/client.ts"
click node_serverdb "https://github.com/daeviz15/harvesters-attendance/blob/main/utils/supabase/server.ts"
click node_admindb "https://github.com/daeviz15/harvesters-attendance/blob/main/utils/supabase/admin.ts"

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_staff,node_dashdata,node_leave,node_geo toneBlue
class node_onboard,node_authui,node_auth,node_workerids,node_rbac toneAmber
class node_adminhome,node_workers,node_events,node_sessions,node_reports toneMint
class node_attendanceexport,node_workerexport,node_scheduler,node_emailprocessor toneRose
class node_browserdb,node_serverdb,node_admindb,node_supabase,node_staffuser,node_adminuser toneIndigo
```

## Components

### Staff experience

- [Staff dashboard](https://github.com/daeviz15/harvesters-attendance/blob/main/app/dashboard/DashboardClient.tsx): `app/dashboard/DashboardClient.tsx`
- [Dashboard loader](https://github.com/daeviz15/harvesters-attendance/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`
- [Leave requests](https://github.com/daeviz15/harvesters-attendance/blob/main/components/LeaveRequestModal.tsx): `components/LeaveRequestModal.tsx`
- [Location check-in](https://github.com/daeviz15/harvesters-attendance/blob/main/hooks/useGeolocation.ts): `hooks/useGeolocation.ts`

### Identity and access

- [Worker onboarding](https://github.com/daeviz15/harvesters-attendance/blob/main/app/onboarding/OnboardingClient.tsx): `app/onboarding/OnboardingClient.tsx`
- [Login and signup](https://github.com/daeviz15/harvesters-attendance/blob/main/app/auth/login/page.tsx): `app/auth/login/page.tsx`
- [Authentication actions](https://github.com/daeviz15/harvesters-attendance/blob/main/app/auth/actions.ts): `app/auth/actions.ts`
- [Worker ID generation](https://github.com/daeviz15/harvesters-attendance/blob/main/lib/workerId.ts): `lib/workerId.ts`
- [Access control](https://github.com/daeviz15/harvesters-attendance/blob/main/lib/rbac.ts): `lib/rbac.ts`

### Administration

- [Admin dashboard](https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/AdminDashboardClient.tsx): `app/admin/AdminDashboardClient.tsx`
- [Worker management](https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/workers/actions.ts): `app/admin/workers/actions.ts`
- [Event management](https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/events/actions.ts): `app/admin/events/actions.ts`
- [Live sessions](https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/sessions/actions.ts): `app/admin/sessions/actions.ts`
- [Admin reporting](https://github.com/daeviz15/harvesters-attendance/blob/main/app/admin/reports/ReportsClient.tsx): `app/admin/reports/ReportsClient.tsx`

### Notifications and exports

- [Attendance export](https://github.com/daeviz15/harvesters-attendance/blob/main/app/api/export/attendance/route.ts): `app/api/export/attendance/route.ts`
- [Worker export](https://github.com/daeviz15/harvesters-attendance/blob/main/app/api/export/workers/route.ts): `app/api/export/workers/route.ts`
- [Email scheduler](https://github.com/daeviz15/harvesters-attendance/blob/main/app/api/internal/email-scheduler/route.ts): `app/api/internal/email-scheduler/route.ts`
- [Email processing](https://github.com/daeviz15/harvesters-attendance/blob/main/lib/email-notification-processor.ts): `lib/email-notification-processor.ts`

### Data services

- [Browser Supabase client](https://github.com/daeviz15/harvesters-attendance/blob/main/utils/supabase/client.ts): `utils/supabase/client.ts`
- [Server Supabase client](https://github.com/daeviz15/harvesters-attendance/blob/main/utils/supabase/server.ts): `utils/supabase/server.ts`
- [Admin Supabase client](https://github.com/daeviz15/harvesters-attendance/blob/main/utils/supabase/admin.ts): `utils/supabase/admin.ts`
- **Supabase**

### Other components

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

## Connections

- Staff member → Login and signup: signs in (evidence: `app/auth/login/page.tsx`)
- Login and signup → Authentication actions: submits actions (evidence: `app/auth/login/page.tsx`)
- Authentication actions → Server Supabase client: authenticates (evidence: `app/auth/actions.ts`)
- Staff member → Worker onboarding: completes profile
- Worker onboarding → Authentication actions: submits profile (evidence: `app/onboarding/OnboardingClient.tsx`)
- Authentication actions → Worker ID generation: generates ID (evidence: `app/auth/actions.ts`)
- Authentication actions → Admin Supabase client: registers worker (evidence: `app/auth/actions.ts`)
- Dashboard loader → Server Supabase client: loads data (evidence: `app/dashboard/page.tsx`)
- Dashboard loader → Staff dashboard: renders dashboard (evidence: `app/dashboard/page.tsx`)
- Staff dashboard → Leave requests: opens request (evidence: `app/dashboard/DashboardClient.tsx`)
- Leave requests → Dashboard loader: calls actions (evidence: `components/LeaveRequestModal.tsx`)
- Staff dashboard → Location check-in: checks location (evidence: `app/dashboard/DashboardClient.tsx`)
- Administrator → Admin dashboard: manages workforce
- Admin dashboard → Worker management: loads worker data (evidence: `app/admin/AdminDashboardClient.tsx`)
- Admin dashboard → Live sessions: loads sessions (evidence: `app/admin/AdminDashboardClient.tsx`)
- Worker management → Server Supabase client: queries data (evidence: `app/admin/workers/actions.ts`)
- Worker management → Admin Supabase client: uses admin access (evidence: `app/admin/workers/actions.ts`)
- Worker management → Access control: checks permissions (evidence: `app/admin/workers/actions.ts`)
- Live sessions → Server Supabase client: queries data (evidence: `app/admin/sessions/actions.ts`)
- Live sessions → Admin Supabase client: uses admin access (evidence: `app/admin/sessions/actions.ts`)
- Live sessions → Access control: checks permissions (evidence: `app/admin/sessions/actions.ts`)
- Administrator → Event management: manages events
- Administrator → Admin reporting: views reports
- Attendance export → Access control: checks access (evidence: `app/api/export/attendance/route.ts`)
- Attendance export → Server Supabase client: queries attendance (evidence: `app/api/export/attendance/route.ts`)
- Worker export → Access control: checks access (evidence: `app/api/export/workers/route.ts`)
- Worker export → Server Supabase client: queries workers (evidence: `app/api/export/workers/route.ts`)
- Worker export → Admin Supabase client: queries auth data (evidence: `app/api/export/workers/route.ts`)
- Email scheduler → Email processing: runs processor (evidence: `app/api/internal/email-scheduler/route.ts`)
- Authentication actions → Server Supabase client: uses auth client (evidence: `app/auth/actions.ts`)
- Worker ID generation → Supabase: queries profiles (evidence: `lib/workerId.ts`)
- Browser Supabase client → Supabase: connects browser (evidence: `utils/supabase/client.ts`)
- Server Supabase client → Supabase: connects server (evidence: `utils/supabase/server.ts`)
- Admin Supabase client → Supabase: connects admin (evidence: `utils/supabase/admin.ts`)
