# desaipraniket-web/spices architecture

> Architecture diagram of the GitHub repository desaipraniket-web/spices, 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/desaipraniket-web/spices
- Repository: https://github.com/desaipraniket-web/spices

## Overview

SPICES is a spice storefront with a small Node HTTP backend. The customer workflow spans browsing catalog content, managing a cart, authenticating or checking out, and submitting an order; the backend validates delivery details, calculates totals, and persists orders. Separate admin routes support sign-in and management of orders, users, and storefront content. The README is only a title, and browser-side files were not sampled, so their detailed behavior and API wiring are not asserted.

Main entry points: [`server.js`](https://github.com/desaipraniket-web/spices/blob/master/server.js) (API routes), [`pages/shop.html`](https://github.com/desaipraniket-web/spices/blob/master/pages/shop.html) (Catalog pages), [`pages/product.html`](https://github.com/desaipraniket-web/spices/blob/master/pages/product.html) (Product page), [`pages/cart.html`](https://github.com/desaipraniket-web/spices/blob/master/pages/cart.html) (Cart page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_catalog_pages["Catalog pages<br/>[shop.html]"]
  node_product_page["Product page<br/>[product.html]"]
  node_cart_page["Cart page<br/>[cart.html]"]
  node_checkout_page["Checkout page<br/>[checkout.html]"]
  node_auth_pages["Account access<br/>[auth.html]"]
  node_content_data[("Store content<br/>[data.js]")]
  node_blog_pages["Blog pages<br/>[blogs.html]"]
  node_search_page["Search page<br/>[search.html]"]
  node_category_page["Category page<br/>[category.html]"]
  node_detail_page["Blog detail<br/>[blog-detail.html]"]
  node_contact_page["Contact page<br/>[contact.html]"]
end

subgraph group_backend["Backend"]
  node_http_server["HTTP server<br/>[server.js]"]
  node_api_routes["API routes<br/>[server.js]"]
  node_auth_logic["User authentication<br/>[server.js]"]
  node_order_logic["Order processing<br/>[server.js]"]
  node_json_store[("JSON database<br/>[server.js]")]
end

subgraph group_admin["Administration"]
  node_admin_pages["Admin interface<br/>[admin.html]"]
  node_admin_routes["Admin management<br/>[server.js]"]
end

node_customer(("Customer"))

node_customer -.->|"browses"| node_catalog_pages
node_customer -.->|"views products"| node_product_page
node_customer -.->|"manages cart"| node_cart_page
node_customer -.->|"submits checkout"| node_checkout_page
node_customer -.->|"signs in"| node_auth_pages
node_customer -.->|"reads blogs"| node_blog_pages
node_customer -.->|"searches"| node_search_page
node_customer -.->|"browses category"| node_category_page
node_customer -.->|"reads article"| node_detail_page
node_customer -.->|"contacts"| node_contact_page
node_http_server -->|"dispatches API"| node_api_routes
node_http_server -->|"serves static"| node_catalog_pages
node_api_routes -->|"routes auth"| node_auth_logic
node_api_routes -->|"routes orders"| node_order_logic
node_api_routes -->|"routes admin"| node_admin_routes
node_auth_logic -->|"reads and writes"| node_json_store
node_order_logic -->|"reads and writes"| node_json_store
node_admin_routes -->|"reads and writes"| node_json_store
node_api_routes -->|"loads defaults"| node_content_data

click node_catalog_pages "https://github.com/desaipraniket-web/spices/blob/master/pages/shop.html"
click node_product_page "https://github.com/desaipraniket-web/spices/blob/master/pages/product.html"
click node_cart_page "https://github.com/desaipraniket-web/spices/blob/master/pages/cart.html"
click node_checkout_page "https://github.com/desaipraniket-web/spices/blob/master/pages/checkout.html"
click node_auth_pages "https://github.com/desaipraniket-web/spices/blob/master/pages/auth.html"
click node_content_data "https://github.com/desaipraniket-web/spices/blob/master/assets/js/data.js"
click node_http_server "https://github.com/desaipraniket-web/spices/blob/master/server.js"
click node_api_routes "https://github.com/desaipraniket-web/spices/blob/master/server.js"
click node_auth_logic "https://github.com/desaipraniket-web/spices/blob/master/server.js"
click node_order_logic "https://github.com/desaipraniket-web/spices/blob/master/server.js"
click node_admin_pages "https://github.com/desaipraniket-web/spices/blob/master/pages/admin.html"
click node_admin_routes "https://github.com/desaipraniket-web/spices/blob/master/server.js"
click node_json_store "https://github.com/desaipraniket-web/spices/blob/master/server.js"
click node_blog_pages "https://github.com/desaipraniket-web/spices/blob/master/pages/blogs.html"
click node_search_page "https://github.com/desaipraniket-web/spices/blob/master/pages/search.html"
click node_category_page "https://github.com/desaipraniket-web/spices/blob/master/pages/category.html"
click node_detail_page "https://github.com/desaipraniket-web/spices/blob/master/pages/blog-detail.html"
click node_contact_page "https://github.com/desaipraniket-web/spices/blob/master/pages/contact.html"

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_catalog_pages,node_product_page,node_cart_page,node_checkout_page,node_auth_pages,node_content_data,node_blog_pages,node_search_page,node_category_page,node_detail_page,node_contact_page toneBlue
class node_http_server,node_api_routes,node_auth_logic,node_order_logic,node_json_store toneAmber
class node_admin_pages,node_admin_routes toneMint
class node_customer toneIndigo
```

## Components

### Storefront

- [Catalog pages](https://github.com/desaipraniket-web/spices/blob/master/pages/shop.html): `pages/shop.html`
- [Product page](https://github.com/desaipraniket-web/spices/blob/master/pages/product.html): `pages/product.html`
- [Cart page](https://github.com/desaipraniket-web/spices/blob/master/pages/cart.html): `pages/cart.html`
- [Checkout page](https://github.com/desaipraniket-web/spices/blob/master/pages/checkout.html): `pages/checkout.html`
- [Account access](https://github.com/desaipraniket-web/spices/blob/master/pages/auth.html): `pages/auth.html`
- [Store content](https://github.com/desaipraniket-web/spices/blob/master/assets/js/data.js): `assets/js/data.js`
- [Blog pages](https://github.com/desaipraniket-web/spices/blob/master/pages/blogs.html): `pages/blogs.html`
- [Search page](https://github.com/desaipraniket-web/spices/blob/master/pages/search.html): `pages/search.html`
- [Category page](https://github.com/desaipraniket-web/spices/blob/master/pages/category.html): `pages/category.html`
- [Blog detail](https://github.com/desaipraniket-web/spices/blob/master/pages/blog-detail.html): `pages/blog-detail.html`
- [Contact page](https://github.com/desaipraniket-web/spices/blob/master/pages/contact.html): `pages/contact.html`

### Backend

- [HTTP server](https://github.com/desaipraniket-web/spices/blob/master/server.js): `server.js`
- [API routes](https://github.com/desaipraniket-web/spices/blob/master/server.js): `server.js`
- [User authentication](https://github.com/desaipraniket-web/spices/blob/master/server.js): `server.js`
- [Order processing](https://github.com/desaipraniket-web/spices/blob/master/server.js): `server.js`
- [JSON database](https://github.com/desaipraniket-web/spices/blob/master/server.js): `server.js`

### Administration

- [Admin interface](https://github.com/desaipraniket-web/spices/blob/master/pages/admin.html): `pages/admin.html`
- [Admin management](https://github.com/desaipraniket-web/spices/blob/master/server.js): `server.js`

### Other components

- **Customer**

## Connections

- Customer → Catalog pages: browses
- Customer → Product page: views products
- Customer → Cart page: manages cart
- Customer → Checkout page: submits checkout
- Customer → Account access: signs in
- Customer → Blog pages: reads blogs
- Customer → Search page: searches
- Customer → Category page: browses category
- Customer → Blog detail: reads article
- Customer → Contact page: contacts
- HTTP server → API routes: dispatches API (evidence: `server.js`)
- HTTP server → Catalog pages: serves static (evidence: `server.js`)
- API routes → User authentication: routes auth (evidence: `server.js`)
- API routes → Order processing: routes orders (evidence: `server.js`)
- API routes → Admin management: routes admin (evidence: `server.js`)
- User authentication → JSON database: reads and writes (evidence: `server.js`)
- Order processing → JSON database: reads and writes (evidence: `server.js`)
- Admin management → JSON database: reads and writes (evidence: `server.js`)
- API routes → Store content: loads defaults (evidence: `server.js`)
