# henryharborne/emporium-rewards--backend architecture

> Architecture diagram of the GitHub repository henryharborne/emporium-rewards--backend, 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--backend
- Repository: https://github.com/henryharborne/emporium-rewards--backend

## Overview

Emporium Rewards is a REST backend for a customer loyalty program. Admins authenticate with credentials to receive a JWT, then use protected endpoints to find and manage customers, adjust points, export customer data, and review or undo point changes. A public customer lookup is separately rate-limited. The route handlers access Supabase directly, while customer changes that are logged call a helper that records audit details. The excerpts show the API wiring and these route-level operations; database policies and some deployment details are documented but not implemented in the sampled source.

Main entry points: [`src/routes/customerRoutes.js`](https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/routes/customerRoutes.js) (Customer endpoints), [`src/database/supabaseClient.js`](https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/database/supabaseClient.js) (Supabase client), [`index.js`](https://github.com/henryharborne/emporium-rewards--backend/blob/main/index.js) (Express API), [`src/routes/adminRoutes.js`](https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/routes/adminRoutes.js) (Admin endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API entry"]
  node_entry["Express API<br/>[index.js]"]
end

subgraph group_customers["Customer operations"]
  node_customer_routes["Customer endpoints<br/>[customerRoutes.js]"]
  node_lookup["Customer lookup"]
end

subgraph group_admin["Admin and security"]
  node_customer_access["Customer access<br/>[verifyToken.js]"]
  node_rate_limits["Rate limits<br/>[rateLimits.js]"]
  node_admin_routes["Admin endpoints<br/>[adminRoutes.js]"]
end

subgraph group_data["Persistence and audit"]
  node_supabase_client["Supabase client<br/>[supabaseClient.js]"]
  node_supabase[("Supabase database")]
  node_audit_helper["Audit logger<br/>[logAdminAction.js]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_entry
node_entry -->|"mounts routes"| node_customer_routes
node_entry -->|"mounts routes"| node_admin_routes
node_customer_routes -->|"dispatches lookup"| node_lookup
node_customer_routes -->|"protects endpoints"| node_customer_access
node_customer_routes -->|"limits lookup"| node_rate_limits
node_customer_routes -->|"queries customers"| node_supabase_client
node_lookup -->|"queries customer"| node_supabase_client
node_admin_routes -->|"limits login"| node_rate_limits
node_admin_routes -->|"queries admin data"| node_supabase_client
node_customer_routes -->|"records changes"| node_audit_helper
node_audit_helper -->|"writes audit data"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase

click node_entry "https://github.com/henryharborne/emporium-rewards--backend/blob/main/index.js"
click node_customer_routes "https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/routes/customerRoutes.js"
click node_lookup "https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/controllers/customerController.js"
click node_customer_access "https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/middleware/verifyToken.js"
click node_rate_limits "https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/middleware/rateLimits.js"
click node_admin_routes "https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/routes/adminRoutes.js"
click node_supabase_client "https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/database/supabaseClient.js"
click node_audit_helper "https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/utils/logAdminAction.js"

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_entry,node_client toneBlue
class node_customer_routes,node_lookup toneAmber
class node_customer_access,node_rate_limits,node_admin_routes toneMint
class node_supabase_client,node_supabase,node_audit_helper toneRose
```

## Components

### API entry

- [Express API](https://github.com/henryharborne/emporium-rewards--backend/blob/main/index.js): `index.js`

### Customer operations

- [Customer endpoints](https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/routes/customerRoutes.js): `src/routes/customerRoutes.js`
- [Customer lookup](https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/controllers/customerController.js): `src/controllers/customerController.js`

### Admin and security

- [Customer access](https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/middleware/verifyToken.js): `src/middleware/verifyToken.js`
- [Rate limits](https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/middleware/rateLimits.js): `src/middleware/rateLimits.js`
- [Admin endpoints](https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/routes/adminRoutes.js): `src/routes/adminRoutes.js`

### Persistence and audit

- [Supabase client](https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/database/supabaseClient.js): `src/database/supabaseClient.js`
- **Supabase database**
- [Audit logger](https://github.com/henryharborne/emporium-rewards--backend/blob/main/src/utils/logAdminAction.js): `src/utils/logAdminAction.js`

### Other components

- **API client**

## Connections

- API client → Express API: sends requests (evidence: `index.js`)
- Express API → Customer endpoints: mounts routes (evidence: `index.js`)
- Express API → Admin endpoints: mounts routes (evidence: `index.js`)
- Customer endpoints → Customer lookup: dispatches lookup (evidence: `src/routes/customerRoutes.js`)
- Customer endpoints → Customer access: protects endpoints (evidence: `src/routes/customerRoutes.js`)
- Customer endpoints → Rate limits: limits lookup (evidence: `src/routes/customerRoutes.js`)
- Customer endpoints → Supabase client: queries customers (evidence: `src/routes/customerRoutes.js`)
- Customer lookup → Supabase client: queries customer (evidence: `src/controllers/customerController.js`)
- Admin endpoints → Rate limits: limits login (evidence: `src/routes/adminRoutes.js`)
- Admin endpoints → Supabase client: queries admin data (evidence: `src/routes/adminRoutes.js`)
- Customer endpoints → Audit logger: records changes (evidence: `src/routes/customerRoutes.js`)
- Audit logger → Supabase client: writes audit data (evidence: `src/utils/logAdminAction.js`)
- Supabase client → Supabase database: connects to (evidence: `src/database/supabaseClient.js`)
