# dennisbica/fishshoplab1 architecture

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

- Interactive diagram: https://gitdiagram.com/dennisbica/fishshoplab1
- Repository: https://github.com/dennisbica/fishshoplab1

## Overview

This is a Java web shop with catalog browsing and administration, user authentication and administration, shopping-cart management, and order processing. The principal workflow enters through the servlet, crosses a facade and business handlers, and uses database access classes for persistence; cart contents are represented in UI DTOs before order creation. The README is empty. The source index and excerpts support the core layers, but the JSP routing and some business-to-database calls are not shown, so those links are omitted or marked unverified.

Main entry points: [`src/bo/facade.java`](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/facade.java) (Shop facade), [`src/db/DBManager.java`](https://github.com/dennisbica/fishshoplab1/blob/main/src/db/DBManager.java) (Connection manager), [`src/ui/MainServlet.java`](https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/MainServlet.java) (Main servlet), [`src/bo/ItemHandler.java`](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/ItemHandler.java) (Catalog handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry and views"]
  node_servlet["Main servlet<br/>[MainServlet.java]"]
  node_views["Shop and admin pages"]
  node_item_dto["Item data<br/>[ItemInfo.java]"]
  node_user_dto["User data<br/>[UserInfo.java]"]
  node_cart_dto["Cart data"]
  node_order_dto["Order data<br/>[OrderInfo.java]"]
end

subgraph group_business["Business operations"]
  node_facade["Shop facade<br/>[facade.java]"]
  node_item_handler["Catalog handler<br/>[ItemHandler.java]"]
  node_item_model["Catalog item<br/>[Item.java]"]
  node_user_handler["User handler<br/>[UserHandler.java]"]
  node_user_model["User model<br/>[User.java]"]
  node_cart_handler["Cart handler<br/>[CartHandler.java]"]
  node_cart_model["Shopping cart<br/>[ShoppingCart.java]"]
  node_order_handler["Order handler<br/>[OrderHandler.java]"]
  node_order_model["Order model<br/>[Order.java]"]
end

subgraph group_data["Persistence"]
  node_item_db["Catalog persistence<br/>[ItemDB.java]"]
  node_user_db["User persistence<br/>[UserDB.java]"]
  node_order_db["Order persistence<br/>[OrderDB.java]"]
  node_db_manager["Connection manager<br/>[DBManager.java]"]
end

node_shopper(("Shopper or admin"))
node_mysql[("MySQL shop database")]

node_shopper -->|"uses"| node_servlet
node_servlet -->|"dispatches"| node_facade
node_facade -->|"delegates"| node_item_handler
node_facade -->|"delegates"| node_user_handler
node_facade -->|"delegates"| node_cart_handler
node_facade -->|"delegates"| node_order_handler
node_item_handler -->|"converts"| node_item_model
node_user_handler -->|"converts"| node_user_model
node_order_handler -->|"converts"| node_order_model
node_cart_handler -->|"updates"| node_cart_model
node_cart_handler -->|"updates"| node_cart_dto
node_item_handler -->|"maps"| node_item_dto
node_user_handler -->|"maps"| node_user_dto
node_order_handler -->|"maps"| node_order_dto
node_item_model -->|"delegates"| node_item_db
node_user_model -->|"delegates"| node_user_db
node_order_model -->|"delegates"| node_order_db
node_item_db -->|"gets connection"| node_db_manager
node_user_db -->|"gets connection"| node_db_manager
node_order_db -->|"gets connection"| node_db_manager
node_db_manager -->|"connects"| node_mysql
node_servlet -.->|"routes to"| node_views

click node_servlet "https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/MainServlet.java"
click node_views "https://github.com/dennisbica/fishshoplab1/tree/main/web"
click node_facade "https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/facade.java"
click node_item_handler "https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/ItemHandler.java"
click node_item_model "https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/Item.java"
click node_user_handler "https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/UserHandler.java"
click node_user_model "https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/User.java"
click node_cart_handler "https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/CartHandler.java"
click node_cart_model "https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/ShoppingCart.java"
click node_order_handler "https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/OrderHandler.java"
click node_order_model "https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/Order.java"
click node_item_dto "https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/ItemInfo.java"
click node_user_dto "https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/UserInfo.java"
click node_cart_dto "https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/ShoppingCartInfo.java"
click node_order_dto "https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/OrderInfo.java"
click node_item_db "https://github.com/dennisbica/fishshoplab1/blob/main/src/db/ItemDB.java"
click node_user_db "https://github.com/dennisbica/fishshoplab1/blob/main/src/db/UserDB.java"
click node_order_db "https://github.com/dennisbica/fishshoplab1/blob/main/src/db/OrderDB.java"
click node_db_manager "https://github.com/dennisbica/fishshoplab1/blob/main/src/db/DBManager.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_servlet,node_views,node_item_dto,node_user_dto,node_cart_dto,node_order_dto toneBlue
class node_facade,node_item_handler,node_item_model,node_user_handler,node_user_model,node_cart_handler,node_cart_model,node_order_handler,node_order_model,node_mysql toneAmber
class node_item_db,node_user_db,node_order_db,node_db_manager toneMint
class node_shopper toneIndigo
```

## Components

### Web entry and views

- [Main servlet](https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/MainServlet.java): `src/ui/MainServlet.java`
- [Shop and admin pages](https://github.com/dennisbica/fishshoplab1/tree/main/web): `web`
- [Item data](https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/ItemInfo.java): `src/ui/ItemInfo.java`
- [User data](https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/UserInfo.java): `src/ui/UserInfo.java`
- [Cart data](https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/ShoppingCartInfo.java): `src/ui/ShoppingCartInfo.java`
- [Order data](https://github.com/dennisbica/fishshoplab1/blob/main/src/ui/OrderInfo.java): `src/ui/OrderInfo.java`

### Business operations

- [Shop facade](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/facade.java): `src/bo/facade.java`
- [Catalog handler](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/ItemHandler.java): `src/bo/ItemHandler.java`
- [Catalog item](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/Item.java): `src/bo/Item.java`
- [User handler](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/UserHandler.java): `src/bo/UserHandler.java`
- [User model](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/User.java): `src/bo/User.java`
- [Cart handler](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/CartHandler.java): `src/bo/CartHandler.java`
- [Shopping cart](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/ShoppingCart.java): `src/bo/ShoppingCart.java`
- [Order handler](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/OrderHandler.java): `src/bo/OrderHandler.java`
- [Order model](https://github.com/dennisbica/fishshoplab1/blob/main/src/bo/Order.java): `src/bo/Order.java`

### Persistence

- [Catalog persistence](https://github.com/dennisbica/fishshoplab1/blob/main/src/db/ItemDB.java): `src/db/ItemDB.java`
- [User persistence](https://github.com/dennisbica/fishshoplab1/blob/main/src/db/UserDB.java): `src/db/UserDB.java`
- [Order persistence](https://github.com/dennisbica/fishshoplab1/blob/main/src/db/OrderDB.java): `src/db/OrderDB.java`
- [Connection manager](https://github.com/dennisbica/fishshoplab1/blob/main/src/db/DBManager.java): `src/db/DBManager.java`

### Other components

- **Shopper or admin**
- **MySQL shop database**

## Connections

- Shopper or admin → Main servlet: uses
- Main servlet → Shop facade: dispatches (evidence: `src/ui/MainServlet.java`)
- Shop facade → Catalog handler: delegates (evidence: `src/bo/facade.java`)
- Shop facade → User handler: delegates (evidence: `src/bo/facade.java`)
- Shop facade → Cart handler: delegates (evidence: `src/bo/facade.java`)
- Shop facade → Order handler: delegates (evidence: `src/bo/facade.java`)
- Catalog handler → Catalog item: converts (evidence: `src/bo/ItemHandler.java`)
- User handler → User model: converts (evidence: `src/bo/UserHandler.java`)
- Order handler → Order model: converts (evidence: `src/bo/OrderHandler.java`)
- Cart handler → Shopping cart: updates (evidence: `src/bo/CartHandler.java`)
- Cart handler → Cart data: updates (evidence: `src/bo/CartHandler.java`)
- Catalog handler → Item data: maps (evidence: `src/bo/ItemHandler.java`)
- User handler → User data: maps (evidence: `src/bo/UserHandler.java`)
- Order handler → Order data: maps (evidence: `src/bo/OrderHandler.java`)
- Catalog item → Catalog persistence: delegates (evidence: `src/bo/Item.java`)
- User model → User persistence: delegates (evidence: `src/bo/User.java`)
- Order model → Order persistence: delegates (evidence: `src/bo/Order.java`)
- Catalog persistence → Connection manager: gets connection (evidence: `src/db/ItemDB.java`)
- User persistence → Connection manager: gets connection (evidence: `src/db/UserDB.java`)
- Order persistence → Connection manager: gets connection (evidence: `src/db/OrderDB.java`)
- Connection manager → MySQL shop database: connects (evidence: `src/db/DBManager.java`)
- Main servlet → Shop and admin pages: routes to
