# kritikat07/stationery-nook architecture

> Architecture diagram of the GitHub repository kritikat07/stationery-nook, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kritikat07/stationery-nook
- Repository: https://github.com/kritikat07/stationery-nook

## Overview

Stationery Nook is a full-stack stationery ordering app. The customer workflow is to browse products, manage a persistent cart, and submit a checkout with simulated card or UPI payment; successful checkout creates an order for later viewing. Registration and login support customer and owner roles, with customer and order views as additional capabilities. The graph combines related entity and repository files into subsystem nodes. Some frontend-to-backend behavior is documented or apparent from API usage, but unsampled controller details are not inferred beyond the source index.

Main entry points: [`App.jsx`](https://github.com/kritikat07/stationery-nook/blob/main/App.jsx) (App routing), [`utils/api.js`](https://github.com/kritikat07/stationery-nook/blob/main/utils/api.js) (API client), [`backend/src/main/java/com/stationerynook/repository`](https://github.com/kritikat07/stationery-nook/tree/main/backend/src/main/java/com/stationerynook/repository) (Data repositories), [`components/CartContext.jsx`](https://github.com/kritikat07/stationery-nook/blob/main/components/CartContext.jsx) (Cart state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_catalog["Product browsing<br/>[Product.jsx]"]
  node_home["Home browsing<br/>[Home.jsx]"]
  node_cartstate["Cart state<br/>[CartContext.jsx]"]
  node_cartpage["Cart page<br/>[Cart.jsx]"]
  node_upload["Print upload<br/>[Upload.jsx]"]
end

subgraph group_account["Accounts and access"]
  node_authpages["Login and register<br/>[Login.jsx]"]
  node_userstate["User state<br/>[UserContext.jsx]"]
  node_customers["Customer view<br/>[Customers.jsx]"]
  node_customerapi["Customer API"]
end

subgraph group_commerce["Ordering"]
  node_checkoutpage["Checkout page<br/>[Checkout.jsx]"]
  node_orderspage["Order history<br/>[Orders.jsx]"]
  node_checkoutapi["Checkout API"]
  node_orderapi["Order API"]
end

subgraph group_backend["Backend services"]
  node_api["API client<br/>[api.js]"]
  node_authapi["Authentication API"]
  node_jwt["JWT utilities<br/>[JwtUtils.java]"]
  node_security["JWT security filter<br/>[JwtFilter.java]"]
  node_productapi["Product API"]
  node_entities["Domain entities"]
  node_repositories["Data repositories"]
  node_database[("Application database")]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_app
node_app -->|"routes"| node_home
node_app -->|"routes"| node_catalog
node_app -->|"routes"| node_cartpage
node_app -->|"routes"| node_checkoutpage
node_app -->|"routes"| node_upload
node_app -->|"routes"| node_orderspage
node_app -->|"routes"| node_authpages
node_app -->|"routes"| node_customers
node_catalog -->|"adds products"| node_cartstate
node_cartpage -->|"updates cart"| node_cartstate
node_cartstate -->|"persists cart"| node_shopper
node_checkoutpage -->|"reads cart"| node_cartstate
node_checkoutpage -->|"submits checkout"| node_api
node_upload -->|"uses cart"| node_cartstate
node_authpages -->|"sends credentials"| node_api
node_authpages -->|"sets session"| node_userstate
node_app -->|"provides state"| node_userstate
node_app -->|"provides state"| node_cartstate
node_customers -->|"requests customers"| node_api
node_orderspage -->|"requests orders"| node_api
node_api -.->|"calls API"| node_authapi
node_api -.->|"calls API"| node_productapi
node_api -.->|"calls API"| node_checkoutapi
node_api -.->|"calls API"| node_orderapi
node_api -.->|"calls API"| node_customerapi
node_authapi -->|"creates tokens"| node_jwt
node_security -->|"validates tokens"| node_jwt
node_security -->|"loads user"| node_repositories
node_authapi -->|"reads and saves users"| node_repositories
node_productapi -->|"accesses products"| node_repositories
node_checkoutapi -->|"reads and saves"| node_repositories
node_orderapi -->|"queries orders"| node_repositories
node_customerapi -->|"queries users"| node_repositories
node_repositories -->|"persists entities"| node_entities
node_repositories -.->|"reads and writes"| node_database
node_checkoutapi -->|"confirms order"| node_shopper

click node_app "https://github.com/kritikat07/stationery-nook/blob/main/App.jsx"
click node_catalog "https://github.com/kritikat07/stationery-nook/blob/main/pages/Product.jsx"
click node_home "https://github.com/kritikat07/stationery-nook/blob/main/pages/Home.jsx"
click node_cartstate "https://github.com/kritikat07/stationery-nook/blob/main/components/CartContext.jsx"
click node_cartpage "https://github.com/kritikat07/stationery-nook/blob/main/pages/Cart.jsx"
click node_upload "https://github.com/kritikat07/stationery-nook/blob/main/pages/Upload.jsx"
click node_checkoutpage "https://github.com/kritikat07/stationery-nook/blob/main/pages/Checkout.jsx"
click node_orderspage "https://github.com/kritikat07/stationery-nook/blob/main/pages/Orders.jsx"
click node_authpages "https://github.com/kritikat07/stationery-nook/blob/main/pages/Login.jsx"
click node_userstate "https://github.com/kritikat07/stationery-nook/blob/main/components/UserContext.jsx"
click node_customers "https://github.com/kritikat07/stationery-nook/blob/main/pages/Customers.jsx"
click node_api "https://github.com/kritikat07/stationery-nook/blob/main/utils/api.js"
click node_authapi "https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/controller/AuthController.java"
click node_jwt "https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/security/JwtUtils.java"
click node_security "https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/security/JwtFilter.java"
click node_productapi "https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/controller/ProductController.java"
click node_checkoutapi "https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/controller/CheckoutController.java"
click node_orderapi "https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/controller/OrderController.java"
click node_customerapi "https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/controller/CustomerController.java"
click node_entities "https://github.com/kritikat07/stationery-nook/tree/main/backend/src/main/java/com/stationerynook/model"
click node_repositories "https://github.com/kritikat07/stationery-nook/tree/main/backend/src/main/java/com/stationerynook/repository"

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_home,node_cartstate,node_cartpage,node_upload toneBlue
class node_authpages,node_userstate,node_customers,node_customerapi toneAmber
class node_checkoutpage,node_orderspage,node_checkoutapi,node_orderapi toneMint
class node_api,node_authapi,node_jwt,node_security,node_productapi,node_entities,node_repositories,node_database toneRose
class node_shopper toneIndigo
```

## Components

### Web experience

- [App routing](https://github.com/kritikat07/stationery-nook/blob/main/App.jsx): `App.jsx`
- [Product browsing](https://github.com/kritikat07/stationery-nook/blob/main/pages/Product.jsx): `pages/Product.jsx`
- [Home browsing](https://github.com/kritikat07/stationery-nook/blob/main/pages/Home.jsx): `pages/Home.jsx`
- [Cart state](https://github.com/kritikat07/stationery-nook/blob/main/components/CartContext.jsx): `components/CartContext.jsx`
- [Cart page](https://github.com/kritikat07/stationery-nook/blob/main/pages/Cart.jsx): `pages/Cart.jsx`
- [Print upload](https://github.com/kritikat07/stationery-nook/blob/main/pages/Upload.jsx): `pages/Upload.jsx`

### Accounts and access

- [Login and register](https://github.com/kritikat07/stationery-nook/blob/main/pages/Login.jsx): `pages/Login.jsx`
- [User state](https://github.com/kritikat07/stationery-nook/blob/main/components/UserContext.jsx): `components/UserContext.jsx`
- [Customer view](https://github.com/kritikat07/stationery-nook/blob/main/pages/Customers.jsx): `pages/Customers.jsx`
- [Customer API](https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/controller/CustomerController.java): `backend/src/main/java/com/stationerynook/controller/CustomerController.java`

### Ordering

- [Checkout page](https://github.com/kritikat07/stationery-nook/blob/main/pages/Checkout.jsx): `pages/Checkout.jsx`
- [Order history](https://github.com/kritikat07/stationery-nook/blob/main/pages/Orders.jsx): `pages/Orders.jsx`
- [Checkout API](https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/controller/CheckoutController.java): `backend/src/main/java/com/stationerynook/controller/CheckoutController.java`
- [Order API](https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/controller/OrderController.java): `backend/src/main/java/com/stationerynook/controller/OrderController.java`

### Backend services

- [API client](https://github.com/kritikat07/stationery-nook/blob/main/utils/api.js): `utils/api.js`
- [Authentication API](https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/controller/AuthController.java): `backend/src/main/java/com/stationerynook/controller/AuthController.java`
- [JWT utilities](https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/security/JwtUtils.java): `backend/src/main/java/com/stationerynook/security/JwtUtils.java`
- [JWT security filter](https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/security/JwtFilter.java): `backend/src/main/java/com/stationerynook/security/JwtFilter.java`
- [Product API](https://github.com/kritikat07/stationery-nook/blob/main/backend/src/main/java/com/stationerynook/controller/ProductController.java): `backend/src/main/java/com/stationerynook/controller/ProductController.java`
- [Domain entities](https://github.com/kritikat07/stationery-nook/tree/main/backend/src/main/java/com/stationerynook/model): `backend/src/main/java/com/stationerynook/model`
- [Data repositories](https://github.com/kritikat07/stationery-nook/tree/main/backend/src/main/java/com/stationerynook/repository): `backend/src/main/java/com/stationerynook/repository`
- **Application database**

### Other components

- **Shopper**

## Connections

- Shopper → App routing: uses (evidence: `App.jsx`)
- App routing → Home browsing: routes (evidence: `App.jsx`)
- App routing → Product browsing: routes (evidence: `App.jsx`)
- App routing → Cart page: routes (evidence: `App.jsx`)
- App routing → Checkout page: routes (evidence: `App.jsx`)
- App routing → Print upload: routes (evidence: `App.jsx`)
- App routing → Order history: routes (evidence: `App.jsx`)
- App routing → Login and register: routes (evidence: `App.jsx`)
- App routing → Customer view: routes (evidence: `App.jsx`)
- Product browsing → Cart state: adds products (evidence: `pages/Product.jsx`)
- Cart page → Cart state: updates cart (evidence: `pages/Cart.jsx`)
- Cart state → Shopper: persists cart (evidence: `components/CartContext.jsx`)
- Checkout page → Cart state: reads cart (evidence: `pages/Checkout.jsx`)
- Checkout page → API client: submits checkout (evidence: `pages/Checkout.jsx`)
- Print upload → Cart state: uses cart (evidence: `pages/Upload.jsx`)
- Login and register → API client: sends credentials (evidence: `pages/Login.jsx`)
- Login and register → User state: sets session (evidence: `pages/Login.jsx`)
- App routing → User state: provides state (evidence: `App.jsx`)
- App routing → Cart state: provides state (evidence: `App.jsx`)
- Customer view → API client: requests customers (evidence: `pages/Customers.jsx`)
- Order history → API client: requests orders (evidence: `pages/Orders.jsx`)
- API client → Authentication API: calls API
- API client → Product API: calls API
- API client → Checkout API: calls API
- API client → Order API: calls API
- API client → Customer API: calls API
- Authentication API → JWT utilities: creates tokens (evidence: `backend/src/main/java/com/stationerynook/controller/AuthController.java`)
- JWT security filter → JWT utilities: validates tokens (evidence: `backend/src/main/java/com/stationerynook/security/JwtFilter.java`)
- JWT security filter → Data repositories: loads user (evidence: `backend/src/main/java/com/stationerynook/security/JwtFilter.java`)
- Authentication API → Data repositories: reads and saves users (evidence: `backend/src/main/java/com/stationerynook/controller/AuthController.java`)
- Product API → Data repositories: accesses products (evidence: `backend/src/main/java/com/stationerynook/controller/ProductController.java`)
- Checkout API → Data repositories: reads and saves (evidence: `backend/src/main/java/com/stationerynook/controller/CheckoutController.java`)
- Order API → Data repositories: queries orders (evidence: `backend/src/main/java/com/stationerynook/controller/OrderController.java`)
- Customer API → Data repositories: queries users (evidence: `backend/src/main/java/com/stationerynook/controller/CustomerController.java`)
- Data repositories → Domain entities: persists entities (evidence: `backend/src/main/java/com/stationerynook/repository/OrderRepository.java`)
- Data repositories → Application database: reads and writes
- Checkout API → Shopper: confirms order (evidence: `backend/src/main/java/com/stationerynook/controller/CheckoutController.java`)
