TMS-1239: Cart - Giỏ hàng

Tài liệu mô tả giỏ hàng trên trang web

1. Mô tả tổng quan

Trang giỏ hàng là nơi hiển thị danh sách các sản phẩm mà người dùng đã chọn để mua. Tại đây, người dùng có thể:

Xem danh sách sản phẩm đã thêm vào giỏ.
Điều chỉnh số lượng sản phẩm.
Xóa sản phẩm khỏi giỏ hàng.
Tiến hành thanh toán.
Lưu trạng thái giỏ hàng.

2. Các chức năng và luồng hoạt động

2.1 Thêm sản phẩm vào giỏ hàng (Add to Cart)

Khi người dùng nhấn nút Add To Cart tại bất kỳ trang danh sách sản phẩm hoặc chi tiết sản phẩm nào, sản phẩm đó sẽ được thêm vào giỏ hàng.
Hệ thống sẽ hiển thị sản phẩm ngay trên trang giỏ hàng với thông tin chi tiết.

2.2 Tiếp tục mua sắm (Continue Shopping)

Khi người dùng nhấn vào nút Continue Shopping, hệ thống sẽ đưa họ trở lại trang danh sách sản phẩm để tiếp tục mua hàng.

2.3 Cập nhật giỏ hàng (Update Cart)

Khi người dùng thay đổi số lượng sản phẩm hoặc xóa sản phẩm khỏi giỏ hàng, họ cần nhấn vào nút Update Cart để lưu lại thay đổi.
Hệ thống sẽ cập nhật thông tin giỏ hàng trong cơ sở dữ liệu.

2.4 Chọn sản phẩm để thanh toán (Select Product for Checkout)

Người dùng có thể chọn từng sản phẩm bằng cách tick vào ô checkbox hoặc chọn tất cả sản phẩm cùng lúc.
Chỉ các sản phẩm được chọn mới được đưa vào quá trình thanh toán.

2.5 Tiến hành thanh toán (Proceed to Checkout)

Khi nhấn nút Proceed To Checkout:

Hệ thống sẽ lưu thông tin giỏ hàng hiện tại của người dùng.
Chuyển sang trang xác nhận đơn hàng.
Hiển thị thông báo xác nhận đơn hàng đã được đặt thành công.

Ghi chú: Vì chưa đồng bộ liên tục từ cơ sở dữ liệu với local, nên trước khi đặt hàng phải nhấn Update cart để đồng bộ dữ liệu.

2.6 Xóa sản phẩm trong giỏ hàng

Khi nhấn nút icon thùng rác ở mỗi dòng:

Hệ thống sẽ tiến hành xóa sản phẩm đó ở giỏ hàng trên máy.
Bấm update cart để tiến hành cập nhật các thay đổi ở giỏ hàng của máy lên database.
Hiển thị thông báo xác nhận đơn hàng đã được cập nhật thành công.

3. API Endpoint

Phương thức	Route	Mô tả
`GET`	`/api/v1/auth/get/shop-order`	Lấy dữ liệu giỏ hàng từ database
`POST`	`/api/v1/auth/post/shop-order`	Lưu dữ liệu giỏ hàng vào database
`POST`	`/api/v1/auth/post/shop-order/update`	Cập nhật giỏ hàng (thay đổi số lượng, xóa)
`POST`	`/api/v1/auth/post/shop-order/checkout`	Xử lý thanh toán giỏ hàng

4. Cấu trúc dữ liệu giỏ hàng

4.1 Bảng `ecom.shop-order`

Chứa thông tin ID của người dùng.

Trường (EN)	Ý nghĩa	Mô tả
`user_id`	ID người dùng	ID của người đặt hàng
`created_at`	Ngày tạo	Ngày đơn hàng được tạo
`updated_at`	Ngày cập nhật	Ngày đơn hàng được cập nhật
`deleted_at`	Ngày xóa	Ngày đơn hàng được xóa

4.2 Bảng `ecom.shop-order-details`

Chứa chi tiết các sản phẩm trong đơn hàng của ngừoi dùng.

Trường (EN)	Ý nghĩa	Mô tả
`shop-order_id`	ID đơn hàng	ID của đơn hàng
`product_id`	ID sản phẩm	ID của sản phẩm
`price`	Giá gốc	Giá sản phẩm
`quantity`	Số lượng	Số lượng sản phẩm
`total_price`	Tạm tính	Tổng giá của sản phẩm đó (`price * quantity`)
`is_checkout`	Đặt hàng	Đánh dấu sản phẩm đã được thanh toán chưa
`created_at`	Ngày tạo	Ngày đơn hàng được tạo
`updated_at`	Ngày cập nhật	Ngày đơn hàng được cập nhật
`deleted_at`	Ngày xóa	Ngày đơn hàng được xóa

5. Giao diện giỏ hàng

5.1 Danh sách sản phẩm trong giỏ hàng

Trường (EN)	Trường (VI)	Cột DB	Mô tả
Product	Sản phẩm	`product_id`	Hiển thị sản phẩm trong giỏ hàng
Unit Price	Đơn giá	`price`	Giá sản phẩm đơn lẻ
Quantity	Số lượng	`quantity`	Số lượng sản phẩm trong giỏ
Subtotal	Tạm tính	`total_price`	Tổng tiền của sản phẩm trong giỏ
Remove	Xóa	Không	Xóa sản phẩm khỏi giỏ hàng

5.2 Tổng giá trị giỏ hàng (Checkout Summary)

Trường (EN)	Trường (VI)	Cột DB	Mô tả
Subtotal	Tạm tính	Không	Tổng tiền của tất cả sản phẩm đã chọn
Shipping	Phí vận chuyển	Không	Phí vận chuyển (nếu có)
Total	Tổng cộng	Không	Tổng giá trị đơn hàng sau phí vận chuyển

6. Tóm tắt

Người dùng có thể thêm sản phẩm vào giỏ hàng từ danh sách sản phẩm hoặc trang chi tiết sản phẩm.
Giỏ hàng có thể cập nhật số lượng sản phẩm, xóa sản phẩm, và chọn sản phẩm để thanh toán.
Sau khi chọn sản phẩm, người dùng có thể tiến hành thanh toán và lưu đơn hàng.
Dữ liệu giỏ hàng được lưu vào cơ sở dữ liệu thông qua các API đã định nghĩa.