# kang3427/oop-gk-phelieu architecture

> Architecture diagram of the GitHub repository kang3427/oop-gk-phelieu, 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/kang3427/oop-gk-phelieu
- Repository: https://github.com/kang3427/oop-gk-phelieu

## Overview

This is a Java scrap-yard purchasing management application. The demonstrated workflow filters scrap, selects a payment method, publishes transaction events, builds a cart into a purchase order, and prints an invoice. Other implemented/documented capabilities include inventory tracking, rewards, customer records, generic list management, and scrap categories. Edges reflect the shown Main workflow, class references in the source index, and README documentation; several subsystem integrations are not demonstrated in the excerpts.

Main entry points: [`src/Main.java`](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/Main.java) (Application entry), [`src/model/PheLieu.java`](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieu.java) (Scrap item), [`src/model/DonThuMua.java`](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/DonThuMua.java) (Purchase order), [`src/Event/QuanLiSuKien.java`](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/Event/QuanLiSuKien.java) (Event manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Scrap Catalog"]
  node_scrap["Scrap item<br/>[PheLieu.java]"]
  node_metal["Metal scrap"]
  node_paper["Paper scrap<br/>[PheLieuGiay.java]"]
  node_plastic["Plastic scrap<br/>[PheLieuNhua.java]"]
  node_ewaste["E-waste scrap<br/>[PheLieuDienTu.java]"]
  node_categories["Scrap categories"]
  node_filter["Scrap filter<br/>[BoLocPheLieu.java]"]
end

subgraph group_purchase["Purchase Workflow"]
  node_main["Application entry<br/>[Main.java]"]
  node_customer["Customer<br/>[KhachHang.java]"]
  node_cart["Cart<br/>[GioHang.java]"]
  node_cartitem["Cart item"]
  node_order["Purchase order<br/>[DonThuMua.java]"]
  node_orderitem["Order item"]
  node_invoice["Invoice<br/>[HoaDon.java]"]
  node_orderstatus["Order status"]
end

subgraph group_operations["Shop Operations"]
  node_inventory["Inventory manager<br/>[TonKhoPheLieu.java]"]
  node_listmanager["List manager"]
end

subgraph group_settlement["Payment and Rewards"]
  node_payment["Payment contract<br/>[ThanhToan.java]"]
  node_cash["Cash payment<br/>[TienMat.java]"]
  node_bank["Bank transfer<br/>[ChuyenKhoan.java]"]
  node_wallet["E-wallet payment<br/>[ViDienTu.java]"]
  node_rewards["Customer rewards"]
end

subgraph group_events["Event Handling"]
  node_eventmanager["Event manager<br/>[QuanLiSuKien.java]"]
  node_event["Shop event<br/>[Sukien.java]"]
  node_listener["Event listener<br/>[NhanSuKien.java]"]
end

node_operator(("Shop operator"))

node_operator -->|"starts"| node_main
node_main -->|"filters with"| node_filter
node_filter -->|"filters"| node_scrap
node_main -->|"creates"| node_metal
node_main -->|"creates"| node_paper
node_metal -->|"extends"| node_scrap
node_paper -->|"extends"| node_scrap
node_plastic -->|"extends"| node_scrap
node_ewaste -->|"extends"| node_scrap
node_main -->|"builds"| node_cart
node_main -->|"adds"| node_cartitem
node_cart -->|"holds"| node_cartitem
node_cartitem -->|"references"| node_scrap
node_main -->|"creates"| node_order
node_order -->|"copies from"| node_cart
node_order -->|"creates"| node_orderitem
node_orderitem -->|"references"| node_scrap
node_order -->|"tracks"| node_orderstatus
node_main -->|"prints"| node_invoice
node_invoice -->|"reads"| node_order
node_main -->|"selects"| node_cash
node_main -->|"selects"| node_bank
node_main -->|"selects"| node_wallet
node_cash -->|"implements"| node_payment
node_bank -->|"implements"| node_payment
node_wallet -->|"implements"| node_payment
node_invoice -->|"uses"| node_payment
node_main -->|"publishes through"| node_eventmanager
node_main -->|"creates"| node_event
node_eventmanager -->|"dispatches"| node_event
node_eventmanager -->|"notifies"| node_listener
node_inventory -.->|"references"| node_eventmanager
node_inventory -.->|"tracks stock"| node_scrap
node_rewards -.->|"calculates rewards"| node_customer

click node_main "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/Main.java"
click node_scrap "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieu.java"
click node_metal "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieuKimLoai.java"
click node_paper "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieuGiay.java"
click node_plastic "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieuNhua.java"
click node_ewaste "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieuDienTu.java"
click node_categories "https://github.com/kang3427/oop-gk-phelieu/tree/main/src/enums"
click node_filter "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/manager/BoLocPheLieu.java"
click node_customer "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/KhachHang.java"
click node_cart "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/GioHang.java"
click node_cartitem "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/ChiTietGioHang.java"
click node_order "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/DonThuMua.java"
click node_orderitem "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/ChiTietDonThuMua.java"
click node_invoice "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/HoaDon.java"
click node_orderstatus "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/enums/TrangThaiDonHang.java"
click node_inventory "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/manager/TonKhoPheLieu.java"
click node_listmanager "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/manager/QuanLiDanhSach.java"
click node_payment "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/payment/ThanhToan.java"
click node_cash "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/payment/TienMat.java"
click node_bank "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/payment/ChuyenKhoan.java"
click node_wallet "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/payment/ViDienTu.java"
click node_rewards "https://github.com/kang3427/oop-gk-phelieu/tree/main/src/reward"
click node_eventmanager "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/Event/QuanLiSuKien.java"
click node_event "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/Event/Sukien.java"
click node_listener "https://github.com/kang3427/oop-gk-phelieu/blob/main/src/Event/NhanSuKien.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_scrap,node_metal,node_paper,node_plastic,node_ewaste,node_categories,node_filter toneBlue
class node_main,node_customer,node_cart,node_cartitem,node_order,node_orderitem,node_invoice,node_orderstatus toneAmber
class node_inventory,node_listmanager toneMint
class node_payment,node_cash,node_bank,node_wallet,node_rewards toneRose
class node_eventmanager,node_event,node_listener,node_operator toneIndigo
```

## Components

### Scrap Catalog

- [Scrap item](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieu.java): `src/model/PheLieu.java`
- [Metal scrap](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieuKimLoai.java): `src/model/PheLieuKimLoai.java`
- [Paper scrap](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieuGiay.java): `src/model/PheLieuGiay.java`
- [Plastic scrap](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieuNhua.java): `src/model/PheLieuNhua.java`
- [E-waste scrap](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/PheLieuDienTu.java): `src/model/PheLieuDienTu.java`
- [Scrap categories](https://github.com/kang3427/oop-gk-phelieu/tree/main/src/enums): `src/enums`
- [Scrap filter](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/manager/BoLocPheLieu.java): `src/manager/BoLocPheLieu.java`

### Purchase Workflow

- [Application entry](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/Main.java): `src/Main.java`
- [Customer](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/KhachHang.java): `src/model/KhachHang.java`
- [Cart](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/GioHang.java): `src/model/GioHang.java`
- [Cart item](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/ChiTietGioHang.java): `src/model/ChiTietGioHang.java`
- [Purchase order](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/DonThuMua.java): `src/model/DonThuMua.java`
- [Order item](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/ChiTietDonThuMua.java): `src/model/ChiTietDonThuMua.java`
- [Invoice](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/model/HoaDon.java): `src/model/HoaDon.java`
- [Order status](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/enums/TrangThaiDonHang.java): `src/enums/TrangThaiDonHang.java`

### Shop Operations

- [Inventory manager](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/manager/TonKhoPheLieu.java): `src/manager/TonKhoPheLieu.java`
- [List manager](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/manager/QuanLiDanhSach.java): `src/manager/QuanLiDanhSach.java`

### Payment and Rewards

- [Payment contract](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/payment/ThanhToan.java): `src/payment/ThanhToan.java`
- [Cash payment](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/payment/TienMat.java): `src/payment/TienMat.java`
- [Bank transfer](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/payment/ChuyenKhoan.java): `src/payment/ChuyenKhoan.java`
- [E-wallet payment](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/payment/ViDienTu.java): `src/payment/ViDienTu.java`
- [Customer rewards](https://github.com/kang3427/oop-gk-phelieu/tree/main/src/reward): `src/reward`

### Event Handling

- [Event manager](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/Event/QuanLiSuKien.java): `src/Event/QuanLiSuKien.java`
- [Shop event](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/Event/Sukien.java): `src/Event/Sukien.java`
- [Event listener](https://github.com/kang3427/oop-gk-phelieu/blob/main/src/Event/NhanSuKien.java): `src/Event/NhanSuKien.java`

### Other components

- **Shop operator**

## Connections

- Shop operator → Application entry: starts
- Application entry → Scrap filter: filters with (evidence: `src/Main.java`)
- Scrap filter → Scrap item: filters (evidence: `src/manager/BoLocPheLieu.java`)
- Application entry → Metal scrap: creates (evidence: `src/Main.java`)
- Application entry → Paper scrap: creates (evidence: `src/Main.java`)
- Metal scrap → Scrap item: extends (evidence: `src/model/PheLieuKimLoai.java`)
- Paper scrap → Scrap item: extends (evidence: `src/model/PheLieuGiay.java`)
- Plastic scrap → Scrap item: extends (evidence: `src/model/PheLieuNhua.java`)
- E-waste scrap → Scrap item: extends (evidence: `src/model/PheLieuDienTu.java`)
- Application entry → Cart: builds (evidence: `src/Main.java`)
- Application entry → Cart item: adds (evidence: `src/Main.java`)
- Cart → Cart item: holds (evidence: `src/model/GioHang.java`)
- Cart item → Scrap item: references (evidence: `src/model/ChiTietGioHang.java`)
- Application entry → Purchase order: creates (evidence: `src/Main.java`)
- Purchase order → Cart: copies from (evidence: `src/model/DonThuMua.java`)
- Purchase order → Order item: creates (evidence: `src/model/DonThuMua.java`)
- Order item → Scrap item: references (evidence: `src/model/ChiTietDonThuMua.java`)
- Purchase order → Order status: tracks (evidence: `src/model/DonThuMua.java`)
- Application entry → Invoice: prints (evidence: `src/Main.java`)
- Invoice → Purchase order: reads (evidence: `src/model/HoaDon.java`)
- Application entry → Cash payment: selects (evidence: `src/Main.java`)
- Application entry → Bank transfer: selects (evidence: `src/Main.java`)
- Application entry → E-wallet payment: selects (evidence: `src/Main.java`)
- Cash payment → Payment contract: implements (evidence: `src/payment/TienMat.java`)
- Bank transfer → Payment contract: implements (evidence: `src/payment/ChuyenKhoan.java`)
- E-wallet payment → Payment contract: implements (evidence: `src/payment/ViDienTu.java`)
- Invoice → Payment contract: uses (evidence: `src/model/HoaDon.java`)
- Application entry → Event manager: publishes through (evidence: `src/Main.java`)
- Application entry → Shop event: creates (evidence: `src/Main.java`)
- Event manager → Shop event: dispatches (evidence: `src/Event/QuanLiSuKien.java`)
- Event manager → Event listener: notifies (evidence: `src/Event/QuanLiSuKien.java`)
- Inventory manager → Event manager: references (evidence: `src/manager/TonKhoPheLieu.java`)
- Inventory manager → Scrap item: tracks stock
- Customer rewards → Customer: calculates rewards
