# 0charanguru/e-commerce architecture

> Architecture diagram of the GitHub repository 0charanguru/e-commerce, 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/0charanguru/e-commerce
- Repository: https://github.com/0charanguru/e-commerce

## Overview

This is a role-based shopping application: visitors browse the public home and sign in or register; users browse products, manage a cart, place orders, and view account/order information; administrators manage products, orders, and users. The frontend uses GraphQL operations against a backend whose resolvers query PostgreSQL. Source excerpts show cart/order and product-management behavior; several listed capabilities are represented from the source index, so their internal links are omitted where call evidence is unavailable.

Main entry points: [`frontend/src/App.js`](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/App.js) (Route application), [`frontend/src/Query.jsx`](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Query.jsx) (GraphQL operations), [`frontend/src/Users/UserDashBoard.jsx`](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/UserDashBoard.jsx) (Customer dashboard), [`frontend/src/Mutation.jsx`](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Mutation.jsx) (GraphQL mutations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Frontend and access"]
  node_app["Route application<br/>[App.js]"]
  node_access["Role guard"]
  node_landing["Public landing<br/>[home.jsx]"]
  node_sign_in["Sign in<br/>[Login.jsx]"]
  node_registration["Registration<br/>[Signup.jsx]"]
  node_gql_ops["GraphQL operations<br/>[Query.jsx]"]
  node_gql_mutations["GraphQL mutations<br/>[Mutation.jsx]"]
end

subgraph group_shopping["Customer shopping"]
  node_customer_dashboard["Customer dashboard<br/>[UserDashBoard.jsx]"]
  node_catalog["Product browsing<br/>[Home.jsx]"]
  node_cart["Cart and checkout<br/>[Cart.jsx]"]
  node_cart_state["Cart state<br/>[CartSlice.jsx]"]
  node_order_history["Order history<br/>[Orders.jsx]"]
  node_account_settings["Account settings<br/>[Settings.jsx]"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Admin dashboard<br/>[adminDashboard.jsx]"]
  node_product_admin["Product management<br/>[AddEditItems.jsx]"]
  node_order_admin["Order management"]
  node_user_admin["User management<br/>[UserManagement.jsx]"]
end

subgraph group_server["GraphQL and storage"]
  node_api["GraphQL server<br/>[index.js]"]
  node_schema["GraphQL schema<br/>[typeDef.js]"]
  node_resolvers["Query and mutation resolvers<br/>[resolvers.js]"]
  node_queries["Read handlers<br/>[Query.js]"]
  node_mutations["Write handlers<br/>[Mutation.js]"]
  node_database[("PostgreSQL pool<br/>[db.js]")]
end

node_visitor(("Visitor"))
node_customer(("Customer"))
node_administrator(("Administrator"))

node_visitor -->|"opens"| node_app
node_customer -->|"opens"| node_app
node_administrator -->|"opens"| node_app
node_app -->|"routes"| node_landing
node_app -->|"routes"| node_sign_in
node_app -->|"routes"| node_registration
node_app -->|"guards"| node_access
node_app -->|"routes"| node_customer_dashboard
node_app -->|"routes"| node_admin_dashboard
node_sign_in -->|"queries"| node_gql_ops
node_registration -->|"mutates"| node_gql_mutations
node_customer_dashboard -->|"renders"| node_catalog
node_customer_dashboard -->|"renders"| node_cart
node_customer_dashboard -->|"renders"| node_order_history
node_customer_dashboard -->|"renders"| node_account_settings
node_catalog -->|"queries"| node_gql_ops
node_catalog -->|"dispatches"| node_cart_state
node_cart -->|"dispatches"| node_cart_state
node_cart -->|"places order"| node_gql_mutations
node_order_history -->|"queries"| node_gql_ops
node_admin_dashboard -->|"renders"| node_product_admin
node_admin_dashboard -->|"renders"| node_order_admin
node_admin_dashboard -->|"renders"| node_user_admin
node_product_admin -->|"queries"| node_gql_ops
node_product_admin -->|"mutates"| node_gql_mutations
node_order_admin -->|"queries"| node_gql_ops
node_order_admin -->|"updates status"| node_gql_mutations
node_user_admin -->|"queries"| node_gql_ops
node_api -->|"configures"| node_schema
node_api -->|"registers"| node_resolvers
node_resolvers -->|"dispatches reads"| node_queries
node_resolvers -->|"dispatches writes"| node_mutations
node_queries -->|"reads"| node_database
node_mutations -->|"reads and writes"| node_database
node_gql_ops -.->|"sends queries"| node_api
node_gql_mutations -.->|"sends mutations"| node_api

click node_app "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/App.js"
click node_access "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/ProtectedRoutes.jsx"
click node_landing "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/home.jsx"
click node_sign_in "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Login.jsx"
click node_registration "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Signup.jsx"
click node_customer_dashboard "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/UserDashBoard.jsx"
click node_catalog "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/Home.jsx"
click node_cart "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/Cart.jsx"
click node_cart_state "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Redux/CartSlice.jsx"
click node_order_history "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/Orders.jsx"
click node_account_settings "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/Settings.jsx"
click node_admin_dashboard "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/admin/adminDashboard.jsx"
click node_product_admin "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/admin/AddEditItems.jsx"
click node_order_admin "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/admin/OrderManagement.jsx"
click node_user_admin "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/admin/UserManagement.jsx"
click node_gql_ops "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Query.jsx"
click node_gql_mutations "https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Mutation.jsx"
click node_api "https://github.com/0charanguru/e-commerce/blob/main/backend/index.js"
click node_schema "https://github.com/0charanguru/e-commerce/blob/main/backend/graphql/typeDef.js"
click node_resolvers "https://github.com/0charanguru/e-commerce/blob/main/backend/graphql/resolvers.js"
click node_queries "https://github.com/0charanguru/e-commerce/blob/main/backend/graphql/Query.js"
click node_mutations "https://github.com/0charanguru/e-commerce/blob/main/backend/graphql/Mutation.js"
click node_database "https://github.com/0charanguru/e-commerce/blob/main/backend/database/db.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_app,node_access,node_landing,node_sign_in,node_registration,node_gql_ops,node_gql_mutations toneBlue
class node_customer_dashboard,node_catalog,node_cart,node_cart_state,node_order_history,node_account_settings toneAmber
class node_admin_dashboard,node_product_admin,node_order_admin,node_user_admin toneMint
class node_api,node_schema,node_resolvers,node_queries,node_mutations,node_database toneRose
class node_visitor,node_customer,node_administrator toneIndigo
```

## Components

### Frontend and access

- [Route application](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Role guard](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/ProtectedRoutes.jsx): `frontend/src/ProtectedRoutes.jsx`
- [Public landing](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/home.jsx): `frontend/src/home.jsx`
- [Sign in](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Login.jsx): `frontend/src/Login.jsx`
- [Registration](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Signup.jsx): `frontend/src/Signup.jsx`
- [GraphQL operations](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Query.jsx): `frontend/src/Query.jsx`
- [GraphQL mutations](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Mutation.jsx): `frontend/src/Mutation.jsx`

### Customer shopping

- [Customer dashboard](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/UserDashBoard.jsx): `frontend/src/Users/UserDashBoard.jsx`
- [Product browsing](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/Home.jsx): `frontend/src/Users/Home.jsx`
- [Cart and checkout](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/Cart.jsx): `frontend/src/Users/Cart.jsx`
- [Cart state](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Redux/CartSlice.jsx): `frontend/src/Redux/CartSlice.jsx`
- [Order history](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/Orders.jsx): `frontend/src/Users/Orders.jsx`
- [Account settings](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/Users/Settings.jsx): `frontend/src/Users/Settings.jsx`

### Administration

- [Admin dashboard](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/admin/adminDashboard.jsx): `frontend/src/admin/adminDashboard.jsx`
- [Product management](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/admin/AddEditItems.jsx): `frontend/src/admin/AddEditItems.jsx`
- [Order management](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/admin/OrderManagement.jsx): `frontend/src/admin/OrderManagement.jsx`
- [User management](https://github.com/0charanguru/e-commerce/blob/main/frontend/src/admin/UserManagement.jsx): `frontend/src/admin/UserManagement.jsx`

### GraphQL and storage

- [GraphQL server](https://github.com/0charanguru/e-commerce/blob/main/backend/index.js): `backend/index.js`
- [GraphQL schema](https://github.com/0charanguru/e-commerce/blob/main/backend/graphql/typeDef.js): `backend/graphql/typeDef.js`
- [Query and mutation resolvers](https://github.com/0charanguru/e-commerce/blob/main/backend/graphql/resolvers.js): `backend/graphql/resolvers.js`
- [Read handlers](https://github.com/0charanguru/e-commerce/blob/main/backend/graphql/Query.js): `backend/graphql/Query.js`
- [Write handlers](https://github.com/0charanguru/e-commerce/blob/main/backend/graphql/Mutation.js): `backend/graphql/Mutation.js`
- [PostgreSQL pool](https://github.com/0charanguru/e-commerce/blob/main/backend/database/db.js): `backend/database/db.js`

### Other components

- **Visitor**
- **Customer**
- **Administrator**

## Connections

- Visitor → Route application: opens
- Customer → Route application: opens
- Administrator → Route application: opens
- Route application → Public landing: routes (evidence: `frontend/src/App.js`)
- Route application → Sign in: routes (evidence: `frontend/src/App.js`)
- Route application → Registration: routes (evidence: `frontend/src/App.js`)
- Route application → Role guard: guards (evidence: `frontend/src/App.js`)
- Route application → Customer dashboard: routes (evidence: `frontend/src/App.js`)
- Route application → Admin dashboard: routes (evidence: `frontend/src/App.js`)
- Sign in → GraphQL operations: queries (evidence: `frontend/src/Login.jsx`)
- Registration → GraphQL mutations: mutates (evidence: `frontend/src/Signup.jsx`)
- Customer dashboard → Product browsing: renders (evidence: `frontend/src/Users/UserDashBoard.jsx`)
- Customer dashboard → Cart and checkout: renders (evidence: `frontend/src/Users/UserDashBoard.jsx`)
- Customer dashboard → Order history: renders (evidence: `frontend/src/Users/UserDashBoard.jsx`)
- Customer dashboard → Account settings: renders (evidence: `frontend/src/Users/UserDashBoard.jsx`)
- Product browsing → GraphQL operations: queries (evidence: `frontend/src/Users/Home.jsx`)
- Product browsing → Cart state: dispatches (evidence: `frontend/src/Users/Home.jsx`)
- Cart and checkout → Cart state: dispatches (evidence: `frontend/src/Users/Cart.jsx`)
- Cart and checkout → GraphQL mutations: places order (evidence: `frontend/src/Users/Cart.jsx`)
- Order history → GraphQL operations: queries (evidence: `frontend/src/Users/Orders.jsx`)
- Admin dashboard → Product management: renders (evidence: `frontend/src/admin/adminDashboard.jsx`)
- Admin dashboard → Order management: renders (evidence: `frontend/src/admin/adminDashboard.jsx`)
- Admin dashboard → User management: renders (evidence: `frontend/src/admin/adminDashboard.jsx`)
- Product management → GraphQL operations: queries (evidence: `frontend/src/admin/AddEditItems.jsx`)
- Product management → GraphQL mutations: mutates (evidence: `frontend/src/admin/AddEditItems.jsx`)
- Order management → GraphQL operations: queries (evidence: `frontend/src/admin/OrderManagement.jsx`)
- Order management → GraphQL mutations: updates status (evidence: `frontend/src/admin/OrderManagement.jsx`)
- User management → GraphQL operations: queries (evidence: `frontend/src/admin/UserManagement.jsx`)
- GraphQL server → GraphQL schema: configures (evidence: `backend/index.js`)
- GraphQL server → Query and mutation resolvers: registers (evidence: `backend/index.js`)
- Query and mutation resolvers → Read handlers: dispatches reads (evidence: `backend/graphql/resolvers.js`)
- Query and mutation resolvers → Write handlers: dispatches writes (evidence: `backend/graphql/resolvers.js`)
- Read handlers → PostgreSQL pool: reads (evidence: `backend/graphql/Query.js`)
- Write handlers → PostgreSQL pool: reads and writes (evidence: `backend/graphql/Mutation.js`)
- GraphQL operations → GraphQL server: sends queries
- GraphQL mutations → GraphQL server: sends mutations
