ShopPro — Hệ thống Quản lý Cửa hàng Giày & POS Monorepo

1. Tổng quan Dự án (Project Overview)

ShopPro là hệ thống quản lý bán hàng đa kênh và thương mại điện tử toàn diện cho chuỗi cửa hàng giày dép, được tổ chức theo cấu trúc Monorepo bao gồm 3 phân hệ ứng dụng độc lập nhưng chia sẻ chung logic nghiệp vụ và cơ sở dữ liệu:

• Storefront: Cửa hàng trực tuyến phục vụ khách hàng tìm kiếm, xem chi tiết sản phẩm, quản lý giỏ hàng và đặt hàng.
• POS Terminal: Phân hệ quầy thu ngân tối ưu cho nhân viên thu ngân quét mã vạch, tạo đơn hàng tại quầy và in hóa đơn tức thì.
• Admin Dashboard: Trung tâm điều hành quản lý danh mục, biến thể size/màu, kiểm soát tồn kho realtime, phân quyền nhân sự và báo cáo doanh thu.

2. Kiến trúc Hệ thống & Công nghệ (System Architecture & Tech Stack)

• Frontend Web & Storefront: Next.js 14, React, TypeScript, TailwindCSS mang lại tốc độ tải trang nhanh và tối ưu hóa SEO.
• POS & Admin UI: React, Ant Design 5 cung cấp hệ thống UI component phong phú, tối ưu cho các biểu mẫu quản trị và bảng dữ liệu lớn.
• Backend API: Express.js, TypeScript với kiến trúc Layered Architecture (Controllers, Services, Repositories).
• Cơ sở Dữ liệu & Lưu trữ: Hỗ trợ kép SQLite (thông qua sql.js WASM) cho môi trường kiểm thử/offline và PostgreSQL cho môi trường Production.
• Containerization: Docker & Docker Compose thiết lập môi trường phát triển đồng nhất giữa các phân hệ.

3. Tính năng Cốt lõi (Core Features)

• Quản lý Biến thể Sản phẩm: Quản lý ma trận phân loại đa thuộc tính (Size giày từ 36-45, Màu sắc, Chất liệu) với mã SKU riêng biệt.
• Đồng bộ Kho Thời gian thực: Tự động cập nhật số lượng tồn kho ngay khi phát sinh giao dịch từ quầy POS hoặc đơn đặt hàng online.
• Phân quyền RBAC Chặt chẽ: Phân định vai trò rõ ràng giữa Quản trị viên (Admin), Thu ngân (Cashier) và Nhân viên kho (Warehouse).
• Khuyến mãi & Mã giảm giá: Công cụ cấu hình chiết khấu theo phần trăm, số tiền cố định hoặc miễn phí vận chuyển.

4. Kết quả & Đóng góp Kỹ thuật (Technical Highlights)

Dự án hoàn thiện toàn bộ luồng nghiệp vụ bán lẻ thực tế, xử lý mượt mà việc đồng bộ trạng thái đơn hàng giữa các ứng dụng trong monorepo và tối ưu hóa hiệu năng render bảng dữ liệu lớn trên Ant Design.