# sugan-2007/horizon architecture

> Architecture diagram of the GitHub repository sugan-2007/horizon, 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/sugan-2007/horizon
- Repository: https://github.com/sugan-2007/horizon

## Overview

Horizon is a fashion e-commerce storefront with customer shopping, cart and checkout, account/order experiences, and admin product, order, discount, review, and statistics tools. The customer flow runs from routed storefront pages through product browsing and cart state to checkout/order placement; authentication and notifications support that journey. Backend routes expose cart, product, order, review, and auth APIs backed by Supabase, while email and newsletter submissions use external services. Several route and admin details are indexed but not excerpted, so those capabilities are represented at their supported directory level and uncertain connections are omitted.

Main entry points: [`backend/server.js`](https://github.com/sugan-2007/horizon/blob/main/backend/server.js) (API server), [`frontend/src/App.jsx`](https://github.com/sugan-2007/horizon/blob/main/frontend/src/App.jsx) (Route shell), [`frontend/src/context/UserContext.jsx`](https://github.com/sugan-2007/horizon/blob/main/frontend/src/context/UserContext.jsx) (Identity context), [`backend/supabaseClient.js`](https://github.com/sugan-2007/horizon/blob/main/backend/supabaseClient.js) (Supabase data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["Route shell<br/>[App.jsx]"]
  node_catalog["Catalog views<br/>[Shop.jsx]"]
  node_product["Product details<br/>[Description.jsx]"]
  node_navigation["Navigation overlays<br/>[Nav.jsx]"]
  node_footer["Newsletter footer<br/>[Footer.jsx]"]
end

subgraph group_customer["Customer flows"]
  node_login["Login UI<br/>[Login.jsx]"]
  node_identity["Identity context<br/>[UserContext.jsx]"]
  node_cartstate["Cart state<br/>[CartContext.jsx]"]
  node_cartui["Cart sidebar<br/>[CartSidebar.jsx]"]
  node_checkout["Checkout<br/>[Checkout.jsx]"]
  node_profile["Profile<br/>[Profile.jsx]"]
  node_notifications["Order notifications"]
  node_tracker["Order tracker<br/>[OrderTracker.jsx]"]
end

subgraph group_backend["API backend"]
  node_server["API server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[auth.js]"]
  node_productroutes["Product routes<br/>[products.js]"]
  node_cartroutes["Cart routes<br/>[cart.js]"]
  node_orderroutes["Order routes<br/>[orders.js]"]
  node_reviewroutes["Review routes<br/>[reviews.js]"]
  node_authguard["User/admin guard<br/>[verifyuser.js]"]
end

subgraph group_admin["Admin operations"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_adminfeatures["Admin management"]
end

subgraph group_services["Data and integrations"]
  node_db[("Supabase data<br/>[supabaseClient.js]")]
  node_webclient["Supabase client<br/>[supabase.js]"]
  node_mailer["Email sender<br/>[mailer.js]"]
  node_brevo{{"Brevo email API"}}
  node_newsletter{{"Web3Forms"}}
end

node_shopper(("Shopper"))

node_shopper -->|"opens storefront"| node_app
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_product
node_app -->|"routes to"| node_adminui
node_app -->|"reads identity"| node_identity
node_navigation -->|"renders"| node_login
node_navigation -->|"renders"| node_cartui
node_navigation -->|"renders"| node_tracker
node_navigation -->|"reads counts"| node_notifications
node_login -->|"uses auth"| node_identity
node_identity -->|"auth and profile"| node_webclient
node_cartstate -->|"reads user"| node_identity
node_cartstate -->|"reads and writes"| node_webclient
node_checkout -->|"places order"| node_cartstate
node_product -->|"adds products"| node_cartstate
node_notifications -->|"reads orders"| node_webclient
node_tracker -->|"uses user"| node_identity
node_server -->|"mounts routes"| node_cartroutes
node_server -->|"mounts routes"| node_productroutes
node_server -->|"mounts routes"| node_orderroutes
node_server -->|"mounts routes"| node_reviewroutes
node_server -->|"mounts routes"| node_authroutes
node_cartroutes -->|"guards requests"| node_authguard
node_orderroutes -->|"guards requests"| node_authguard
node_reviewroutes -->|"guards requests"| node_authguard
node_authguard -->|"creates client"| node_db
node_cartroutes -->|"queries data"| node_db
node_orderroutes -->|"queries data"| node_db
node_productroutes -->|"queries data"| node_db
node_reviewroutes -->|"queries data"| node_db
node_orderroutes -->|"sends order mail"| node_mailer
node_productroutes -->|"sends product mail"| node_mailer
node_mailer -->|"posts email"| node_brevo
node_adminui -->|"loads admin areas"| node_adminfeatures
node_footer -->|"submits signup"| node_newsletter

click node_app "https://github.com/sugan-2007/horizon/blob/main/frontend/src/App.jsx"
click node_catalog "https://github.com/sugan-2007/horizon/blob/main/frontend/src/Pages/Shop.jsx"
click node_product "https://github.com/sugan-2007/horizon/blob/main/frontend/src/Pages/Description.jsx"
click node_navigation "https://github.com/sugan-2007/horizon/blob/main/frontend/src/Components/Nav.jsx"
click node_login "https://github.com/sugan-2007/horizon/blob/main/frontend/src/Components/Login.jsx"
click node_identity "https://github.com/sugan-2007/horizon/blob/main/frontend/src/context/UserContext.jsx"
click node_cartstate "https://github.com/sugan-2007/horizon/blob/main/frontend/src/context/CartContext.jsx"
click node_cartui "https://github.com/sugan-2007/horizon/blob/main/frontend/src/Components/CartSidebar.jsx"
click node_checkout "https://github.com/sugan-2007/horizon/blob/main/frontend/src/Pages/Checkout.jsx"
click node_profile "https://github.com/sugan-2007/horizon/blob/main/frontend/src/Pages/Profile.jsx"
click node_notifications "https://github.com/sugan-2007/horizon/blob/main/frontend/src/context/NotificationContext.jsx"
click node_tracker "https://github.com/sugan-2007/horizon/blob/main/frontend/src/Components/OrderTracker.jsx"
click node_server "https://github.com/sugan-2007/horizon/blob/main/backend/server.js"
click node_authroutes "https://github.com/sugan-2007/horizon/blob/main/backend/routes/auth.js"
click node_productroutes "https://github.com/sugan-2007/horizon/blob/main/backend/routes/products.js"
click node_cartroutes "https://github.com/sugan-2007/horizon/blob/main/backend/routes/cart.js"
click node_orderroutes "https://github.com/sugan-2007/horizon/blob/main/backend/routes/orders.js"
click node_reviewroutes "https://github.com/sugan-2007/horizon/blob/main/backend/routes/reviews.js"
click node_adminui "https://github.com/sugan-2007/horizon/blob/main/frontend/src/Pages/Admin/AdminDashboard.jsx"
click node_adminfeatures "https://github.com/sugan-2007/horizon/tree/main/frontend/src/Pages/Admin"
click node_authguard "https://github.com/sugan-2007/horizon/blob/main/backend/middleware/verifyuser.js"
click node_db "https://github.com/sugan-2007/horizon/blob/main/backend/supabaseClient.js"
click node_webclient "https://github.com/sugan-2007/horizon/blob/main/frontend/src/lib/supabase.js"
click node_mailer "https://github.com/sugan-2007/horizon/blob/main/backend/utils/mailer.js"
click node_footer "https://github.com/sugan-2007/horizon/blob/main/frontend/src/Components/Footer.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_app,node_catalog,node_product,node_navigation,node_footer toneBlue
class node_login,node_identity,node_cartstate,node_cartui,node_checkout,node_profile,node_notifications,node_tracker toneAmber
class node_server,node_authroutes,node_productroutes,node_cartroutes,node_orderroutes,node_reviewroutes,node_authguard toneMint
class node_adminui,node_adminfeatures toneRose
class node_db,node_webclient,node_mailer,node_brevo,node_newsletter,node_shopper toneIndigo
```

## Components

### Storefront

- [Route shell](https://github.com/sugan-2007/horizon/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Catalog views](https://github.com/sugan-2007/horizon/blob/main/frontend/src/Pages/Shop.jsx): `frontend/src/Pages/Shop.jsx`
- [Product details](https://github.com/sugan-2007/horizon/blob/main/frontend/src/Pages/Description.jsx): `frontend/src/Pages/Description.jsx`
- [Navigation overlays](https://github.com/sugan-2007/horizon/blob/main/frontend/src/Components/Nav.jsx): `frontend/src/Components/Nav.jsx`
- [Newsletter footer](https://github.com/sugan-2007/horizon/blob/main/frontend/src/Components/Footer.jsx): `frontend/src/Components/Footer.jsx`

### Customer flows

- [Login UI](https://github.com/sugan-2007/horizon/blob/main/frontend/src/Components/Login.jsx): `frontend/src/Components/Login.jsx`
- [Identity context](https://github.com/sugan-2007/horizon/blob/main/frontend/src/context/UserContext.jsx): `frontend/src/context/UserContext.jsx`
- [Cart state](https://github.com/sugan-2007/horizon/blob/main/frontend/src/context/CartContext.jsx): `frontend/src/context/CartContext.jsx`
- [Cart sidebar](https://github.com/sugan-2007/horizon/blob/main/frontend/src/Components/CartSidebar.jsx): `frontend/src/Components/CartSidebar.jsx`
- [Checkout](https://github.com/sugan-2007/horizon/blob/main/frontend/src/Pages/Checkout.jsx): `frontend/src/Pages/Checkout.jsx`
- [Profile](https://github.com/sugan-2007/horizon/blob/main/frontend/src/Pages/Profile.jsx): `frontend/src/Pages/Profile.jsx`
- [Order notifications](https://github.com/sugan-2007/horizon/blob/main/frontend/src/context/NotificationContext.jsx): `frontend/src/context/NotificationContext.jsx`
- [Order tracker](https://github.com/sugan-2007/horizon/blob/main/frontend/src/Components/OrderTracker.jsx): `frontend/src/Components/OrderTracker.jsx`

### API backend

- [API server](https://github.com/sugan-2007/horizon/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/sugan-2007/horizon/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Product routes](https://github.com/sugan-2007/horizon/blob/main/backend/routes/products.js): `backend/routes/products.js`
- [Cart routes](https://github.com/sugan-2007/horizon/blob/main/backend/routes/cart.js): `backend/routes/cart.js`
- [Order routes](https://github.com/sugan-2007/horizon/blob/main/backend/routes/orders.js): `backend/routes/orders.js`
- [Review routes](https://github.com/sugan-2007/horizon/blob/main/backend/routes/reviews.js): `backend/routes/reviews.js`
- [User/admin guard](https://github.com/sugan-2007/horizon/blob/main/backend/middleware/verifyuser.js): `backend/middleware/verifyuser.js`

### Admin operations

- [Admin dashboard](https://github.com/sugan-2007/horizon/blob/main/frontend/src/Pages/Admin/AdminDashboard.jsx): `frontend/src/Pages/Admin/AdminDashboard.jsx`
- [Admin management](https://github.com/sugan-2007/horizon/tree/main/frontend/src/Pages/Admin): `frontend/src/Pages/Admin`

### Data and integrations

- [Supabase data](https://github.com/sugan-2007/horizon/blob/main/backend/supabaseClient.js): `backend/supabaseClient.js`
- [Supabase client](https://github.com/sugan-2007/horizon/blob/main/frontend/src/lib/supabase.js): `frontend/src/lib/supabase.js`
- [Email sender](https://github.com/sugan-2007/horizon/blob/main/backend/utils/mailer.js): `backend/utils/mailer.js`
- **Brevo email API**
- **Web3Forms**

### Other components

- **Shopper**

## Connections

- Shopper → Route shell: opens storefront (evidence: `frontend/src/App.jsx`)
- Route shell → Catalog views: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Product details: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Identity context: reads identity (evidence: `frontend/src/App.jsx`)
- Navigation overlays → Login UI: renders (evidence: `frontend/src/Components/Nav.jsx`)
- Navigation overlays → Cart sidebar: renders (evidence: `frontend/src/Components/Nav.jsx`)
- Navigation overlays → Order tracker: renders (evidence: `frontend/src/Components/Nav.jsx`)
- Navigation overlays → Order notifications: reads counts (evidence: `frontend/src/Components/Nav.jsx`)
- Login UI → Identity context: uses auth (evidence: `frontend/src/Components/Login.jsx`)
- Identity context → Supabase client: auth and profile (evidence: `frontend/src/context/UserContext.jsx`)
- Cart state → Identity context: reads user (evidence: `frontend/src/context/CartContext.jsx`)
- Cart state → Supabase client: reads and writes (evidence: `frontend/src/context/CartContext.jsx`)
- Checkout → Cart state: places order (evidence: `frontend/src/Pages/Checkout.jsx`)
- Product details → Cart state: adds products (evidence: `frontend/src/Pages/Description.jsx`)
- Order notifications → Supabase client: reads orders (evidence: `frontend/src/context/NotificationContext.jsx`)
- Order tracker → Identity context: uses user (evidence: `frontend/src/Components/OrderTracker.jsx`)
- API server → Cart routes: mounts routes (evidence: `backend/server.js`)
- API server → Product routes: mounts routes (evidence: `backend/server.js`)
- API server → Order routes: mounts routes (evidence: `backend/server.js`)
- API server → Review routes: mounts routes (evidence: `backend/server.js`)
- API server → Auth routes: mounts routes (evidence: `backend/server.js`)
- Cart routes → User/admin guard: guards requests (evidence: `backend/routes/cart.js`)
- Order routes → User/admin guard: guards requests (evidence: `backend/routes/orders.js`)
- Review routes → User/admin guard: guards requests (evidence: `backend/routes/reviews.js`)
- User/admin guard → Supabase data: creates client (evidence: `backend/middleware/verifyuser.js`)
- Cart routes → Supabase data: queries data (evidence: `backend/routes/cart.js`)
- Order routes → Supabase data: queries data (evidence: `backend/routes/orders.js`)
- Product routes → Supabase data: queries data (evidence: `backend/routes/products.js`)
- Review routes → Supabase data: queries data (evidence: `backend/routes/reviews.js`)
- Order routes → Email sender: sends order mail (evidence: `backend/routes/orders.js`)
- Product routes → Email sender: sends product mail (evidence: `backend/routes/products.js`)
- Email sender → Brevo email API: posts email (evidence: `backend/utils/mailer.js`)
- Admin dashboard → Admin management: loads admin areas (evidence: `frontend/src/Pages/Admin/AdminDashboard.jsx`)
- Newsletter footer → Web3Forms: submits signup (evidence: `frontend/src/Components/Footer.jsx`)
