# eddiore/hi1031-lab1 architecture

> Architecture diagram of the GitHub repository eddiore/hi1031-lab1, 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/eddiore/hi1031-lab1
- Repository: https://github.com/eddiore/hi1031-lab1

## Overview

This repository is a Java web shop, documented as a browser-accessible application with MongoDB and MySQL setup files. Its visible product areas include browsing, login/profile, cart and orders, plus administration and warehouse functions. The tree identifies the MVC-facing controllers, domain objects, and persistence modules, but their source was not sampled, so their call relationships cannot be verified. The only evidenced links are browser access documented in the README and MongoDB initialization shown in its setup script.

Main entry points: [`mongodb/setup_webshop.js`](https://github.com/eddiore/hi1031-lab1/blob/main/mongodb/setup_webshop.js) (Mongo initialization), [`src/main/java/org/example/ui/FrontController.java`](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/FrontController.java) (Front controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_front["Front controller"]
  node_views["JSP views"]
end

subgraph group_flows["Shop workflows"]
  node_login["Login and profile"]
  node_profile["Profile workflow"]
  node_cart["Cart workflow"]
  node_orders["Order workflow"]
  node_admin["Admin workflow"]
  node_warehouse["Warehouse workflow"]
end

subgraph group_domain["Shop domain"]
  node_facade["Business facade<br/>[Facade.java]"]
  node_items["Items<br/>[Item.java]"]
  node_order["Orders<br/>[Order.java]"]
  node_user["Users<br/>[User.java]"]
end

subgraph group_data["Persistence"]
  node_dbmanager["DB manager<br/>[DBManager.java]"]
  node_itemdb["Item persistence<br/>[ItemDB.java]"]
  node_orderdb["Order persistence<br/>[OrderDB.java]"]
  node_userdb["User persistence<br/>[UserDB.java]"]
  node_mongo[("MongoDB")]
  node_mongo_setup["Mongo initialization<br/>[setup_webshop.js]"]
end

node_browser(("Shopper"))

node_browser -->|"opens shop"| node_front
node_mongo_setup -->|"creates collections"| node_mongo

click node_front "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/FrontController.java"
click node_views "https://github.com/eddiore/hi1031-lab1/tree/main/src/main/webapp/WEB-INF/views"
click node_login "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/LoginController.java"
click node_profile "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/ProfileController.java"
click node_cart "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/CartController.java"
click node_orders "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/OrderController.java"
click node_admin "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/AdminController.java"
click node_warehouse "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/WarehouseController.java"
click node_facade "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/bo/Facade.java"
click node_items "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/bo/Item.java"
click node_order "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/bo/Order.java"
click node_user "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/bo/User.java"
click node_dbmanager "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/db/DBManager.java"
click node_itemdb "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/db/ItemDB.java"
click node_orderdb "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/db/OrderDB.java"
click node_userdb "https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/db/UserDB.java"
click node_mongo_setup "https://github.com/eddiore/hi1031-lab1/blob/main/mongodb/setup_webshop.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_front,node_views toneBlue
class node_login,node_profile,node_cart,node_orders,node_admin,node_warehouse toneAmber
class node_facade,node_items,node_order,node_user toneMint
class node_dbmanager,node_itemdb,node_orderdb,node_userdb,node_mongo,node_mongo_setup toneRose
class node_browser toneIndigo
```

## Components

### Web interface

- [Front controller](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/FrontController.java): `src/main/java/org/example/ui/FrontController.java`
- [JSP views](https://github.com/eddiore/hi1031-lab1/tree/main/src/main/webapp/WEB-INF/views): `src/main/webapp/WEB-INF/views`

### Shop workflows

- [Login and profile](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/LoginController.java): `src/main/java/org/example/ui/subcontrollers/LoginController.java`
- [Profile workflow](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/ProfileController.java): `src/main/java/org/example/ui/subcontrollers/ProfileController.java`
- [Cart workflow](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/CartController.java): `src/main/java/org/example/ui/subcontrollers/CartController.java`
- [Order workflow](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/OrderController.java): `src/main/java/org/example/ui/subcontrollers/OrderController.java`
- [Admin workflow](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/AdminController.java): `src/main/java/org/example/ui/subcontrollers/AdminController.java`
- [Warehouse workflow](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/ui/subcontrollers/WarehouseController.java): `src/main/java/org/example/ui/subcontrollers/WarehouseController.java`

### Shop domain

- [Business facade](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/bo/Facade.java): `src/main/java/org/example/bo/Facade.java`
- [Items](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/bo/Item.java): `src/main/java/org/example/bo/Item.java`
- [Orders](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/bo/Order.java): `src/main/java/org/example/bo/Order.java`
- [Users](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/bo/User.java): `src/main/java/org/example/bo/User.java`

### Persistence

- [DB manager](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/db/DBManager.java): `src/main/java/org/example/db/DBManager.java`
- [Item persistence](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/db/ItemDB.java): `src/main/java/org/example/db/ItemDB.java`
- [Order persistence](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/db/OrderDB.java): `src/main/java/org/example/db/OrderDB.java`
- [User persistence](https://github.com/eddiore/hi1031-lab1/blob/main/src/main/java/org/example/db/UserDB.java): `src/main/java/org/example/db/UserDB.java`
- **MongoDB**
- [Mongo initialization](https://github.com/eddiore/hi1031-lab1/blob/main/mongodb/setup_webshop.js): `mongodb/setup_webshop.js`

### Other components

- **Shopper**

## Connections

- Shopper → Front controller: opens shop (evidence: `README.md`)
- Mongo initialization → MongoDB: creates collections (evidence: `mongodb/setup_webshop.js`)
