# grandevx/duckduckstore architecture

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

- Interactive diagram: https://gitdiagram.com/grandevx/duckduckstore
- Repository: https://github.com/grandevx/duckduckstore

## Overview

DuckDuckStore is a Java/JSP e-commerce application for browsing and managing collectible products, user accounts, carts, and orders. The main customer flow runs from catalog/search and cart through address and payment checkout to a persisted order and order history; administrators also manage products, orders, and users. The graph reflects sampled servlet/DAO relationships and README capabilities; some view routing and unsampled subsystem wiring are not shown.

Main entry points: [`src/main/java/model/ProdottoDAO.java`](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/ProdottoDAO.java) (Product DAO), [`src/main/java/model/Carrello.java`](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Carrello.java) (Cart Model), [`src/main/java/controller/CheckoutServlet.java`](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/CheckoutServlet.java) (Checkout), [`src/main/java/model/UtenteDAO.java`](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/UtenteDAO.java) (User DAO)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shopping["Shopping"]
  node_catalog["Catalog and Search"]
  node_product["Product Detail"]
  node_cart["Cart<br/>[CartServlet.java]"]
  node_cartmodel["Cart Model<br/>[Carrello.java]"]
  node_productmodel["Product Model<br/>[Prodotto.java]"]
  node_views["JSP Views"]
end

subgraph group_accounts["Accounts"]
  node_accountsflow["Account Access"]
  node_user["User Model<br/>[Utente.java]"]
  node_userdao["User DAO<br/>[UtenteDAO.java]"]
end

subgraph group_orders["Checkout and Orders"]
  node_checkout["Checkout"]
  node_address["Delivery Address"]
  node_payment["Card Payment<br/>[InfoPagamento.java]"]
  node_order["Order Model<br/>[Ordine.java]"]
  node_orderdao["Order DAO<br/>[OrdineDAO.java]"]
  node_invoice["Invoice Generator"]
  node_history["Order History"]
end

subgraph group_management["Administration and Data"]
  node_productdao["Product DAO<br/>[ProdottoDAO.java]"]
  node_admin["Admin Operations"]
  node_productadmin["Product Management"]
  node_utilities["Serialization and Hashing<br/>[Utilities.java]"]
  node_pool["Connection Pool<br/>[ConPool.java]"]
  node_database[("MySQL")]
end

node_shopper(("Shopper"))

node_shopper -->|"browses"| node_catalog
node_shopper -->|"registers or logs in"| node_accountsflow
node_shopper -->|"updates"| node_cart
node_shopper -->|"checks out"| node_checkout
node_catalog -->|"retrieves products"| node_productdao
node_product -->|"retrieves product"| node_productdao
node_cart -->|"updates"| node_cartmodel
node_cart -->|"retrieves products"| node_productdao
node_cartmodel -->|"checks stock"| node_productdao
node_accountsflow -->|"authenticates or saves"| node_userdao
node_userdao -->|"hashes passwords"| node_utilities
node_checkout -->|"validates address"| node_address
node_checkout -->|"loads saved address"| node_orderdao
node_checkout -->|"reads cart"| node_cartmodel
node_checkout -->|"validates payment"| node_payment
node_cartmodel -->|"updates stock"| node_productdao
node_cartmodel -->|"updates balance"| node_userdao
node_cartmodel -->|"saves order"| node_orderdao
node_cartmodel -->|"serializes receipt"| node_utilities
node_history -->|"retrieves orders"| node_orderdao
node_admin -->|"retrieves users"| node_userdao
node_admin -->|"retrieves products"| node_productdao
node_admin -->|"retrieves orders"| node_orderdao
node_productadmin -->|"manages products"| node_productdao
node_productdao -->|"gets connection"| node_pool
node_userdao -->|"gets connection"| node_pool
node_orderdao -->|"gets connection"| node_pool
node_pool -->|"connects to"| node_database
node_checkout -->|"generates invoice"| node_invoice
node_shopper -.->|"receives pages"| node_views

