Quay Lại Dự Án

Phần mềm quản lý bán hàng đa chi nhánh (REST API - Backend)

Nền tảng backend RESTful hỗ trợ quản lý bán hàng, tồn kho và hoạt động vận hành trên nhiều chi nhánh, với tính năng xác thực an toàn, đồng bộ đơn hàng ngoại tuyến và báo cáo tập trung.

03/2026
Express.jsNode.jsSQLiteSwagger
Mã Nguồn Xem Trực Tiếp

🚀 Tổng quan dự án

Trong bối cảnh kinh doanh hiện đại, việc quản lý hiệu quả các hoạt động bán hàng tại nhiều chi nhánh là một vấn đề quan trọng. Đề tài này tập trung vào sự cần thiết của hệ thống quản lý bán hàng đa chi nhánh để tối ưu hóa quy trình giao dịch và tăng cường hiệu suất vận hành. Mục tiêu chính là xây dựng một nền tảng REST API - Backend để cung cấp khả năng truy cập linh hoạt, đồng bộ hóa dữ liệu giữa các chi nhánh và hệ thống trung tâm. Phương pháp nghiên cứu bao gồm phân tích hiện trạng, thiết kế kiến trúc hệ thống, triển khai ứng dụng và đánh giá hiệu suất. Kết quả mong đợi là một giải pháp giúp nâng cao chất lượng dịch vụ và tăng doanh thu cho các tổ chức kinh doanh đa chi nhánh.

🌟 Tính năng chính

  • Quản lý đa chi nhánh: Quản lý các chi nhánh trong chuỗi cửa hàng, bao gồm thông tin liên hệ và vị trí địa lý.

  • Quản lý sản phẩm & SKU: Duy trì danh mục sản phẩm tập trung với mã định danh duy nhất (SKU), thông tin mô tả sản phẩm và cấu hình giá.

  • Quản lý tồn kho theo chi nhánh: Tự động theo dõi số lượng tồn kho của từng sản phẩm tại mỗi chi nhánh.

  • Xác thực & Phân quyền (JWT Authentication):

    • Đăng nhập an toàn bằng JSON Web Token (JWT) và mã hóa mật khẩu với bcryptjs.

    • Phân quyền dựa trên vai trò: Admin (toàn quyền quản trị hệ thống) và Staff (nhân viên vận hành, chỉ được truy cập dữ liệu thuộc chi nhánh được phân công).

  • Hệ thống đồng bộ ngoại tuyến:

    • Cung cấp các API chuyên dụng cho phép ứng dụng bán hàng Desktop hoạt động offline tải các hóa đơn bán lẻ được lưu tạm lên máy chủ trung tâm ngay khi kết nối mạng được khôi phục.

    • Đảm bảo tính toàn vẹn dữ liệu, xử lý xung đột mã hóa đơn và tự động điều chỉnh số lượng tồn kho thực tế của chi nhánh sau khi đồng bộ thành công.

  • Xác thực dữ liệu nghiêm ngặt: Sử dụng express-validator để kiểm tra kiểu dữ liệu, định dạng và tính hợp lệ của mọi dữ liệu đầu vào trước khi xử lý, góp phần duy trì tính ổn định và bảo mật của hệ thống.

  • Hệ thống Logging nâng cao: Tích hợp winston và morgan để tự động theo dõi hoạt động của hệ thống và các HTTP request, đồng thời ghi nhận lỗi kịp thời vào các tệp log riêng biệt.

  • Báo cáo & Phân tích (Admin Analytics Dashboard): Tổng hợp doanh thu theo thời gian, xếp hạng hiệu suất bán hàng giữa các chi nhánh, theo dõi các sản phẩm sắp hết hàng và hiển thị những giao dịch mới nhất.

  • Tự động tạo tài liệu API (Swagger Integration): Tích hợp Swagger UI, cho phép developer xem và kiểm thử trực tiếp toàn bộ API endpoint tại /api-docs.

🛠️ Công nghệ sử dụng

  • Runtime: Node.js (Yêu cầu phiên bản >= 22.0.0)

  • Framework: Express.js (v5.x với khả năng routing hiện đại)

  • Database ORM: Sequelize v6 (Sử dụng driver sqlite3 làm cơ sở dữ liệu mặc định và có thể mở rộng sang PostgreSQL, MySQL hoặc MS SQL Server bằng cách cấu hình lại kết nối).

  • Bảo mật & Validation: bcryptjs để mã hóa mật khẩu, jsonwebtoken để cấp Bearer Token và express-validator để kiểm tra dữ liệu đầu vào.

  • Tài liệu API: swagger-jsdoc & swagger-ui-express để viết tài liệu API trực tiếp trong code theo tiêu chuẩn OpenAPI 3.0.

  • Logging & Development: winston kết hợp với morgan cung cấp hệ thống logging mạnh mẽ với các tệp log theo ngày; nodemon hỗ trợ tự động reload server ngay khi code thay đổi.

📖 Tài liệu API (Swagger UI)

🌍 Môi trường trực tuyến: Demo tại đây

Tại đây, bạn có thể tìm thấy danh sách đầy đủ các API được phân loại theo từng nhóm:

  • Auth (/api/auth): POST /login, POST /register, GET /me...

  • Branches (/api/branches): Các thao tác CRUD cho chi nhánh cửa hàng.

  • Products (/api/products): Xem và tạo sản phẩm trong hệ thống.

  • Inventories (/api/inventories): Cập nhật tồn kho của từng sản phẩm tại mỗi chi nhánh.

  • Customers (/api/customers): Quản lý thông tin khách hàng.

  • Orders (/api/orders): Tạo đơn hàng trực tiếp hoặc tra cứu lịch sử hóa đơn.

  • Sync (/api/sync):

    • POST /api/sync/orders: Tải hàng loạt đơn hàng được lưu tạm từ các client offline lên cloud.

    • GET /api/sync/pending: Xem các đơn hàng đang chờ đồng bộ trên Express Server.

    • PUT /api/sync/status: Cập nhật trạng thái hóa đơn sau khi hoàn tất quá trình đối soát.

  • Dashboard (/api/dashboard): Truy xuất dữ liệu phân tích cho dashboard quản trị, bao gồm doanh số và tổng quan doanh thu theo từng chi nhánh.