Hệ Thống Quản Lý QR/Barcode

1. Tổng quan dự án số hóa chuỗi phân phối

Hệ thống Quản lý QR/Barcode là một giải pháp số hóa toàn diện được xây dựng nhằm giải quyết bài toán truy xuất nguồn gốc trong chuỗi phân phối nông nghiệp. Dự án giúp doanh nghiệp kiểm soát chặt chẽ luồng hàng hóa từ khâu sản xuất, qua hệ thống đại lý, đến tay người sử dụng cuối cùng, đồng thời cung cấp các công cụ thống kê và chống gian lận hiệu quả.   

Hiện tại, hệ thống đang chịu tải và vận hành ổn định trên môi trường production của doanh nghiệp.   

2. Ngăn xếp công nghệ (Tech Stack)

Dự án được xây dựng trên nền tảng kiến trúc hiện đại, đảm bảo tính mở rộng và khả năng xử lý dữ liệu lớn:

Backend: PHP, Laravel, RESTful API.   

Frontend: HTML, CSS, JavaScript, AJAX, Bootstrap.   

Cơ sở dữ liệu (Database): MySQL.   

Tích hợp hệ sinh thái (Integrations): Zalo Mini App SDK, Zalo OA API.    

3. Kiến trúc hệ thống và Luồng nghiệp vụ phân nhánh (1-trong-2)

Hệ thống được thiết kế dựa trên cơ chế định danh độc nhất. Mỗi tem QR được phát hành sẽ chứa một mã Barcode mã hóa riêng biệt. Khi một mã được quét, hệ thống xử lý API sẽ lập tức truy xuất ngược (Traceability) chuỗi dữ liệu để xác định chính xác nguồn gốc lô hàng và người đang sở hữu.   

Điểm đặc biệt trong kiến trúc của hệ thống này là khả năng xử lý định danh tùy biến dựa trên thực tế vận hành. Thay vì một chuỗi liên kết tuyến tính, tôi đã thiết kế thuật toán phân luồng (1-trong-2) cho mỗi mã QR được sinh ra:   

Luồng Thương mại (Kênh Đại lý): Áp dụng cho hàng hóa xuất bán theo kênh phân phối truyền thống. Mã QR/Barcode sẽ được quét để liên kết chặt chẽ vào hồ sơ quản lý của Đại lý nhập lô hàng đó.   

Luồng Trình diễn (Kênh Nông dân & Zalo Mini App): Áp dụng khi doanh nghiệp tổ chức các sự kiện trình diễn và phát thuốc trực tiếp tại thực địa. Bằng việc xây dựng RESTful API tích hợp sâu với nền tảng Zalo Mini App , khi nông dân nhận sản phẩm, Mini App sẽ lấy thông tin định danh Zalo của họ và lập tức liên kết mã QR của sản phẩm đó với đích danh người nông dân. Giải pháp này giúp số hóa trực tiếp tệp khách hàng cuối mà không cần qua trung gian.   

Hình 1. Chi tiết mã Barcode liên kết với Đại lý phân phối trên hệ thống quản lý QR.

Hình 2. Chi tiết mã Barcode liên kết định danh Nông dân thông qua Zalo Mini App.

4. Phân tích các Module quản trị cốt lõi

4.1. Module Quản lý và Phát hành QR/Barcode

Sinh mã hàng loạt (Batch Generation): Hỗ trợ tính năng tạo mã Barcode và sinh tem QR hàng loạt cho 44 danh mục sản phẩm khác nhau, bao gồm cả sản phẩm bán lẻ và đóng gói theo bộ/combo.   

Quản trị vòng đời định danh: Theo dõi trạng thái của từng mã (chưa in, đã in, đã liên kết, đã hủy) và ghi nhận lịch sử thay đổi theo thời gian thực.   

Hình 3. Giao diện quản lý danh mục sản phẩm trên hệ thống ERP.