Kiến trúc hệ thống
Bot Bán Hàng sử dụng kiến trúc multi-service monorepo — các service nằm chung repo nhưng deploy và scale độc lập.
Sơ đồ tổng quan
Các service
api_oms — Order Management Service
Quản lý nghiệp vụ bán hàng chính:
- Order — Tạo, cập nhật, hủy đơn hàng
- Product & Variant — Quản lý sản phẩm và biến thể (size, màu, ...)
- Inventory — Tồn kho, kiểm kê
- Shipping — Tích hợp 8 đơn vị vận chuyển
- Billing — Hóa đơn, thanh toán
- Loyalty — Chương trình tích điểm, ưu đãi
- Vendor — Quản lý nhà cung cấp
- Integration — Đồng bộ Facebook, webhook đối tác
api_payment — Payment Gateway
Cổng thanh toán tập trung, tích hợp đa nền tảng:
| Nền tảng | Loại |
|---|---|
| MoMo | Ví điện tử |
| ZaloPay | Ví điện tử |
| VNPay | Cổng thanh toán |
| Stripe | Thanh toán quốc tế |
| Square | POS |
| MPOS | POS |
| SePay | Chuyển khoản tự động |
| Chuyển khoản | Ngân hàng |
| Tiền mặt | COD |
web_payment — Payment UI
Giao diện thanh toán Next.js cho khách hàng — hiển thị form thanh toán, QR code, redirect đến cổng thanh toán.
Tech Stack
- Runtime: Node.js 20+
- Backend: NestJS
- Frontend: Next.js · React 18
- ORM: Prisma
- Database: PostgreSQL
- Package Manager: pnpm