# stiroy/hi1031-lab1 architecture

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

- Interactive diagram: https://gitdiagram.com/stiroy/hi1031-lab1
- Repository: https://github.com/stiroy/hi1031-lab1

## Overview

This is a Java servlet/JSP storefront with customer shopping and checkout, plus admin catalog/user management and employee order packing. The documented customer path runs through the servlet dispatcher, cart session and checkout controller into the model and persistence layer; admin and employee actions share that model boundary. The source index and excerpts establish several controller, facade and DAO relationships; README-only capabilities are retained, but their unsampled wiring is shown as unverified. Authentication and role enforcement are documented requirements, not confirmed implementation details in the excerpts.

Main entry points: [`src/main/java/kth/lab1/UI/UIHandler.java`](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/UIHandler.java) (Request dispatcher), [`src/main/java/kth/lab1/Model/ModelFacade.java`](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/Model/ModelFacade.java) (Model facade), [`src/main/java/kth/lab1/DB/DBManager.java`](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/DB/DBManager.java) (Connection pool), [`src/main/java/kth/lab1/UI/controller/CartController.java`](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/CartController.java) (Cart and checkout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interaction"]
  node_dispatcher["Request dispatcher<br/>[UIHandler.java]"]
  node_cart["Cart and checkout"]
  node_userctl["Account and orders"]
  node_productctl["Catalog browsing"]
  node_adminctl["Admin management"]
  node_employeectl["Order packing"]
  node_session["Login / session"]
end

subgraph group_domain["Store operations"]
  node_facade["Model facade<br/>[ModelFacade.java]"]
  node_productlogic["Product rules"]
  node_orderlogic["Order rules<br/>[OrderHandler.java]"]
  node_userlogic["User rules<br/>[UserHandler.java]"]
  node_dto["View data objects"]
end

subgraph group_persistence["Persistence"]
  node_productdao["Product DAO<br/>[ProductDAO.java]"]
  node_orderdao["Order DAO<br/>[OrderDAO.java]"]
  node_userdao["User DAO<br/>[UserDAO.java]"]
  node_dbmanager["Connection pool<br/>[DBManager.java]"]
  node_database[("PostgreSQL store")]
end

subgraph group_views["Web views"]
  node_customerpages["Customer pages"]
  node_adminpages["Admin pages"]
  node_employeepages["Employee pages"]
end

node_customer(("Customer"))
node_staff(("Admin / employee"))

node_customer -->|"sends requests"| node_dispatcher
node_staff -.->|"sends requests"| node_dispatcher
node_dispatcher -->|"dispatches cart"| node_cart
node_dispatcher -->|"dispatches account"| node_userctl
node_dispatcher -->|"dispatches catalog"| node_productctl
node_dispatcher -->|"dispatches admin"| node_adminctl
node_dispatcher -->|"dispatches packing"| node_employeectl
node_dispatcher -->|"dispatches session"| node_session
node_dispatcher -->|"forwards views"| node_customerpages
node_dispatcher -->|"forwards views"| node_adminpages
node_dispatcher -->|"forwards views"| node_employeepages
node_cart -->|"places orders"| node_facade
node_cart -->|"uses cart DTOs"| node_dto
node_adminctl -->|"manages catalog"| node_facade
node_adminctl -->|"uses view DTOs"| node_dto
node_productctl -->|"queries catalog"| node_facade
node_userctl -->|"queries account"| node_facade
node_employeectl -->|"packs orders"| node_facade
node_facade -->|"delegates products"| node_productlogic
node_facade -->|"delegates orders"| node_orderlogic
node_facade -->|"delegates users"| node_userlogic
node_facade -->|"maps data"| node_dto
node_productlogic -.->|"uses repository"| node_productdao
node_orderlogic -.->|"uses repository"| node_orderdao
node_userlogic -.->|"uses repository"| node_userdao
node_productdao -->|"gets connections"| node_dbmanager
node_orderdao -->|"gets connections"| node_dbmanager
node_userdao -->|"gets connections"| node_dbmanager
node_dbmanager -->|"connects PostgreSQL"| node_database
node_customer -.->|"authenticates"| node_session
node_staff -.->|"authenticates"| node_session

click node_dispatcher "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/UIHandler.java"
click node_cart "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/CartController.java"
click node_userctl "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/UserController.java"
click node_productctl "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/ProductController.java"
click node_adminctl "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/AdminController.java"
click node_employeectl "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/EmployeeController.java"
click node_session "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/SessionController.java"
click node_facade "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/Model/ModelFacade.java"
click node_productlogic "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/Model/handlers/ProductHandler.java"
click node_orderlogic "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/Model/handlers/OrderHandler.java"
click node_userlogic "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/Model/handlers/UserHandler.java"
click node_dto "https://github.com/stiroy/hi1031-lab1/tree/main/src/main/java/kth/lab1/UI/DTO"
click node_productdao "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/DB/DAO/ProductDAO.java"
click node_orderdao "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/DB/DAO/OrderDAO.java"
click node_userdao "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/DB/DAO/UserDAO.java"
click node_dbmanager "https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/DB/DBManager.java"
click node_customerpages "https://github.com/stiroy/hi1031-lab1/tree/main/src/main/webapp/WEB-INF/views"
click node_adminpages "https://github.com/stiroy/hi1031-lab1/tree/main/src/main/webapp/WEB-INF/admin"
click node_employeepages "https://github.com/stiroy/hi1031-lab1/tree/main/src/main/webapp/WEB-INF/employee"

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_dispatcher,node_cart,node_userctl,node_productctl,node_adminctl,node_employeectl,node_session toneBlue
class node_facade,node_productlogic,node_orderlogic,node_userlogic,node_dto toneAmber
class node_productdao,node_orderdao,node_userdao,node_dbmanager,node_database toneMint
class node_customerpages,node_adminpages,node_employeepages toneRose
class node_customer,node_staff toneIndigo
```

## Components

### Web interaction

- [Request dispatcher](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/UIHandler.java): `src/main/java/kth/lab1/UI/UIHandler.java`
- [Cart and checkout](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/CartController.java): `src/main/java/kth/lab1/UI/controller/CartController.java`
- [Account and orders](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/UserController.java): `src/main/java/kth/lab1/UI/controller/UserController.java`
- [Catalog browsing](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/ProductController.java): `src/main/java/kth/lab1/UI/controller/ProductController.java`
- [Admin management](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/AdminController.java): `src/main/java/kth/lab1/UI/controller/AdminController.java`
- [Order packing](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/EmployeeController.java): `src/main/java/kth/lab1/UI/controller/EmployeeController.java`
- [Login / session](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/UI/controller/SessionController.java): `src/main/java/kth/lab1/UI/controller/SessionController.java`

### Store operations

- [Model facade](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/Model/ModelFacade.java): `src/main/java/kth/lab1/Model/ModelFacade.java`
- [Product rules](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/Model/handlers/ProductHandler.java): `src/main/java/kth/lab1/Model/handlers/ProductHandler.java`
- [Order rules](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/Model/handlers/OrderHandler.java): `src/main/java/kth/lab1/Model/handlers/OrderHandler.java`
- [User rules](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/Model/handlers/UserHandler.java): `src/main/java/kth/lab1/Model/handlers/UserHandler.java`
- [View data objects](https://github.com/stiroy/hi1031-lab1/tree/main/src/main/java/kth/lab1/UI/DTO): `src/main/java/kth/lab1/UI/DTO`

### Persistence

- [Product DAO](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/DB/DAO/ProductDAO.java): `src/main/java/kth/lab1/DB/DAO/ProductDAO.java`
- [Order DAO](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/DB/DAO/OrderDAO.java): `src/main/java/kth/lab1/DB/DAO/OrderDAO.java`
- [User DAO](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/DB/DAO/UserDAO.java): `src/main/java/kth/lab1/DB/DAO/UserDAO.java`
- [Connection pool](https://github.com/stiroy/hi1031-lab1/blob/main/src/main/java/kth/lab1/DB/DBManager.java): `src/main/java/kth/lab1/DB/DBManager.java`
- **PostgreSQL store**

### Web views

- [Customer pages](https://github.com/stiroy/hi1031-lab1/tree/main/src/main/webapp/WEB-INF/views): `src/main/webapp/WEB-INF/views`
- [Admin pages](https://github.com/stiroy/hi1031-lab1/tree/main/src/main/webapp/WEB-INF/admin): `src/main/webapp/WEB-INF/admin`
- [Employee pages](https://github.com/stiroy/hi1031-lab1/tree/main/src/main/webapp/WEB-INF/employee): `src/main/webapp/WEB-INF/employee`

### Other components

- **Customer**
- **Admin / employee**

## Connections

- Customer → Request dispatcher: sends requests (evidence: `src/main/java/kth/lab1/UI/UIHandler.java`)
- Admin / employee → Request dispatcher: sends requests
- Request dispatcher → Cart and checkout: dispatches cart (evidence: `src/main/java/kth/lab1/UI/UIHandler.java`)
- Request dispatcher → Account and orders: dispatches account (evidence: `src/main/java/kth/lab1/UI/UIHandler.java`)
- Request dispatcher → Catalog browsing: dispatches catalog (evidence: `src/main/java/kth/lab1/UI/UIHandler.java`)
- Request dispatcher → Admin management: dispatches admin (evidence: `src/main/java/kth/lab1/UI/UIHandler.java`)
- Request dispatcher → Order packing: dispatches packing (evidence: `src/main/java/kth/lab1/UI/UIHandler.java`)
- Request dispatcher → Login / session: dispatches session (evidence: `src/main/java/kth/lab1/UI/UIHandler.java`)
- Request dispatcher → Customer pages: forwards views (evidence: `src/main/java/kth/lab1/UI/UIHandler.java`)
- Request dispatcher → Admin pages: forwards views (evidence: `src/main/java/kth/lab1/UI/UIHandler.java`)
- Request dispatcher → Employee pages: forwards views (evidence: `src/main/java/kth/lab1/UI/UIHandler.java`)
- Cart and checkout → Model facade: places orders (evidence: `src/main/java/kth/lab1/UI/controller/CartController.java`)
- Cart and checkout → View data objects: uses cart DTOs (evidence: `src/main/java/kth/lab1/UI/controller/CartController.java`)
- Admin management → Model facade: manages catalog (evidence: `src/main/java/kth/lab1/UI/controller/AdminController.java`)
- Admin management → View data objects: uses view DTOs (evidence: `src/main/java/kth/lab1/UI/controller/AdminController.java`)
- Catalog browsing → Model facade: queries catalog (evidence: `src/main/java/kth/lab1/UI/controller/ProductController.java`)
- Account and orders → Model facade: queries account (evidence: `src/main/java/kth/lab1/UI/controller/UserController.java`)
- Order packing → Model facade: packs orders (evidence: `src/main/java/kth/lab1/UI/controller/EmployeeController.java`)
- Model facade → Product rules: delegates products (evidence: `src/main/java/kth/lab1/Model/ModelFacade.java`)
- Model facade → Order rules: delegates orders (evidence: `src/main/java/kth/lab1/Model/ModelFacade.java`)
- Model facade → User rules: delegates users (evidence: `src/main/java/kth/lab1/Model/ModelFacade.java`)
- Model facade → View data objects: maps data (evidence: `src/main/java/kth/lab1/Model/ModelFacade.java`)
- Product rules → Product DAO: uses repository
- Order rules → Order DAO: uses repository
- User rules → User DAO: uses repository
- Product DAO → Connection pool: gets connections (evidence: `src/main/java/kth/lab1/DB/DAO/ProductDAO.java`)
- Order DAO → Connection pool: gets connections (evidence: `src/main/java/kth/lab1/DB/DAO/OrderDAO.java`)
- User DAO → Connection pool: gets connections (evidence: `src/main/java/kth/lab1/DB/DAO/UserDAO.java`)
- Connection pool → PostgreSQL store: connects PostgreSQL (evidence: `src/main/java/kth/lab1/DB/DBManager.java`)
- Customer → Login / session: authenticates
- Admin / employee → Login / session: authenticates