click node_catalog "https://github.com/grandevx/duckduckstore/tree/main/src/main/java/controller"
click node_product "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/VisualizzaProdottoServlet.java"
click node_cart "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/CartServlet.java"
click node_cartmodel "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Carrello.java"
click node_productmodel "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Prodotto.java"
click node_productdao "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/ProdottoDAO.java"
click node_accountsflow "https://github.com/grandevx/duckduckstore/tree/main/src/main/java/controller"
click node_user "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Utente.java"
click node_userdao "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/UtenteDAO.java"
click node_checkout "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/CheckoutServlet.java"
click node_address "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/IndirizzoConsegna.java"
click node_payment "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/InfoPagamento.java"
click node_order "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Ordine.java"
click node_orderdao "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/OrdineDAO.java"
click node_invoice "https://github.com/grandevx/duckduckstore/blob/main/src/main/webapp/js/invoice-generator.js"
click node_history "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/StoricoOrdiniServlet.java"
click node_admin "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/ListaAdminServlet.java"
click node_productadmin "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/GestioneProdottoServlet.java"
click node_utilities "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Utilities.java"
click node_pool "https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/ConPool.java"
click node_views "https://github.com/grandevx/duckduckstore/tree/main/src/main/webapp/WEB-INF"

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_catalog,node_product,node_cart,node_cartmodel,node_productmodel,node_views toneBlue
class node_accountsflow,node_user,node_userdao toneAmber
class node_checkout,node_address,node_payment,node_order,node_orderdao,node_invoice,node_history toneMint
class node_productdao,node_admin,node_productadmin,node_utilities,node_pool,node_database toneRose
class node_shopper toneIndigo
```

## Components

### Shopping

- [Catalog and Search](https://github.com/grandevx/duckduckstore/tree/main/src/main/java/controller): `src/main/java/controller`
- [Product Detail](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/VisualizzaProdottoServlet.java): `src/main/java/controller/VisualizzaProdottoServlet.java`
- [Cart](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/CartServlet.java): `src/main/java/controller/CartServlet.java`
- [Cart Model](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Carrello.java): `src/main/java/model/Carrello.java`
- [Product Model](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Prodotto.java): `src/main/java/model/Prodotto.java`
- [JSP Views](https://github.com/grandevx/duckduckstore/tree/main/src/main/webapp/WEB-INF): `src/main/webapp/WEB-INF`

### Accounts

- [Account Access](https://github.com/grandevx/duckduckstore/tree/main/src/main/java/controller): `src/main/java/controller`
- [User Model](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Utente.java): `src/main/java/model/Utente.java`
- [User DAO](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/UtenteDAO.java): `src/main/java/model/UtenteDAO.java`

### Checkout and Orders

- [Checkout](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/CheckoutServlet.java): `src/main/java/controller/CheckoutServlet.java`
- [Delivery Address](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/IndirizzoConsegna.java): `src/main/java/model/IndirizzoConsegna.java`
- [Card Payment](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/InfoPagamento.java): `src/main/java/model/InfoPagamento.java`
- [Order Model](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Ordine.java): `src/main/java/model/Ordine.java`
- [Order DAO](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/OrdineDAO.java): `src/main/java/model/OrdineDAO.java`
- [Invoice Generator](https://github.com/grandevx/duckduckstore/blob/main/src/main/webapp/js/invoice-generator.js): `src/main/webapp/js/invoice-generator.js`
- [Order History](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/StoricoOrdiniServlet.java): `src/main/java/controller/StoricoOrdiniServlet.java`

### Administration and Data

- [Product DAO](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/ProdottoDAO.java): `src/main/java/model/ProdottoDAO.java`
- [Admin Operations](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/ListaAdminServlet.java): `src/main/java/controller/ListaAdminServlet.java`
- [Product Management](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/controller/GestioneProdottoServlet.java): `src/main/java/controller/GestioneProdottoServlet.java`
- [Serialization and Hashing](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/Utilities.java): `src/main/java/model/Utilities.java`
- [Connection Pool](https://github.com/grandevx/duckduckstore/blob/main/src/main/java/model/ConPool.java): `src/main/java/model/ConPool.java`
- **MySQL**

### Other components

- **Shopper**

## Connections

- Shopper → Catalog and Search: browses (evidence: `README.md`)
- Shopper → Account Access: registers or logs in (evidence: `README.md`)
- Shopper → Cart: updates (evidence: `README.md`)
- Shopper → Checkout: checks out (evidence: `README.md`)
- Catalog and Search → Product DAO: retrieves products (evidence: `src/main/java/controller/SearchServlet.java`)
- Product Detail → Product DAO: retrieves product (evidence: `src/main/java/controller/VisualizzaProdottoServlet.java`)
- Cart → Cart Model: updates (evidence: `src/main/java/controller/CartServlet.java`)
- Cart → Product DAO: retrieves products (evidence: `src/main/java/controller/CartServlet.java`)
- Cart Model → Product DAO: checks stock (evidence: `src/main/java/model/Carrello.java`)
- Account Access → User DAO: authenticates or saves (evidence: `src/main/java/controller/LoginServlet.java`)
- User DAO → Serialization and Hashing: hashes passwords (evidence: `src/main/java/model/UtenteDAO.java`)
- Checkout → Delivery Address: validates address (evidence: `src/main/java/controller/CheckoutServlet.java`)
- Checkout → Order DAO: loads saved address (evidence: `src/main/java/controller/CheckoutServlet.java`)
- Checkout → Cart Model: reads cart (evidence: `src/main/java/controller/CheckoutServlet.java`)
- Checkout → Card Payment: validates payment (evidence: `src/main/java/controller/CheckoutServlet.java`)
- Cart Model → Product DAO: updates stock (evidence: `src/main/java/model/Carrello.java`)
- Cart Model → User DAO: updates balance (evidence: `src/main/java/model/Carrello.java`)
- Cart Model → Order DAO: saves order (evidence: `src/main/java/model/Carrello.java`)
- Cart Model → Serialization and Hashing: serializes receipt (evidence: `src/main/java/model/Carrello.java`)
- Order History → Order DAO: retrieves orders (evidence: `src/main/java/controller/StoricoOrdiniServlet.java`)
- Admin Operations → User DAO: retrieves users (evidence: `src/main/java/controller/ListaAdminServlet.java`)
- Admin Operations → Product DAO: retrieves products (evidence: `src/main/java/controller/ListaAdminServlet.java`)
- Admin Operations → Order DAO: retrieves orders (evidence: `src/main/java/controller/ListaAdminServlet.java`)
- Product Management → Product DAO: manages products (evidence: `src/main/java/controller/GestioneProdottoServlet.java`)
- Product DAO → Connection Pool: gets connection (evidence: `src/main/java/model/ProdottoDAO.java`)
- User DAO → Connection Pool: gets connection (evidence: `src/main/java/model/UtenteDAO.java`)
- Order DAO → Connection Pool: gets connection (evidence: `src/main/java/model/OrdineDAO.java`)
- Connection Pool → MySQL: connects to (evidence: `src/main/java/model/ConPool.java`)
- Checkout → Invoice Generator: generates invoice (evidence: `README.md`)
- Shopper → JSP Views: receives pages
