# serahmad/webshop architecture

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

- Interactive diagram: https://gitdiagram.com/serahmad/webshop
- Repository: https://github.com/serahmad/webshop

## Overview

This is a Java servlet web shop: users browse items, add them to a session cart, and can log in or out. Item and cart handlers assemble view data; login validates credentials through the user model. Item and user records are loaded from MySQL through dedicated database classes. The graph includes the JSP views and schema as product components, but their runtime wiring is not shown in the sampled source, so no view-dispatch edges are asserted.

Main entry points: [`src/main/java/se/kth/webshop/bo/CartHandler.java`](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/CartHandler.java) (Cart handler), [`src/main/java/se/kth/webshop/ui/CartServlet.java`](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/CartServlet.java) (Cart servlet), [`src/main/java/se/kth/webshop/bo/ItemHandler.java`](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/ItemHandler.java) (Item handler), [`src/main/java/se/kth/webshop/bo/UserHandler.java`](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/UserHandler.java) (User handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_itemservlet["Item servlet<br/>[ItemServlet.java]"]
  node_cartservlet["Cart servlet<br/>[CartServlet.java]"]
  node_loginservlet["Login servlet<br/>[LoginServlet.java]"]
  node_logoutservlet["Logout servlet<br/>[LogoutServlet.java]"]
  node_itemview["Item view<br/>[items.jsp]"]
  node_cartview["Cart view<br/>[cart.jsp]"]
  node_loginview["Login view<br/>[login.jsp]"]
  node_homeview["Home page<br/>[index.jsp]"]
end

subgraph group_commerce["Shop logic"]
  node_itemhandler["Item handler<br/>[ItemHandler.java]"]
  node_itemmodel["Item model<br/>[Item.java]"]
  node_carthandler["Cart handler<br/>[CartHandler.java]"]
  node_cartmodel["Cart state<br/>[Cart.java]"]
  node_iteminfo["Item view data<br/>[ItemInfo.java]"]
  node_cartinfo["Cart line data<br/>[CartItemInfo.java]"]
end

subgraph group_identity["User identity"]
  node_userhandler["User handler<br/>[UserHandler.java]"]
  node_usermodel["User model<br/>[User.java]"]
  node_userinfo["User view data<br/>[UserInfo.java]"]
end

subgraph group_persistence["Persistence"]
  node_itemdb["Item queries<br/>[ItemDB.java]"]
  node_userdb["User queries<br/>[UserDB.java]"]
  node_dbmanager["Connection manager<br/>[DBManager.java]"]
  node_schema["Shop schema<br/>[schema.sql]"]
end

node_shopper(("Shopper"))
node_mysql[("MySQL")]

node_shopper -.->|"browses"| node_itemservlet
node_shopper -.->|"updates cart"| node_cartservlet
node_shopper -.->|"signs in"| node_loginservlet
node_shopper -.->|"signs out"| node_logoutservlet
node_itemservlet -->|"requests items"| node_itemhandler
node_itemhandler -->|"loads items"| node_itemmodel
node_itemhandler -->|"creates data"| node_iteminfo
node_itemmodel -->|"queries"| node_itemdb
node_itemdb -->|"gets connection"| node_dbmanager
node_itemdb -->|"reads items"| node_mysql
node_cartservlet -->|"handles cart"| node_carthandler
node_cartservlet -->|"uses cart"| node_cartmodel
node_carthandler -->|"reads and updates"| node_cartmodel
node_carthandler -->|"looks up items"| node_itemmodel
node_carthandler -->|"creates lines"| node_cartinfo
node_loginservlet -->|"authenticates"| node_userhandler
node_userhandler -->|"checks credentials"| node_usermodel
node_userhandler -->|"creates identity"| node_userinfo
node_usermodel -->|"loads user"| node_userdb
node_userdb -->|"gets connection"| node_dbmanager
node_userdb -->|"reads users"| node_mysql
node_dbmanager -->|"opens connection"| node_mysql

click node_itemservlet "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/ItemServlet.java"
click node_cartservlet "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/CartServlet.java"
click node_loginservlet "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/LoginServlet.java"
click node_logoutservlet "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/LogoutServlet.java"
click node_itemview "https://github.com/serahmad/webshop/blob/master/src/main/webapp/WEB-INF/jsp/items.jsp"
click node_cartview "https://github.com/serahmad/webshop/blob/master/src/main/webapp/WEB-INF/jsp/cart.jsp"
click node_loginview "https://github.com/serahmad/webshop/blob/master/src/main/webapp/WEB-INF/jsp/login.jsp"
click node_homeview "https://github.com/serahmad/webshop/blob/master/src/main/webapp/index.jsp"
click node_itemhandler "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/ItemHandler.java"
click node_itemmodel "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/Item.java"
click node_carthandler "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/CartHandler.java"
click node_cartmodel "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/Cart.java"
click node_iteminfo "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/ItemInfo.java"
click node_cartinfo "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/CartItemInfo.java"
click node_userhandler "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/UserHandler.java"
click node_usermodel "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/User.java"
click node_userinfo "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/UserInfo.java"
click node_itemdb "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/db/ItemDB.java"
click node_userdb "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/db/UserDB.java"
click node_dbmanager "https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/db/DBManager.java"
click node_schema "https://github.com/serahmad/webshop/blob/master/sql/schema.sql"

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_itemservlet,node_cartservlet,node_loginservlet,node_logoutservlet,node_itemview,node_cartview,node_loginview,node_homeview toneBlue
class node_itemhandler,node_itemmodel,node_carthandler,node_cartmodel,node_iteminfo,node_cartinfo,node_mysql toneAmber
class node_userhandler,node_usermodel,node_userinfo toneMint
class node_itemdb,node_userdb,node_dbmanager,node_schema toneRose
class node_shopper toneIndigo
```

## Components

### Web interface

- [Item servlet](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/ItemServlet.java): `src/main/java/se/kth/webshop/ui/ItemServlet.java`
- [Cart servlet](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/CartServlet.java): `src/main/java/se/kth/webshop/ui/CartServlet.java`
- [Login servlet](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/LoginServlet.java): `src/main/java/se/kth/webshop/ui/LoginServlet.java`
- [Logout servlet](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/LogoutServlet.java): `src/main/java/se/kth/webshop/ui/LogoutServlet.java`
- [Item view](https://github.com/serahmad/webshop/blob/master/src/main/webapp/WEB-INF/jsp/items.jsp): `src/main/webapp/WEB-INF/jsp/items.jsp`
- [Cart view](https://github.com/serahmad/webshop/blob/master/src/main/webapp/WEB-INF/jsp/cart.jsp): `src/main/webapp/WEB-INF/jsp/cart.jsp`
- [Login view](https://github.com/serahmad/webshop/blob/master/src/main/webapp/WEB-INF/jsp/login.jsp): `src/main/webapp/WEB-INF/jsp/login.jsp`
- [Home page](https://github.com/serahmad/webshop/blob/master/src/main/webapp/index.jsp): `src/main/webapp/index.jsp`

### Shop logic

- [Item handler](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/ItemHandler.java): `src/main/java/se/kth/webshop/bo/ItemHandler.java`
- [Item model](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/Item.java): `src/main/java/se/kth/webshop/bo/Item.java`
- [Cart handler](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/CartHandler.java): `src/main/java/se/kth/webshop/bo/CartHandler.java`
- [Cart state](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/Cart.java): `src/main/java/se/kth/webshop/bo/Cart.java`
- [Item view data](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/ItemInfo.java): `src/main/java/se/kth/webshop/ui/ItemInfo.java`
- [Cart line data](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/CartItemInfo.java): `src/main/java/se/kth/webshop/ui/CartItemInfo.java`

### User identity

- [User handler](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/UserHandler.java): `src/main/java/se/kth/webshop/bo/UserHandler.java`
- [User model](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/bo/User.java): `src/main/java/se/kth/webshop/bo/User.java`
- [User view data](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/ui/UserInfo.java): `src/main/java/se/kth/webshop/ui/UserInfo.java`

### Persistence

- [Item queries](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/db/ItemDB.java): `src/main/java/se/kth/webshop/db/ItemDB.java`
- [User queries](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/db/UserDB.java): `src/main/java/se/kth/webshop/db/UserDB.java`
- [Connection manager](https://github.com/serahmad/webshop/blob/master/src/main/java/se/kth/webshop/db/DBManager.java): `src/main/java/se/kth/webshop/db/DBManager.java`
- [Shop schema](https://github.com/serahmad/webshop/blob/master/sql/schema.sql): `sql/schema.sql`

### Other components

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

## Connections

- Shopper → Item servlet: browses
- Shopper → Cart servlet: updates cart
- Shopper → Login servlet: signs in
- Shopper → Logout servlet: signs out
- Item servlet → Item handler: requests items (evidence: `src/main/java/se/kth/webshop/ui/ItemServlet.java`)
- Item handler → Item model: loads items (evidence: `src/main/java/se/kth/webshop/bo/ItemHandler.java`)
- Item handler → Item view data: creates data (evidence: `src/main/java/se/kth/webshop/bo/ItemHandler.java`)
- Item model → Item queries: queries (evidence: `src/main/java/se/kth/webshop/bo/Item.java`)
- Item queries → Connection manager: gets connection (evidence: `src/main/java/se/kth/webshop/db/ItemDB.java`)
- Item queries → MySQL: reads items (evidence: `src/main/java/se/kth/webshop/db/ItemDB.java`)
- Cart servlet → Cart handler: handles cart (evidence: `src/main/java/se/kth/webshop/ui/CartServlet.java`)
- Cart servlet → Cart state: uses cart (evidence: `src/main/java/se/kth/webshop/ui/CartServlet.java`)
- Cart handler → Cart state: reads and updates (evidence: `src/main/java/se/kth/webshop/bo/CartHandler.java`)
- Cart handler → Item model: looks up items (evidence: `src/main/java/se/kth/webshop/bo/CartHandler.java`)
- Cart handler → Cart line data: creates lines (evidence: `src/main/java/se/kth/webshop/bo/CartHandler.java`)
- Login servlet → User handler: authenticates (evidence: `src/main/java/se/kth/webshop/ui/LoginServlet.java`)
- User handler → User model: checks credentials (evidence: `src/main/java/se/kth/webshop/bo/UserHandler.java`)
- User handler → User view data: creates identity (evidence: `src/main/java/se/kth/webshop/bo/UserHandler.java`)
- User model → User queries: loads user (evidence: `src/main/java/se/kth/webshop/bo/User.java`)
- User queries → Connection manager: gets connection (evidence: `src/main/java/se/kth/webshop/db/UserDB.java`)
- User queries → MySQL: reads users (evidence: `src/main/java/se/kth/webshop/db/UserDB.java`)
- Connection manager → MySQL: opens connection (evidence: `src/main/java/se/kth/webshop/db/DBManager.java`)
