# nhatlq20/swp391 architecture

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

- Interactive diagram: https://gitdiagram.com/nhatlq20/swp391
- Repository: https://github.com/nhatlq20/swp391

## Overview

PharmacyLife is a pharmacy e-commerce and management web application. Its customer workflow covers browsing medicines, managing a cart, checking out with a voucher, and viewing orders; staff capabilities include managing stock through multi-unit imports, medicines, orders, customers, and reviews. The graph shows the principal controller-to-data-access calls where the SOURCE INDEX identifies them. Several listed capabilities have no sampled implementation details, so their links are left unverified rather than inferred.

Main entry points: [`PharmacyLife/src/main/java/controllers/CartController.java`](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/CartController.java) (Shopping cart), [`PharmacyLife/src/main/java/controllers/admin/ImportService.java`](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/admin/ImportService.java) (Stock imports), [`PharmacyLife/src/main/java/controllers/admin/MedicineControllerForDashboard.java`](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/admin/MedicineControllerForDashboard.java) (Medicine administration), [`PharmacyLife/src/main/java/dao/MedicineDAO.java`](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/MedicineDAO.java) (Medicine data access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_catalog["Catalog browsing"]
  node_search["Medicine search"]
  node_medicine_detail["Medicine details"]
  node_cart["Shopping cart"]
  node_ai_chat["AI chat"]
end

subgraph group_identity["Accounts"]
  node_auth["Sign-in and registration"]
  node_profile["Customer profile"]
  node_email_otp["Email verification"]
end

subgraph group_commerce["Orders and reviews"]
  node_checkout["Checkout"]
  node_orders["Order management"]
  node_reviews["Medicine reviews"]
  node_review_reply["Staff review replies"]
end

subgraph group_operations["Staff operations"]
  node_imports["Stock imports<br/>[ImportService.java]"]
  node_medicine_admin["Medicine administration"]
  node_staff_admin["Staff and roles"]
  node_voucher_admin["Voucher administration"]
end

subgraph group_data["Persistence"]
  node_cart_dao["Cart data access<br/>[CartDAO.java]"]
  node_medicine_dao["Medicine data access<br/>[MedicineDAO.java]"]
  node_unit_dao["Medicine-unit data"]
  node_category_dao["Category data access<br/>[CategoryDAO.java]"]
  node_order_dao["Order data access<br/>[OrderDAO.java]"]
  node_review_dao["Review data access<br/>[ReviewDAO.java]"]
  node_import_dao["Import data access<br/>[ImportDAO.java]"]
  node_user_dao["User data access<br/>[UserDAO.java]"]
  node_db_context["JDBC connections<br/>[DBContext.java]"]
end

node_customer(("Customer"))
node_admin(("Staff user"))
node_sql_server[("SQL Server")]
node_gemini["Gemini API"]
node_mail["Email service"]

node_customer -.->|"browses"| node_catalog
node_customer -.->|"searches"| node_search
node_customer -.->|"views"| node_medicine_detail
node_customer -.->|"manages cart"| node_cart
node_customer -.->|"checks out"| node_checkout
node_customer -.->|"registers"| node_auth
node_customer -.->|"updates profile"| node_profile
node_customer -.->|"reviews medicines"| node_reviews
node_admin -.->|"records stock"| node_imports
node_admin -.->|"manages catalog"| node_medicine_admin
node_admin -.->|"manages orders"| node_orders
node_catalog -->|"loads categories"| node_category_dao
node_catalog -->|"loads units"| node_unit_dao
node_cart -->|"loads medicines"| node_medicine_dao
node_cart -->|"accesses cart"| node_cart_dao
node_cart -->|"loads unit choices"| node_unit_dao
node_checkout -->|"reads cart"| node_cart_dao
node_checkout -->|"creates order"| node_order_dao
node_reviews -->|"loads reviews"| node_review_dao
node_review_reply -->|"updates replies"| node_review_dao
node_imports -->|"records imports"| node_import_dao
node_imports -->|"updates stock"| node_medicine_dao
node_imports -->|"resolves units"| node_unit_dao
node_medicine_admin -->|"manages medicines"| node_medicine_dao
node_medicine_admin -->|"loads categories"| node_category_dao
node_medicine_admin -->|"manages units"| node_unit_dao
node_voucher_admin -.->|"unknown link"| node_user_dao
node_auth -->|"accesses users"| node_user_dao
node_auth -.->|"verifies email"| node_email_otp
node_email_otp -.->|"sends OTP"| node_mail
node_ai_chat -.->|"queries AI"| node_gemini
node_medicine_dao -->|"opens connections"| node_db_context
node_order_dao -->|"opens connections"| node_db_context
node_review_dao -->|"opens connections"| node_db_context
node_db_context -->|"connects"| node_sql_server

click node_catalog "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/CategoryController.java"
click node_search "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/SearchController.java"
click node_medicine_detail "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/MedicineDetailController.java"
click node_cart "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/CartController.java"
click node_auth "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/RegisterController.java"
click node_profile "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/ProfileController.java"
click node_email_otp "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/VerifyOTPController.java"
click node_checkout "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/CheckoutController.java"
click node_orders "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/OrderController.java"
click node_reviews "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/ViewReviewsController.java"
click node_review_reply "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/ReplyReviewController.java"
click node_imports "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/admin/ImportService.java"
click node_medicine_admin "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/admin/MedicineControllerForDashboard.java"
click node_staff_admin "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/admin/StaffController.java"
click node_voucher_admin "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/admin/AdminVoucherController.java"
click node_ai_chat "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/ChatAIController.java"
click node_cart_dao "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/CartDAO.java"
click node_medicine_dao "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/MedicineDAO.java"
click node_unit_dao "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/MedicineUnitDAO.java"
click node_category_dao "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/CategoryDAO.java"
click node_order_dao "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/OrderDAO.java"
click node_review_dao "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/ReviewDAO.java"
click node_import_dao "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/ImportDAO.java"
click node_user_dao "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/UserDAO.java"
click node_db_context "https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/utils/DBContext.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_catalog,node_search,node_medicine_detail,node_cart,node_ai_chat,node_admin toneBlue
class node_auth,node_profile,node_email_otp,node_sql_server toneAmber
class node_checkout,node_orders,node_reviews,node_review_reply,node_gemini toneMint
class node_imports,node_medicine_admin,node_staff_admin,node_voucher_admin toneRose
class node_cart_dao,node_medicine_dao,node_unit_dao,node_category_dao,node_order_dao,node_review_dao,node_import_dao,node_user_dao,node_db_context,node_customer,node_mail toneIndigo
```

## Components

### Storefront

- [Catalog browsing](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/CategoryController.java): `PharmacyLife/src/main/java/controllers/CategoryController.java`
- [Medicine search](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/SearchController.java): `PharmacyLife/src/main/java/controllers/SearchController.java`
- [Medicine details](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/MedicineDetailController.java): `PharmacyLife/src/main/java/controllers/MedicineDetailController.java`
- [Shopping cart](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/CartController.java): `PharmacyLife/src/main/java/controllers/CartController.java`
- [AI chat](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/ChatAIController.java): `PharmacyLife/src/main/java/controllers/ChatAIController.java`

### Accounts

- [Sign-in and registration](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/RegisterController.java): `PharmacyLife/src/main/java/controllers/RegisterController.java`
- [Customer profile](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/ProfileController.java): `PharmacyLife/src/main/java/controllers/ProfileController.java`
- [Email verification](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/VerifyOTPController.java): `PharmacyLife/src/main/java/controllers/VerifyOTPController.java`

### Orders and reviews

- [Checkout](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/CheckoutController.java): `PharmacyLife/src/main/java/controllers/CheckoutController.java`
- [Order management](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/OrderController.java): `PharmacyLife/src/main/java/controllers/OrderController.java`
- [Medicine reviews](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/ViewReviewsController.java): `PharmacyLife/src/main/java/controllers/ViewReviewsController.java`
- [Staff review replies](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/ReplyReviewController.java): `PharmacyLife/src/main/java/controllers/ReplyReviewController.java`

### Staff operations

- [Stock imports](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/admin/ImportService.java): `PharmacyLife/src/main/java/controllers/admin/ImportService.java`
- [Medicine administration](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/admin/MedicineControllerForDashboard.java): `PharmacyLife/src/main/java/controllers/admin/MedicineControllerForDashboard.java`
- [Staff and roles](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/admin/StaffController.java): `PharmacyLife/src/main/java/controllers/admin/StaffController.java`
- [Voucher administration](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/controllers/admin/AdminVoucherController.java): `PharmacyLife/src/main/java/controllers/admin/AdminVoucherController.java`

### Persistence

- [Cart data access](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/CartDAO.java): `PharmacyLife/src/main/java/dao/CartDAO.java`
- [Medicine data access](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/MedicineDAO.java): `PharmacyLife/src/main/java/dao/MedicineDAO.java`
- [Medicine-unit data](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/MedicineUnitDAO.java): `PharmacyLife/src/main/java/dao/MedicineUnitDAO.java`
- [Category data access](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/CategoryDAO.java): `PharmacyLife/src/main/java/dao/CategoryDAO.java`
- [Order data access](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/OrderDAO.java): `PharmacyLife/src/main/java/dao/OrderDAO.java`
- [Review data access](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/ReviewDAO.java): `PharmacyLife/src/main/java/dao/ReviewDAO.java`
- [Import data access](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/ImportDAO.java): `PharmacyLife/src/main/java/dao/ImportDAO.java`
- [User data access](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/dao/UserDAO.java): `PharmacyLife/src/main/java/dao/UserDAO.java`
- [JDBC connections](https://github.com/nhatlq20/swp391/blob/main/PharmacyLife/src/main/java/utils/DBContext.java): `PharmacyLife/src/main/java/utils/DBContext.java`

### Other components

- **Customer**
- **Staff user**
- **SQL Server**
- **Gemini API**
- **Email service**

## Connections

- Customer → Catalog browsing: browses
- Customer → Medicine search: searches
- Customer → Medicine details: views
- Customer → Shopping cart: manages cart
- Customer → Checkout: checks out
- Customer → Sign-in and registration: registers
- Customer → Customer profile: updates profile
- Customer → Medicine reviews: reviews medicines
- Staff user → Stock imports: records stock
- Staff user → Medicine administration: manages catalog
- Staff user → Order management: manages orders
- Catalog browsing → Category data access: loads categories (evidence: `PharmacyLife/src/main/java/controllers/CategoryController.java`)
- Catalog browsing → Medicine-unit data: loads units (evidence: `PharmacyLife/src/main/java/controllers/CategoryController.java`)
- Shopping cart → Medicine data access: loads medicines (evidence: `PharmacyLife/src/main/java/controllers/CartController.java`)
- Shopping cart → Cart data access: accesses cart (evidence: `PharmacyLife/src/main/java/controllers/CartController.java`)
- Shopping cart → Medicine-unit data: loads unit choices (evidence: `PharmacyLife/src/main/java/controllers/CartController.java`)
- Checkout → Cart data access: reads cart (evidence: `PharmacyLife/src/main/java/controllers/CheckoutController.java`)
- Checkout → Order data access: creates order (evidence: `PharmacyLife/src/main/java/controllers/CheckoutController.java`)
- Medicine reviews → Review data access: loads reviews (evidence: `PharmacyLife/src/main/java/controllers/ViewReviewsController.java`)
- Staff review replies → Review data access: updates replies (evidence: `PharmacyLife/src/main/java/controllers/ReplyReviewController.java`)
- Stock imports → Import data access: records imports (evidence: `PharmacyLife/src/main/java/controllers/admin/ImportService.java`)
- Stock imports → Medicine data access: updates stock (evidence: `PharmacyLife/src/main/java/controllers/admin/ImportService.java`)
- Stock imports → Medicine-unit data: resolves units (evidence: `PharmacyLife/src/main/java/controllers/admin/ImportService.java`)
- Medicine administration → Medicine data access: manages medicines (evidence: `PharmacyLife/src/main/java/controllers/admin/MedicineControllerForDashboard.java`)
- Medicine administration → Category data access: loads categories (evidence: `PharmacyLife/src/main/java/controllers/admin/MedicineControllerForDashboard.java`)
- Medicine administration → Medicine-unit data: manages units (evidence: `PharmacyLife/src/main/java/controllers/admin/MedicineControllerForDashboard.java`)
- Voucher administration → User data access: unknown link
- Sign-in and registration → User data access: accesses users (evidence: `PharmacyLife/src/main/java/controllers/RegisterController.java`)
- Sign-in and registration → Email verification: verifies email
- Email verification → Email service: sends OTP
- AI chat → Gemini API: queries AI
- Medicine data access → JDBC connections: opens connections (evidence: `PharmacyLife/src/main/java/dao/MedicineDAO.java`)
- Order data access → JDBC connections: opens connections (evidence: `PharmacyLife/src/main/java/dao/OrderDAO.java`)
- Review data access → JDBC connections: opens connections (evidence: `PharmacyLife/src/main/java/dao/ReviewDAO.java`)
- JDBC connections → SQL Server: connects (evidence: `PharmacyLife/src/main/java/utils/DBContext.java`)
