# shashirajraja/onlinebookstore architecture

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

- Interactive diagram: https://gitdiagram.com/shashirajraja/onlinebookstore
- Repository: https://github.com/shashirajraja/onlinebookstore

## Overview

OnlineBookStore is a Java Servlet/JDBC bookstore with customer and seller/admin access. Customers register or log in, browse books, manage a session cart, check out, process payment, and obtain a receipt; sellers manage the catalog and stock. Servlets handle requests, service implementations provide book and user operations, and JDBC utilities connect to the configured database. The README documents these capabilities; edges are limited to relationships supported by the README or the supplied source index, which also lists imports for servlet files not excerpted here.

Main entry points: [`src/main/java/com/bittercode/service/impl/BookServiceImpl.java`](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/service/impl/BookServiceImpl.java) (Book operations), [`WebContent/CustomerHome.html`](https://github.com/shashirajraja/onlinebookstore/blob/master/WebContent/CustomerHome.html) (Customer pages), [`WebContent/SellerHome.html`](https://github.com/shashirajraja/onlinebookstore/blob/master/WebContent/SellerHome.html) (Seller pages), [`src/main/java/com/bittercode/service/impl/UserServiceImpl.java`](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/service/impl/UserServiceImpl.java) (User operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_customer_ui["Customer pages<br/>[CustomerHome.html]"]
  node_seller_ui["Seller pages<br/>[SellerHome.html]"]
end

subgraph group_requests["Servlet workflows"]
  node_login["Login"]
  node_registration["Registration"]
  node_catalogue["Browse books"]
  node_cart["Cart updates<br/>[CartServlet.java]"]
  node_buy["Buy books"]
  node_checkout["Checkout"]
  node_payment["Payment processing"]
  node_receipt["Receipt"]
  node_admin_catalog["Manage catalog"]
  node_remove_book["Remove books"]
  node_update_book["Update books"]
  node_store_book["Store books"]
end

subgraph group_domain["Services and models"]
  node_cart_util["Cart session helper<br/>[StoreUtil.java]"]
  node_book_service["Book operations"]
  node_user_service["User operations"]
  node_book_model["Book model<br/>[Book.java]"]
  node_user_model["User model<br/>[User.java]"]
end

subgraph group_persistence["Persistence"]
  node_dbutil["JDBC connection<br/>[DBUtil.java]"]
  node_db_config["Database configuration"]
  node_database[("MySQL database")]
end

node_customer(("Customer"))
node_seller(("Seller / admin"))

node_customer -->|"uses"| node_customer_ui
node_seller -->|"uses"| node_seller_ui
node_customer_ui -.->|"submits login"| node_login
node_customer_ui -.->|"registers"| node_registration
node_customer_ui -.->|"browses"| node_catalogue
node_customer_ui -.->|"updates cart"| node_cart
node_cart -->|"updates session"| node_cart_util
node_customer_ui -.->|"selects books"| node_buy
node_customer_ui -.->|"checks out"| node_checkout
node_customer_ui -.->|"pays"| node_payment
node_customer_ui -.->|"views receipt"| node_receipt
node_seller_ui -.->|"adds books"| node_admin_catalog
node_seller_ui -.->|"removes books"| node_remove_book
node_seller_ui -.->|"updates stock"| node_update_book
node_seller_ui -.->|"views inventory"| node_store_book
node_login -->|"authenticates"| node_user_service
node_registration -->|"registers user"| node_user_service
node_user_service -->|"builds user"| node_user_model
node_catalogue -->|"loads books"| node_book_service
node_cart -->|"loads books"| node_book_service
node_buy -->|"updates stock"| node_book_service
node_payment -->|"uses book data"| node_book_service
node_receipt -->|"loads receipt data"| node_book_service
node_admin_catalog -->|"adds book"| node_book_service
node_remove_book -->|"deletes book"| node_book_service
node_update_book -->|"updates book"| node_book_service
node_store_book -->|"manages inventory"| node_book_service
node_book_service -->|"creates books"| node_book_model
node_book_service -->|"gets connection"| node_dbutil
node_user_service -->|"gets connection"| node_dbutil
node_dbutil -->|"loads settings"| node_db_config
node_dbutil -->|"connects to"| node_database

click node_customer_ui "https://github.com/shashirajraja/onlinebookstore/blob/master/WebContent/CustomerHome.html"
click node_seller_ui "https://github.com/shashirajraja/onlinebookstore/blob/master/WebContent/SellerHome.html"
click node_login "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/CustomerLoginServlet.java"
click node_registration "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/CustomerRegisterServlet.java"
click node_catalogue "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/ViewBookServlet.java"
click node_cart "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/CartServlet.java"
click node_cart_util "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/util/StoreUtil.java"
click node_buy "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/BuyBooksServlet.java"
click node_checkout "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/CheckoutServlet.java"
click node_payment "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/ProcessPaymentServlet.java"
click node_receipt "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/ReceiptServlet.java"
click node_admin_catalog "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/AddBookServlet.java"
click node_remove_book "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/RemoveBookServlet.java"
click node_update_book "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/UpdateBookServlet.java"
click node_store_book "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/StoreBookServlet.java"
click node_book_service "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/service/impl/BookServiceImpl.java"
click node_user_service "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/service/impl/UserServiceImpl.java"
click node_book_model "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/model/Book.java"
click node_user_model "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/model/User.java"
click node_dbutil "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/util/DBUtil.java"
click node_db_config "https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/util/DatabaseConfig.java"

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_customer_ui,node_seller_ui toneBlue
class node_login,node_registration,node_catalogue,node_cart,node_buy,node_checkout,node_payment,node_receipt,node_admin_catalog,node_remove_book,node_update_book,node_store_book toneAmber
class node_cart_util,node_book_service,node_user_service,node_book_model,node_user_model toneMint
class node_dbutil,node_db_config,node_database toneRose
class node_customer,node_seller toneIndigo
```

## Components

### Web experience

- [Customer pages](https://github.com/shashirajraja/onlinebookstore/blob/master/WebContent/CustomerHome.html): `WebContent/CustomerHome.html`
- [Seller pages](https://github.com/shashirajraja/onlinebookstore/blob/master/WebContent/SellerHome.html): `WebContent/SellerHome.html`

### Servlet workflows

- [Login](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/CustomerLoginServlet.java): `src/main/java/servlets/CustomerLoginServlet.java`
- [Registration](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/CustomerRegisterServlet.java): `src/main/java/servlets/CustomerRegisterServlet.java`
- [Browse books](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/ViewBookServlet.java): `src/main/java/servlets/ViewBookServlet.java`
- [Cart updates](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/CartServlet.java): `src/main/java/servlets/CartServlet.java`
- [Buy books](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/BuyBooksServlet.java): `src/main/java/servlets/BuyBooksServlet.java`
- [Checkout](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/CheckoutServlet.java): `src/main/java/servlets/CheckoutServlet.java`
- [Payment processing](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/ProcessPaymentServlet.java): `src/main/java/servlets/ProcessPaymentServlet.java`
- [Receipt](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/ReceiptServlet.java): `src/main/java/servlets/ReceiptServlet.java`
- [Manage catalog](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/AddBookServlet.java): `src/main/java/servlets/AddBookServlet.java`
- [Remove books](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/RemoveBookServlet.java): `src/main/java/servlets/RemoveBookServlet.java`
- [Update books](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/UpdateBookServlet.java): `src/main/java/servlets/UpdateBookServlet.java`
- [Store books](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/servlets/StoreBookServlet.java): `src/main/java/servlets/StoreBookServlet.java`

### Services and models

- [Cart session helper](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/util/StoreUtil.java): `src/main/java/com/bittercode/util/StoreUtil.java`
- [Book operations](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/service/impl/BookServiceImpl.java): `src/main/java/com/bittercode/service/impl/BookServiceImpl.java`
- [User operations](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/service/impl/UserServiceImpl.java): `src/main/java/com/bittercode/service/impl/UserServiceImpl.java`
- [Book model](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/model/Book.java): `src/main/java/com/bittercode/model/Book.java`
- [User model](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/model/User.java): `src/main/java/com/bittercode/model/User.java`

### Persistence

- [JDBC connection](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/util/DBUtil.java): `src/main/java/com/bittercode/util/DBUtil.java`
- [Database configuration](https://github.com/shashirajraja/onlinebookstore/blob/master/src/main/java/com/bittercode/util/DatabaseConfig.java): `src/main/java/com/bittercode/util/DatabaseConfig.java`
- **MySQL database**

### Other components

- **Customer**
- **Seller / admin**

## Connections

- Customer → Customer pages: uses (evidence: `README.md`)
- Seller / admin → Seller pages: uses (evidence: `README.md`)
- Customer pages → Login: submits login
- Customer pages → Registration: registers
- Customer pages → Browse books: browses
- Customer pages → Cart updates: updates cart
- Cart updates → Cart session helper: updates session (evidence: `src/main/java/servlets/CartServlet.java`)
- Customer pages → Buy books: selects books
- Customer pages → Checkout: checks out
- Customer pages → Payment processing: pays
- Customer pages → Receipt: views receipt
- Seller pages → Manage catalog: adds books
- Seller pages → Remove books: removes books
- Seller pages → Update books: updates stock
- Seller pages → Store books: views inventory
- Login → User operations: authenticates (evidence: `src/main/java/servlets/CustomerLoginServlet.java`)
- Registration → User operations: registers user (evidence: `src/main/java/servlets/CustomerRegisterServlet.java`)
- User operations → User model: builds user (evidence: `src/main/java/com/bittercode/service/impl/UserServiceImpl.java`)
- Browse books → Book operations: loads books (evidence: `src/main/java/servlets/ViewBookServlet.java`)
- Cart updates → Book operations: loads books (evidence: `src/main/java/servlets/CartServlet.java`)
- Buy books → Book operations: updates stock (evidence: `src/main/java/servlets/BuyBooksServlet.java`)
- Payment processing → Book operations: uses book data (evidence: `src/main/java/servlets/ProcessPaymentServlet.java`)
- Receipt → Book operations: loads receipt data (evidence: `src/main/java/servlets/ReceiptServlet.java`)
- Manage catalog → Book operations: adds book (evidence: `src/main/java/servlets/AddBookServlet.java`)
- Remove books → Book operations: deletes book (evidence: `src/main/java/servlets/RemoveBookServlet.java`)
- Update books → Book operations: updates book (evidence: `src/main/java/servlets/UpdateBookServlet.java`)
- Store books → Book operations: manages inventory (evidence: `src/main/java/servlets/StoreBookServlet.java`)
- Book operations → Book model: creates books (evidence: `src/main/java/com/bittercode/service/impl/BookServiceImpl.java`)
- Book operations → JDBC connection: gets connection (evidence: `src/main/java/com/bittercode/service/impl/BookServiceImpl.java`)
- User operations → JDBC connection: gets connection (evidence: `src/main/java/com/bittercode/service/impl/UserServiceImpl.java`)
- JDBC connection → Database configuration: loads settings (evidence: `src/main/java/com/bittercode/util/DBUtil.java`)
- JDBC connection → MySQL database: connects to (evidence: `README.md`)
