# henryharborne/emporium-rewards--frontend architecture

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

- Interactive diagram: https://gitdiagram.com/henryharborne/emporium-rewards--frontend
- Repository: https://github.com/henryharborne/emporium-rewards--frontend

## Overview

Emporium Rewards is a customer loyalty frontend: customers look up points by phone, while admins log in, manage customer records and point balances, review/undo logs, and export customer data. The graph follows the shown routing and API calls; the backend is represented only as an external service because its implementation is outside this repository. AdminLogs, ManageCustomers and Supabase helper behavior are represented from the README/tree where excerpts are limited.

Main entry points: [`src/pages/Dashboard.tsx`](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/pages/Dashboard.tsx) (Admin dashboard), [`src/store/useUserStore.ts`](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/store/useUserStore.ts) (Admin session), [`src/pages/Home.tsx`](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/pages/Home.tsx) (Rewards home), [`src/components/AdminLoginModal.tsx`](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/AdminLoginModal.tsx) (Admin login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Customer lookup"]
  node_home["Rewards home<br/>[Home.tsx]"]
  node_lookup["Phone lookup"]
end

subgraph group_admin_access["Admin access"]
  node_login["Admin login"]
  node_dashboard["Admin dashboard<br/>[Dashboard.tsx]"]
  node_supabase["Supabase client helper<br/>[supabase.ts]"]
end

subgraph group_admin_ops["Customer operations"]
  node_search["Customer search and edit"]
  node_manage["Customer add/delete"]
  node_logs["Admin logs<br/>[AdminLogs.tsx]"]
end

subgraph group_app_state["App navigation and state"]
  node_app["Routes<br/>[App.tsx]"]
  node_session[("Admin session<br/>[useUserStore.ts]")]
end

node_customer(("Customer"))
node_admin(("Administrator"))
node_backend{{"Rewards backend API"}}

node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_dashboard
node_home -->|"renders"| node_lookup
node_home -->|"opens"| node_login
node_home -->|"reads"| node_session
node_customer -.->|"enters phone"| node_lookup
node_lookup -->|"requests points"| node_backend
node_backend -->|"returns balance"| node_lookup
node_admin -.->|"submits credentials"| node_login
node_login -->|"requests login"| node_backend
node_login -->|"stores token"| node_session
node_dashboard -->|"validates token"| node_backend
node_dashboard -->|"reads and updates"| node_session
node_dashboard -->|"renders"| node_search
node_dashboard -->|"renders"| node_manage
node_dashboard -->|"renders"| node_logs
node_search -->|"reads token"| node_session
node_search -->|"searches and updates"| node_backend
node_manage -->|"reads token"| node_session
node_manage -->|"adds and deletes"| node_backend
node_logs -->|"reads token"| node_session
node_logs -->|"fetches and undoes"| node_backend
node_dashboard -->|"exports CSV"| node_backend
node_dashboard -->|"pings service"| node_backend

click node_app "https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/App.tsx"
click node_home "https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/pages/Home.tsx"
click node_lookup "https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/PhoneLookupForm.tsx"
click node_login "https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/AdminLoginModal.tsx"
click node_session "https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/store/useUserStore.ts"
click node_dashboard "https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/pages/Dashboard.tsx"
click node_search "https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/SearchCustomers.tsx"
click node_manage "https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/ManageCustomers.tsx"
click node_logs "https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/AdminLogs.tsx"
click node_supabase "https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/api/supabase.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_home,node_lookup toneBlue
class node_login,node_dashboard,node_supabase toneAmber
class node_search,node_manage,node_logs,node_backend toneMint
class node_app,node_session toneRose
class node_customer,node_admin toneIndigo
```

## Components

### Customer lookup

- [Rewards home](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Phone lookup](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/PhoneLookupForm.tsx): `src/components/PhoneLookupForm.tsx`

### Admin access

- [Admin login](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/AdminLoginModal.tsx): `src/components/AdminLoginModal.tsx`
- [Admin dashboard](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Supabase client helper](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/api/supabase.ts): `src/api/supabase.ts`

### Customer operations

- [Customer search and edit](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/SearchCustomers.tsx): `src/components/SearchCustomers.tsx`
- [Customer add/delete](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/ManageCustomers.tsx): `src/components/ManageCustomers.tsx`
- [Admin logs](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/components/AdminLogs.tsx): `src/components/AdminLogs.tsx`

### App navigation and state

- [Routes](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/App.tsx): `src/App.tsx`
- [Admin session](https://github.com/henryharborne/emporium-rewards--frontend/blob/main/src/store/useUserStore.ts): `src/store/useUserStore.ts`

### Other components

- **Customer**
- **Administrator**
- **Rewards backend API**

## Connections

- Routes → Rewards home: routes to (evidence: `src/App.tsx`)
- Routes → Admin dashboard: routes to (evidence: `src/App.tsx`)
- Rewards home → Phone lookup: renders (evidence: `src/pages/Home.tsx`)
- Rewards home → Admin login: opens (evidence: `src/pages/Home.tsx`)
- Rewards home → Admin session: reads (evidence: `src/pages/Home.tsx`)
- Customer → Phone lookup: enters phone
- Phone lookup → Rewards backend API: requests points (evidence: `src/components/PhoneLookupForm.tsx`)
- Rewards backend API → Phone lookup: returns balance (evidence: `src/components/PhoneLookupForm.tsx`)
- Administrator → Admin login: submits credentials
- Admin login → Rewards backend API: requests login (evidence: `src/components/AdminLoginModal.tsx`)
- Admin login → Admin session: stores token (evidence: `src/components/AdminLoginModal.tsx`)
- Admin dashboard → Rewards backend API: validates token (evidence: `src/pages/Dashboard.tsx`)
- Admin dashboard → Admin session: reads and updates (evidence: `src/pages/Dashboard.tsx`)
- Admin dashboard → Customer search and edit: renders (evidence: `src/pages/Dashboard.tsx`)
- Admin dashboard → Customer add/delete: renders (evidence: `src/pages/Dashboard.tsx`)
- Admin dashboard → Admin logs: renders (evidence: `src/pages/Dashboard.tsx`)
- Customer search and edit → Admin session: reads token (evidence: `src/components/SearchCustomers.tsx`)
- Customer search and edit → Rewards backend API: searches and updates (evidence: `src/components/SearchCustomers.tsx`)
- Customer add/delete → Admin session: reads token (evidence: `src/components/ManageCustomers.tsx`)
- Customer add/delete → Rewards backend API: adds and deletes (evidence: `src/components/ManageCustomers.tsx`)
- Admin logs → Admin session: reads token (evidence: `src/components/AdminLogs.tsx`)
- Admin logs → Rewards backend API: fetches and undoes (evidence: `src/components/AdminLogs.tsx`)
- Admin dashboard → Rewards backend API: exports CSV (evidence: `src/pages/Dashboard.tsx`)
- Admin dashboard → Rewards backend API: pings service (evidence: `src/pages/Dashboard.tsx`)
