GiayHub Core System

v2.0 - System Architecture

Format: JSON / NoSQL

1. Luồng Biến Thể Sản Phẩm

Định nghĩa "Cái hộp giày thực tế" thay vì khái niệm biến thể chung chung.

Collection: Products

Ghi tên dòng giày (VD: Nike Air Force 1). Không chứa giá trị động như giá, tồn kho.

Colors

Đen, Trắng...

Sizes

40, 41, 42...

Quan trọng Collection: Product_Variants

Hộp giày thực tế, được map từ 3 bảng trên.

  • Giá: 1.000.000đ
  • Stock (Tồn kho): 5
Data Structure (JSON)
{
  "variant_id": "var_nike_blk_42",
  "product_id": "prod_nike_af1", 
  "color_id": "col_black",       
  "size_id": "size_42",          
  "sku": "NIKE-AF1-BLK-42",
  "price": 1000000,
  "stock": 5
}

Luồng truy vấn khi khách xem hàng

💻

Frontend gọi API xuống Database kiểm tra trạng thái hộp giày:

SELECT stock FROM Product_Variants WHERE variant_id = 'var_nike_blk_42'

→ Nếu stock = 0, render component: Hết hàng

2. Luồng Bán Hàng POS

Mô phỏng máy quét mã vạch offline.

Accounts

Lưu thông tin KH. Mặc định: walk_in_customer.

Coupons

Giới hạn số lần dùng chung & mỗi người.

Collection: Orders

Ghi nhận tổng quan: Mã KH, Mã Coupon, Tổng tiền.

Collection: Order_Items

Móc nối order_id với variant_id. Ghi số lượng mua.

Orders Payload (JSON)
{
  "order_id": "ORD-123",
  "account_id": "walk_in_customer",
  "coupon_id": "TEST100",
  "total_amount": 2000000,
  "items": [ 
    {
      "variant_id": "var_nike_blk_42",
      "quantity": 2,
      "price": 1000000
    }
  ]
}

Luồng Transaction (Xử lý đồng thời)

Check Coupon → Tăng used_count += 1

Insert bản ghi vào Orders & Order_Items.

Chốt hạ (Trừ tồn kho)

UPDATE Product_Variants SET stock = stock - 2

3. Luồng Bán Hàng Online

Tích hợp API Đơn vị vận chuyển & Cổng thanh toán.

Collection: Addresses

Gắn chặt với account_id. Chứa chi tiết địa chỉ giao hàng.

Collection: Order_Log

Nhật ký hành trình đơn hàng.

[1] Khách đặt đơn [2] Đã giao shipper
Online Additions (JSON)
{
  "order_id": "ORD-WEB-999",
  "shipping": {
    "provider": "GHN",
    "fee": 30000
  },
  "payment": {
    "method": "VNPAY",
    "status": "PENDING"
  }
}

Luồng Event-Driven khi Đặt hàng

Lưu thông tin Addresses.

Gọi API hệ thống Giao Hàng (GHN) → Ghi phí ship vào Orders.

VNPay Status: PENDING

Webhook IPN VNPay → Đổi Status: SUCCESS

Hệ thống kích hoạt Transaction trừ tồn kho và ghi log lịch sử.