# amankumar81/online_bookstore_management_web_applications architecture

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

- Interactive diagram: https://gitdiagram.com/amankumar81/online_bookstore_management_web_applications
- Repository: https://github.com/amankumar81/online_bookstore_management_web_applications

## Overview

This is a MERN bookstore storefront and administration system. Customers browse books, build a cart, apply coupons, check out by COD or Razorpay, then track orders and request returns; administrators manage the catalogue, orders, customers, coupons, returns, and analytics. The graph shows the client/API boundary, order and payment orchestration, and persistent domain state, alongside the documented review and notification capabilities. Some client and server modules are indexed but unsampled, so their connections are shown only where the README or excerpts support them.

Main entry points: [`server/controllers/payment.controller.js`](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/payment.controller.js) (Payment processing), [`server/controllers/order.controller.js`](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/order.controller.js) (Order lifecycle), [`client/src/App.jsx`](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/client/src/App.jsx) (Route dispatcher), [`server/routes`](https://github.com/amankumar81/online_bookstore_management_web_applications/tree/main/server/routes) (API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Customer and admin UI"]
  node_app["Route dispatcher<br/>[App.jsx]"]
  node_store["Client state"]
  node_catalog_ui["Catalogue shopping"]
  node_checkout_ui["Cart and checkout<br/>[Checkout.jsx]"]
  node_order_ui["Order tracking<br/>[OrderDetails.jsx]"]
  node_admin_ui["Admin console"]
  node_api_client["HTTP client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_server["Express API<br/>[app.js]"]
  node_routes["API routes"]
  node_access["Authentication and roles<br/>[auth.middleware.js]"]
end

subgraph group_commerce["Commerce workflows"]
  node_catalog["Catalogue operations<br/>[book.controller.js]"]
  node_cart["Cart operations<br/>[cart.controller.js]"]
  node_orders["Order lifecycle"]
  node_payments["Payment processing"]
  node_returns["Return processing"]
  node_reviews["Reviews and ratings"]
  node_admin_ops["Admin operations"]
end

subgraph group_domain["Domain persistence"]
  node_books_db[("Books<br/>[Book.js]")]
  node_cart_db[("Cart<br/>[Cart.js]")]
  node_orders_db[("Orders<br/>[Order.js]")]
  node_accounts_db[("Accounts<br/>[User.js]")]
  node_payments_db[("Payments<br/>[Payment.js]")]
  node_returns_db[("Returns<br/>[Return.js]")]
  node_reviews_db[("Review records<br/>[Review.js]")]
  node_notifications_db[("Notifications<br/>[Notification.js]")]
  node_coupons_db[("Coupons<br/>[Coupon.js]")]
end

subgraph group_integrations["External services"]
  node_mongo[("MongoDB")]
  node_razorpay["Razorpay"]
  node_cloudinary["Cloudinary"]
  node_email["Gmail SMTP"]
end

node_browser(("Customer or admin"))

node_browser -->|"uses"| node_app
node_app -->|"routes to"| node_catalog_ui
node_app -->|"routes to"| node_checkout_ui
node_app -->|"routes to"| node_order_ui
node_app -->|"protects routes"| node_admin_ui
node_checkout_ui -.->|"requests"| node_api_client
node_catalog_ui -.->|"requests"| node_api_client
node_order_ui -.->|"requests"| node_api_client
node_admin_ui -.->|"requests"| node_api_client
node_api_client -.->|"HTTP calls"| node_server
node_server -->|"mounts"| node_routes
node_routes -->|"guards requests"| node_access
node_routes -->|"dispatches"| node_orders
node_routes -->|"dispatches"| node_reviews
node_routes -->|"dispatches"| node_returns
node_orders -->|"reads"| node_cart_db
node_orders -->|"updates stock"| node_books_db
node_orders -->|"validates usage"| node_coupons_db
node_orders -->|"creates and updates"| node_orders_db
node_orders -->|"creates alerts"| node_notifications_db
node_payments -->|"creates and verifies"| node_razorpay
node_payments -->|"records payments"| node_payments_db
node_payments -->|"places paid orders"| node_orders_db
node_payments -->|"reads cart"| node_cart_db
node_payments -->|"reserves stock"| node_books_db
node_payments -->|"checks coupon"| node_coupons_db
node_payments -->|"creates alerts"| node_notifications_db
node_returns -->|"checks purchase"| node_orders_db
node_returns -->|"creates and advances"| node_returns_db
node_returns -->|"creates alerts"| node_notifications_db
node_reviews -->|"stores reviews"| node_reviews_db
node_reviews -->|"updates ratings"| node_books_db
node_access -->|"loads user"| node_accounts_db
node_server -.->|"persists data"| node_mongo
node_catalog -.->|"hosts covers"| node_cloudinary
node_admin_ops -->|"notifies admins"| node_notifications_db
node_server -.->|"sends support mail"| node_email

click node_app "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/client/src/App.jsx"
click node_store "https://github.com/amankumar81/online_bookstore_management_web_applications/tree/main/client/src/store"
click node_catalog_ui "https://github.com/amankumar81/online_bookstore_management_web_applications/tree/main/client/src/pages"
click node_checkout_ui "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/client/src/pages/Checkout.jsx"
click node_order_ui "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/client/src/pages/OrderDetails.jsx"
click node_admin_ui "https://github.com/amankumar81/online_bookstore_management_web_applications/tree/main/client/src/pages/admin"
click node_api_client "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/client/src/services/api.js"
click node_server "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/app.js"
click node_routes "https://github.com/amankumar81/online_bookstore_management_web_applications/tree/main/server/routes"
click node_access "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/middleware/auth.middleware.js"
click node_catalog "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/book.controller.js"
click node_cart "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/cart.controller.js"
click node_orders "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/order.controller.js"
click node_payments "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/payment.controller.js"
click node_returns "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/return.controller.js"
click node_reviews "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/review.controller.js"
click node_admin_ops "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/dashboard.controller.js"
click node_books_db "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Book.js"
click node_cart_db "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Cart.js"
click node_orders_db "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Order.js"
click node_accounts_db "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/User.js"
click node_payments_db "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Payment.js"
click node_returns_db "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Return.js"
click node_reviews_db "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Review.js"
click node_notifications_db "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Notification.js"
click node_coupons_db "https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Coupon.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_store,node_catalog_ui,node_checkout_ui,node_order_ui,node_admin_ui,node_api_client toneBlue
class node_server,node_routes,node_access toneAmber
class node_catalog,node_cart,node_orders,node_payments,node_returns,node_reviews,node_admin_ops toneMint
class node_books_db,node_cart_db,node_orders_db,node_accounts_db,node_payments_db,node_returns_db,node_reviews_db,node_notifications_db,node_coupons_db toneRose
class node_mongo,node_razorpay,node_cloudinary,node_email,node_browser toneIndigo
```

## Components

### Customer and admin UI

- [Route dispatcher](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Client state](https://github.com/amankumar81/online_bookstore_management_web_applications/tree/main/client/src/store): `client/src/store`
- [Catalogue shopping](https://github.com/amankumar81/online_bookstore_management_web_applications/tree/main/client/src/pages): `client/src/pages`
- [Cart and checkout](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/client/src/pages/Checkout.jsx): `client/src/pages/Checkout.jsx`
- [Order tracking](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/client/src/pages/OrderDetails.jsx): `client/src/pages/OrderDetails.jsx`
- [Admin console](https://github.com/amankumar81/online_bookstore_management_web_applications/tree/main/client/src/pages/admin): `client/src/pages/admin`
- [HTTP client](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/client/src/services/api.js): `client/src/services/api.js`

### API and access

- [Express API](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/app.js): `server/app.js`
- [API routes](https://github.com/amankumar81/online_bookstore_management_web_applications/tree/main/server/routes): `server/routes`
- [Authentication and roles](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/middleware/auth.middleware.js): `server/middleware/auth.middleware.js`

### Commerce workflows

- [Catalogue operations](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/book.controller.js): `server/controllers/book.controller.js`
- [Cart operations](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/cart.controller.js): `server/controllers/cart.controller.js`
- [Order lifecycle](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/order.controller.js): `server/controllers/order.controller.js`
- [Payment processing](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/payment.controller.js): `server/controllers/payment.controller.js`
- [Return processing](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/return.controller.js): `server/controllers/return.controller.js`
- [Reviews and ratings](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/review.controller.js): `server/controllers/review.controller.js`
- [Admin operations](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/controllers/dashboard.controller.js): `server/controllers/dashboard.controller.js`

### Domain persistence

- [Books](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Book.js): `server/models/Book.js`
- [Cart](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Cart.js): `server/models/Cart.js`
- [Orders](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Order.js): `server/models/Order.js`
- [Accounts](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/User.js): `server/models/User.js`
- [Payments](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Payment.js): `server/models/Payment.js`
- [Returns](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Return.js): `server/models/Return.js`
- [Review records](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Review.js): `server/models/Review.js`
- [Notifications](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Notification.js): `server/models/Notification.js`
- [Coupons](https://github.com/amankumar81/online_bookstore_management_web_applications/blob/main/server/models/Coupon.js): `server/models/Coupon.js`

### External services

- **MongoDB**
- **Razorpay**
- **Cloudinary**
- **Gmail SMTP**

### Other components

- **Customer or admin**

## Connections

- Customer or admin → Route dispatcher: uses (evidence: `client/src/App.jsx`)
- Route dispatcher → Catalogue shopping: routes to (evidence: `client/src/App.jsx`)
- Route dispatcher → Cart and checkout: routes to (evidence: `client/src/App.jsx`)
- Route dispatcher → Order tracking: routes to (evidence: `client/src/App.jsx`)
- Route dispatcher → Admin console: protects routes (evidence: `client/src/App.jsx`)
- Cart and checkout → HTTP client: requests
- Catalogue shopping → HTTP client: requests
- Order tracking → HTTP client: requests
- Admin console → HTTP client: requests
- HTTP client → Express API: HTTP calls
- Express API → API routes: mounts (evidence: `server/app.js`)
- API routes → Authentication and roles: guards requests (evidence: `server/routes/order.routes.js`)
- API routes → Order lifecycle: dispatches (evidence: `server/routes/order.routes.js`)
- API routes → Reviews and ratings: dispatches (evidence: `server/routes/review.routes.js`)
- API routes → Return processing: dispatches (evidence: `server/routes/return.routes.js`)
- Order lifecycle → Cart: reads (evidence: `server/controllers/order.controller.js`)
- Order lifecycle → Books: updates stock (evidence: `server/controllers/order.controller.js`)
- Order lifecycle → Coupons: validates usage (evidence: `server/controllers/order.controller.js`)
- Order lifecycle → Orders: creates and updates (evidence: `server/controllers/order.controller.js`)
- Order lifecycle → Notifications: creates alerts (evidence: `server/controllers/order.controller.js`)
- Payment processing → Razorpay: creates and verifies (evidence: `server/controllers/payment.controller.js`)
- Payment processing → Payments: records payments (evidence: `server/controllers/payment.controller.js`)
- Payment processing → Orders: places paid orders (evidence: `server/controllers/payment.controller.js`)
- Payment processing → Cart: reads cart (evidence: `server/controllers/payment.controller.js`)
- Payment processing → Books: reserves stock (evidence: `server/controllers/payment.controller.js`)
- Payment processing → Coupons: checks coupon (evidence: `server/controllers/payment.controller.js`)
- Payment processing → Notifications: creates alerts (evidence: `server/controllers/payment.controller.js`)
- Return processing → Orders: checks purchase (evidence: `server/controllers/return.controller.js`)
- Return processing → Returns: creates and advances (evidence: `server/controllers/return.controller.js`)
- Return processing → Notifications: creates alerts (evidence: `server/controllers/return.controller.js`)
- Reviews and ratings → Review records: stores reviews (evidence: `server/controllers/review.controller.js`)
- Reviews and ratings → Books: updates ratings (evidence: `server/controllers/review.controller.js`)
- Authentication and roles → Accounts: loads user (evidence: `server/middleware/auth.middleware.js`)
- Express API → MongoDB: persists data (evidence: `README.md`)
- Catalogue operations → Cloudinary: hosts covers (evidence: `README.md`)
- Admin operations → Notifications: notifies admins
- Express API → Gmail SMTP: sends support mail (evidence: `README.md`)
