FruitHub là nền tảng thương mại điện tử chuyên cung cấp trái cây và nông sản tươi sạch theo mô hình Farm-to-Table, được phát triển nhằm rút ngắn chuỗi cung ứng giữa các hợp tác xã nông sản sạch và người tiêu dùng thành thị.

Hệ thống giải quyết triệt để các bài toán đặc thù của thương mại nông sản: kiểm soát độ tươi mới và hạn sử dụng theo từng lô hàng, tính toán cước phí giao hàng linh hoạt theo khoảng cách thực tế, và cung cấp giải pháp quản trị kho hàng đa chức năng cho chủ cửa hàng.

Khách hàng trải nghiệm giao diện mua sắm trực quan: dễ dàng tìm kiếm và lọc sản phẩm theo danh mục (trái cây nội địa, nhập khẩu, rau củ organic), xem thông tin dinh dưỡng, nguồn gốc xuất xứ và đánh giá sao từ người mua trước. Giỏ hàng thông minh tự động kiểm tra số lượng tồn kho và áp dụng mã khuyến mãi.

Điểm nhấn nghiệp vụ là tính năng tính phí vận chuyển tự động bằng công thức Haversine dựa trên khoảng cách tọa độ thực tế giữa kho hàng và địa chỉ giao hàng của khách, đảm bảo cước phí minh bạch mà không tốn chi phí gọi API bản đồ đắt đỏ. Khách hàng theo dõi toàn diện trạng thái đơn hàng theo thời gian thực.

Phân hệ Quản trị viên (Admin Dashboard) cung cấp bảng điều khiển trực quan: quản lý danh mục và tồn kho sản phẩm, tải lên nhiều ảnh tối ưu qua Cloudinary, tiếp nhận và chuyển đổi trạng thái đơn hàng (Chờ xác nhận, Đang đóng gói, Đang giao, Hoàn tất), cùng các biểu đồ phân tích doanh thu chi tiết theo ngày.

Hệ thống áp dụng mô hình kiến trúc phân tầng 3-tier rõ ràng (View - Controller - Model): Frontend xây dựng bằng React 19 kết hợp Tailwind CSS đảm bảo tốc độ tải trang nhanh và giao diện responsive mượt mà trên thiết bị di động. Backend RESTful API phát triển bằng Node.js và Express, xử lý logic nghiệp vụ an toàn.

Cơ sở dữ liệu MongoDB lưu trữ cấu trúc document linh hoạt, tối ưu hóa các thao tác truy vấn giỏ hàng và đơn hàng lồng nhau. Dịch vụ Cloudinary được tích hợp cho toàn bộ tài nguyên hình ảnh với cơ chế tự động nén, tạo thumbnail và chuyển đổi định dạng WebP, giảm tải băng thông tối đa cho máy chủ.

Công nghệ sử dụng: React 19, Tailwind CSS, Node.js, MongoDB, Cloudinary.

Mã nguồn backend tuân thủ nguyên tắc Separation of Concerns, phân tách rõ ràng giữa Controller, Service, Model và Helper. Quy trình đặt hàng được đóng gói trong tầng Service để đảm bảo tính toàn vẹn: xác thực tồn kho, khóa sản phẩm, áp dụng voucher, tính cước Haversine và ghi nhận đơn hàng nguyên khối.

Dự án tích hợp hệ thống xác thực JWT an toàn kết hợp phân quyền Role-Based Access Control (RBAC) giữa người mua và quản trị viên. Trải qua hơn 100 lần deploy và thử nghiệm trên Vercel và Render, hệ thống đạt độ ổn định cao và sẵn sàng đáp ứng lưu lượng truy cập mua sắm thực tế.