# tzeshuo/tomcat-ebookshop architecture

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

- Interactive diagram: https://gitdiagram.com/tzeshuo/tomcat-ebookshop
- Repository: https://github.com/tzeshuo/tomcat-ebookshop
- Video tour (about a minute): https://gitdiagram.com/tzeshuo/tomcat-ebookshop/video

## Overview

This is a Java/Jakarta e-book shop with account registration and login, book browsing and search, a session-backed cart, and order placement. The principal workflow is to browse books, add selections to a cart, authenticate, and submit an order; the order handler checks stock and records purchases. Separate query-demo servlets expose alternative book-search forms. The excerpts show several direct database accesses and the auth-status fetch; much of the UI wiring and several servlet implementations were not sampled, so those links are omitted or marked unverified.

Main entry points: [`extra`](https://github.com/tzeshuo/tomcat-ebookshop/tree/main/extra) (Query pages), [`WEB-INF/classes/EShopRegisterServlet.java`](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EShopRegisterServlet.java) (Registration), [`WEB-INF/classes/EShopLoginServlet.java`](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EShopLoginServlet.java) (Login), [`WEB-INF/classes/EshopOrderServlet.java`](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EshopOrderServlet.java) (Place order)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts"]
  node_register["Registration"]
  node_login["Login"]
  node_logout["Logout"]
  node_authstatus["Auth status"]
end

subgraph group_shop["Shop and checkout"]
  node_display["Shop display"]
  node_addcart["Add to cart"]
  node_cart["Cart view<br/>[CartServlet.java]"]
  node_removecart["Remove item"]
  node_order["Place order"]
  node_shopdb[("Shop database")]
end

subgraph group_search["Book queries"]
  node_querymain["Book search API"]
  node_querysingle["Single query<br/>[QueryServlet.java]"]
  node_querypost["POST query"]
  node_querymulti["Multi-author query"]
  node_queryparam["Author-price query"]
  node_queryparamvalue["Multi-filter query"]
end

subgraph group_ui["Shop interface"]
  node_confirmation["Order confirmation<br/>[order-placed.html]"]
  node_queryui["Query pages"]
  node_cartui["Cart page<br/>[cart.html]"]
  node_shopui["Shop page<br/>[shop.html]"]
  node_loginui["Login page<br/>[login.html]"]
  node_registerui["Register page<br/>[register.html]"]
  node_authjs["Auth controls<br/>[auth.js]"]
end

node_shopper(("Shopper"))
node_db[("MySQL ebookshop")]

node_authjs -->|"fetches status"| node_authstatus
node_login -->|"redirects on success"| node_display
node_register -->|"redirects after registration"| node_loginui
node_order -->|"redirects with outcome"| node_confirmation
node_shopper -.->|"submits registration"| node_register
node_shopper -.->|"submits login"| node_login
node_shopper -.->|"opens shop"| node_display
node_shopper -.->|"adds books"| node_addcart
node_shopper -.->|"views cart"| node_cart
node_shopper -.->|"removes items"| node_removecart
node_shopper -.->|"submits order"| node_order
node_shopper -.->|"searches books"| node_querymain
node_shopper -.->|"uses query forms"| node_queryui
node_querymain -->|"queries books"| node_db
node_cart -->|"loads book details"| node_db
node_order -->|"reads and updates"| node_db
node_login -->|"checks credentials"| node_db
node_register -->|"inserts account"| node_db
node_querysingle -->|"queries books"| node_db
node_querypost -->|"queries books"| node_db
node_querymulti -->|"queries books"| node_db
node_queryparam -->|"queries books"| node_db
node_queryparamvalue -->|"queries books"| node_db
node_queryui -.->|"submits query"| node_querysingle
node_queryui -.->|"submits query"| node_querypost
node_queryui -.->|"submits query"| node_querymulti
node_queryui -.->|"submits query"| node_queryparam
node_queryui -.->|"submits query"| node_queryparamvalue

click node_register "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EShopRegisterServlet.java"
click node_login "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EShopLoginServlet.java"
click node_logout "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EShopLogoutServlet.java"
click node_authstatus "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/AuthStatusServlet.java"
click node_display "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EShopDisplayServlet.java"
click node_addcart "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/AddToCartServlet.java"
click node_cart "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/CartServlet.java"
click node_removecart "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/RemoveFromCartServlet.java"
click node_order "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EshopOrderServlet.java"
click node_confirmation "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/order-placed.html"
click node_querymain "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EshopQueryServlet.java"
click node_querysingle "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/extra/QueryServlet.java"
click node_querypost "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/extra/QueryPostServlet.java"
click node_querymulti "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/extra/QueryMultiValueServlet.java"
click node_queryparam "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/extra/QueryMultiParamServlet.java"
click node_queryparamvalue "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/extra/QueryMultiParamValueServlet.java"
click node_queryui "https://github.com/tzeshuo/tomcat-ebookshop/tree/main/extra"
click node_cartui "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/cart.html"
click node_shopui "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/shop.html"
click node_loginui "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/login.html"
click node_registerui "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/register.html"
click node_authjs "https://github.com/tzeshuo/tomcat-ebookshop/blob/main/auth.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_register,node_login,node_logout,node_authstatus toneBlue
class node_display,node_addcart,node_cart,node_removecart,node_order,node_shopdb,node_db toneAmber
class node_querymain,node_querysingle,node_querypost,node_querymulti,node_queryparam,node_queryparamvalue toneMint
class node_confirmation,node_queryui,node_cartui,node_shopui,node_loginui,node_registerui,node_authjs toneRose
class node_shopper toneIndigo
```

## Components

### Accounts

- [Registration](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EShopRegisterServlet.java): `WEB-INF/classes/EShopRegisterServlet.java`
- [Login](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EShopLoginServlet.java): `WEB-INF/classes/EShopLoginServlet.java`
- [Logout](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EShopLogoutServlet.java): `WEB-INF/classes/EShopLogoutServlet.java`
- [Auth status](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/AuthStatusServlet.java): `WEB-INF/classes/AuthStatusServlet.java`

### Shop and checkout

- [Shop display](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EShopDisplayServlet.java): `WEB-INF/classes/EShopDisplayServlet.java`
- [Add to cart](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/AddToCartServlet.java): `WEB-INF/classes/AddToCartServlet.java`
- [Cart view](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/CartServlet.java): `WEB-INF/classes/CartServlet.java`
- [Remove item](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/RemoveFromCartServlet.java): `WEB-INF/classes/RemoveFromCartServlet.java`
- [Place order](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EshopOrderServlet.java): `WEB-INF/classes/EshopOrderServlet.java`
- **Shop database**

### Book queries

- [Book search API](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/EshopQueryServlet.java): `WEB-INF/classes/EshopQueryServlet.java`
- [Single query](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/extra/QueryServlet.java): `WEB-INF/classes/extra/QueryServlet.java`
- [POST query](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/extra/QueryPostServlet.java): `WEB-INF/classes/extra/QueryPostServlet.java`
- [Multi-author query](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/extra/QueryMultiValueServlet.java): `WEB-INF/classes/extra/QueryMultiValueServlet.java`
- [Author-price query](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/extra/QueryMultiParamServlet.java): `WEB-INF/classes/extra/QueryMultiParamServlet.java`
- [Multi-filter query](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/WEB-INF/classes/extra/QueryMultiParamValueServlet.java): `WEB-INF/classes/extra/QueryMultiParamValueServlet.java`

### Shop interface

- [Order confirmation](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/order-placed.html): `order-placed.html`
- [Query pages](https://github.com/tzeshuo/tomcat-ebookshop/tree/main/extra): `extra`
- [Cart page](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/cart.html): `cart.html`
- [Shop page](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/shop.html): `shop.html`
- [Login page](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/login.html): `login.html`
- [Register page](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/register.html): `register.html`
- [Auth controls](https://github.com/tzeshuo/tomcat-ebookshop/blob/main/auth.js): `auth.js`

### Other components

- **Shopper**
- **MySQL ebookshop**

## Connections

- Auth controls → Auth status: fetches status (evidence: `auth.js`)
- Login → Shop display: redirects on success (evidence: `WEB-INF/classes/EShopLoginServlet.java`)
- Registration → Login page: redirects after registration (evidence: `WEB-INF/classes/EShopRegisterServlet.java`)
- Place order → Order confirmation: redirects with outcome (evidence: `WEB-INF/classes/EshopOrderServlet.java`)
- Shopper → Registration: submits registration
- Shopper → Login: submits login
- Shopper → Shop display: opens shop
- Shopper → Add to cart: adds books
- Shopper → Cart view: views cart
- Shopper → Remove item: removes items
- Shopper → Place order: submits order
- Shopper → Book search API: searches books
- Shopper → Query pages: uses query forms
- Book search API → MySQL ebookshop: queries books (evidence: `WEB-INF/classes/EshopQueryServlet.java`)
- Cart view → MySQL ebookshop: loads book details (evidence: `WEB-INF/classes/CartServlet.java`)
- Place order → MySQL ebookshop: reads and updates (evidence: `WEB-INF/classes/EshopOrderServlet.java`)
- Login → MySQL ebookshop: checks credentials (evidence: `WEB-INF/classes/EShopLoginServlet.java`)
- Registration → MySQL ebookshop: inserts account (evidence: `WEB-INF/classes/EShopRegisterServlet.java`)
- Single query → MySQL ebookshop: queries books (evidence: `WEB-INF/classes/extra/QueryServlet.java`)
- POST query → MySQL ebookshop: queries books (evidence: `WEB-INF/classes/extra/QueryPostServlet.java`)
- Multi-author query → MySQL ebookshop: queries books (evidence: `WEB-INF/classes/extra/QueryMultiValueServlet.java`)
- Author-price query → MySQL ebookshop: queries books (evidence: `WEB-INF/classes/extra/QueryMultiParamServlet.java`)
- Multi-filter query → MySQL ebookshop: queries books (evidence: `WEB-INF/classes/extra/QueryMultiParamValueServlet.java`)
- Query pages → Single query: submits query
- Query pages → POST query: submits query
- Query pages → Multi-author query: submits query
- Query pages → Author-price query: submits query
- Query pages → Multi-filter query: submits query
