# gauravkh-sys/grocerystoremanagement architecture

> Architecture diagram of the GitHub repository gauravkh-sys/grocerystoremanagement, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gauravkh-sys/grocerystoremanagement
- Repository: https://github.com/gauravkh-sys/grocerystoremanagement

## Overview

Freshly is a grocery storefront and lightweight inventory manager. Customers browse and filter products, manage a basket, and place demo orders; managers handle inventory, categories, units, orders, requests, and sales. The README says the shipped demo stores records in browser local storage and has no backend synchronization. Netlify API functions and a database schema are also present, but the sampled evidence does not show the frontend using them, so that server-side branch is kept separate. Some unsampled feature connections are omitted rather than inferred.

Main entry points: [`src/app/services/grocery-store.service.ts`](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/services/grocery-store.service.ts) (Store State), [`src/app/app.ts`](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/app.ts) (Store App), [`db/index.ts`](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/db/index.ts) (Database Client), [`netlify/lib/http.ts`](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/lib/http.ts) (HTTP Helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shop["Storefront"]
  node_app["Store App<br/>[app.ts]"]
  node_product_card["Product Card<br/>[product-card.ts]"]
  node_product_requests["Product Requests<br/>[product-request.ts]"]
  node_login["Customer Login<br/>[login-screen.ts]"]
end

subgraph group_management["Store Management"]
  node_inventory["Inventory<br/>[inventory-panel.ts]"]
  node_categories["Category Management<br/>[category-master.ts]"]
  node_units["Unit Management<br/>[unit-master.ts]"]
  node_orders["Order Management"]
  node_sales["Sales Dashboard<br/>[sales-dashboard.ts]"]
end

subgraph group_state["Demo State"]
  node_store["Store State"]
  node_local_storage[("Browser Storage")]
  node_language["Language"]
  node_theme["Theme<br/>[theme.service.ts]"]
  node_grocery_data["Product Catalog<br/>[grocery-data.ts]"]
  node_category_data["Category Data<br/>[category-data.ts]"]
  node_product_icons["Product Icons<br/>[product-icons.ts]"]
end

subgraph group_api["Netlify API"]
  node_api_categories["Category API<br/>[categories.mts]"]
  node_api_products["Product API<br/>[products.mts]"]
  node_api_orders["Order API<br/>[orders.mts]"]
  node_api_requests["Request API"]
  node_api_units["Unit API<br/>[units.mts]"]
  node_http["HTTP Helpers<br/>[http.ts]"]
end

subgraph group_database["Database"]
  node_db_client["Database Client<br/>[index.ts]"]
  node_schema["Store Schema<br/>[schema.ts]"]
end

node_customer(("Customer"))
node_manager(("Manager"))

node_customer -->|"browses and orders"| node_app
node_manager -->|"manages store"| node_app
node_app -->|"renders"| node_product_card
node_app -->|"renders"| node_product_requests
node_app -->|"renders"| node_login
node_app -->|"creates orders and basket items"| node_store
node_app -->|"translates interface"| node_language
node_app -->|"uses theme"| node_theme
node_inventory -->|"edits products"| node_store
node_inventory -->|"offers icons"| node_product_icons
node_product_card -->|"updates basket"| node_store
node_product_requests -->|"submits requests"| node_store
node_login -->|"checks accounts"| node_store
node_categories -->|"manages categories"| node_store
node_categories -->|"uses defaults"| node_category_data
node_units -->|"manages units"| node_store
node_orders -->|"manages orders"| node_store
node_sales -->|"reads sales data"| node_store
node_store -->|"persists snapshot"| node_local_storage
node_store -->|"loads initial catalog"| node_grocery_data
node_api_categories -->|"queries"| node_db_client
node_api_products -->|"queries"| node_db_client
node_api_orders -->|"reads and writes"| node_db_client
node_api_requests -->|"queries"| node_db_client
node_api_units -->|"queries"| node_db_client
node_api_categories -->|"uses helpers"| node_http
node_api_products -->|"uses helpers"| node_http
node_api_orders -->|"uses helpers"| node_http
node_api_requests -->|"uses helpers"| node_http
node_api_units -->|"uses helpers"| node_http
node_db_client -->|"registers schema"| node_schema

click node_app "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/app.ts"
click node_product_card "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/product-card/product-card.ts"
click node_product_requests "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/product-request/product-request.ts"
click node_login "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/login-screen/login-screen.ts"
click node_store "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/services/grocery-store.service.ts"
click node_language "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/services/language.service.ts"
click node_theme "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/services/theme.service.ts"
click node_grocery_data "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/data/grocery-data.ts"
click node_category_data "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/data/category-data.ts"
click node_product_icons "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/data/product-icons.ts"
click node_inventory "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/inventory-panel/inventory-panel.ts"
click node_categories "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/category-master/category-master.ts"
click node_units "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/unit-master/unit-master.ts"
click node_orders "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/order-management/order-management.ts"
click node_sales "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/sales-dashboard/sales-dashboard.ts"
click node_api_categories "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/functions/categories.mts"
click node_api_products "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/functions/products.mts"
click node_api_orders "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/functions/orders.mts"
click node_api_requests "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/functions/product-requests.mts"
click node_api_units "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/functions/units.mts"
click node_http "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/lib/http.ts"
click node_db_client "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/db/index.ts"
click node_schema "https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/db/schema.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_app,node_product_card,node_product_requests,node_login toneBlue
class node_inventory,node_categories,node_units,node_orders,node_sales toneAmber
class node_store,node_local_storage,node_language,node_theme,node_grocery_data,node_category_data,node_product_icons toneMint
class node_api_categories,node_api_products,node_api_orders,node_api_requests,node_api_units,node_http toneRose
class node_db_client,node_schema,node_customer,node_manager toneIndigo
```

## Components

### Storefront

- [Store App](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/app.ts): `src/app/app.ts`
- [Product Card](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/product-card/product-card.ts): `src/app/components/product-card/product-card.ts`
- [Product Requests](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/product-request/product-request.ts): `src/app/components/product-request/product-request.ts`
- [Customer Login](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/login-screen/login-screen.ts): `src/app/components/login-screen/login-screen.ts`

### Store Management

- [Inventory](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/inventory-panel/inventory-panel.ts): `src/app/components/inventory-panel/inventory-panel.ts`
- [Category Management](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/category-master/category-master.ts): `src/app/components/category-master/category-master.ts`
- [Unit Management](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/unit-master/unit-master.ts): `src/app/components/unit-master/unit-master.ts`
- [Order Management](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/order-management/order-management.ts): `src/app/components/order-management/order-management.ts`
- [Sales Dashboard](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/components/sales-dashboard/sales-dashboard.ts): `src/app/components/sales-dashboard/sales-dashboard.ts`

### Demo State

- [Store State](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/services/grocery-store.service.ts): `src/app/services/grocery-store.service.ts`
- **Browser Storage**
- [Language](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/services/language.service.ts): `src/app/services/language.service.ts`
- [Theme](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/services/theme.service.ts): `src/app/services/theme.service.ts`
- [Product Catalog](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/data/grocery-data.ts): `src/app/data/grocery-data.ts`
- [Category Data](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/data/category-data.ts): `src/app/data/category-data.ts`
- [Product Icons](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/src/app/data/product-icons.ts): `src/app/data/product-icons.ts`

### Netlify API

- [Category API](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/functions/categories.mts): `netlify/functions/categories.mts`
- [Product API](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/functions/products.mts): `netlify/functions/products.mts`
- [Order API](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/functions/orders.mts): `netlify/functions/orders.mts`
- [Request API](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/functions/product-requests.mts): `netlify/functions/product-requests.mts`
- [Unit API](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/functions/units.mts): `netlify/functions/units.mts`
- [HTTP Helpers](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/netlify/lib/http.ts): `netlify/lib/http.ts`

### Database

- [Database Client](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/db/index.ts): `db/index.ts`
- [Store Schema](https://github.com/gauravkh-sys/grocerystoremanagement/blob/main/db/schema.ts): `db/schema.ts`

### Other components

- **Customer**
- **Manager**

## Connections

- Customer → Store App: browses and orders (evidence: `README.md`)
- Manager → Store App: manages store (evidence: `README.md`)
- Store App → Product Card: renders (evidence: `src/app/app.ts`)
- Store App → Product Requests: renders (evidence: `src/app/app.ts`)
- Store App → Customer Login: renders (evidence: `src/app/app.ts`)
- Store App → Store State: creates orders and basket items (evidence: `src/app/app.ts`)
- Store App → Language: translates interface (evidence: `src/app/app.ts`)
- Store App → Theme: uses theme (evidence: `src/app/app.ts`)
- Inventory → Store State: edits products (evidence: `src/app/components/inventory-panel/inventory-panel.ts`)
- Inventory → Product Icons: offers icons (evidence: `src/app/components/inventory-panel/inventory-panel.ts`)
- Product Card → Store State: updates basket (evidence: `src/app/components/product-card/product-card.ts`)
- Product Requests → Store State: submits requests (evidence: `src/app/components/product-request/product-request.ts`)
- Customer Login → Store State: checks accounts (evidence: `src/app/components/login-screen/login-screen.ts`)
- Category Management → Store State: manages categories (evidence: `src/app/components/category-master/category-master.ts`)
- Category Management → Category Data: uses defaults (evidence: `src/app/components/category-master/category-master.ts`)
- Unit Management → Store State: manages units (evidence: `src/app/components/unit-master/unit-master.ts`)
- Order Management → Store State: manages orders (evidence: `src/app/components/order-management/order-management.ts`)
- Sales Dashboard → Store State: reads sales data (evidence: `src/app/components/sales-dashboard/sales-dashboard.ts`)
- Store State → Browser Storage: persists snapshot (evidence: `src/app/services/grocery-store.service.ts`)
- Store State → Product Catalog: loads initial catalog (evidence: `src/app/services/grocery-store.service.ts`)
- Category API → Database Client: queries (evidence: `netlify/functions/categories.mts`)
- Product API → Database Client: queries (evidence: `netlify/functions/products.mts`)
- Order API → Database Client: reads and writes (evidence: `netlify/functions/orders.mts`)
- Request API → Database Client: queries (evidence: `netlify/functions/product-requests.mts`)
- Unit API → Database Client: queries (evidence: `netlify/functions/units.mts`)
- Category API → HTTP Helpers: uses helpers (evidence: `netlify/functions/categories.mts`)
- Product API → HTTP Helpers: uses helpers (evidence: `netlify/functions/products.mts`)
- Order API → HTTP Helpers: uses helpers (evidence: `netlify/functions/orders.mts`)
- Request API → HTTP Helpers: uses helpers (evidence: `netlify/functions/product-requests.mts`)
- Unit API → HTTP Helpers: uses helpers (evidence: `netlify/functions/units.mts`)
- Database Client → Store Schema: registers schema (evidence: `db/index.ts`)
