Lưu ý: CSDL sử dụng MongoDB đã được tích hợp sẵn vào nên chỉ cần sử dụng mà không cần import. Nếu muốn xem chi tiết CSDL có thể liên hệ trực tiếp qua email: thinhphuc2704@gmail.com để được hỗ trợ.
Dự án được xây dựng theo mô hình Client-Server hiện đại, sử dụng React cho giao diện người dùng và Node.js (Express) kết hợp với cơ sở dữ liệu MongoDB cho hệ thống máy chủ. Các chức năng được chia làm hai phân hệ chính:
Phân Hệ Khách Hàng (Giao diện người dùng)
Đăng ký & Đăng nhập: Người dùng có thể tạo tài khoản, đăng nhập hệ thống hoặc sử dụng phương thức đăng nhập nhanh qua Google. Trạng thái đăng nhập được quản lý đồng bộ và bảo mật.
Trang chủ: Hiển thị thanh trượt banner quảng cáo thu hút, danh sách các danh mục nông sản nổi bật và các sản phẩm mới nhất.
Tìm kiếm & Duyệt sản phẩm: Khách hàng có thể xem toàn bộ danh sách nông sản, lọc theo danh mục cụ thể và chuyển trang mượt mà khi số lượng sản phẩm lớn.
Chi tiết sản phẩm: Hiển thị đầy đủ thông tin về nông sản bao gồm hình ảnh, mô tả chi tiết, giá cả và đơn vị tính.
Giỏ hàng & Thanh toán: Hỗ trợ thêm sản phẩm vào giỏ, điều chỉnh số lượng, tính toán tổng tiền và tiến hành đặt hàng bằng cách nhập thông tin giao nhận.
Quản lý đơn hàng cá nhân: Khách hàng dễ dàng theo dõi lịch sử mua sắm và trạng thái xử lý của từng đơn hàng đã đặt.
Trợ lý ảo thông minh (Chatbot): Tích hợp cửa sổ chat tự động để tư vấn, giải đáp thắc mắc và hỗ trợ người dùng tìm kiếm sản phẩm nhanh chóng.
Phân Hệ Quản Trị (Admin Dashboard)
Bảng điều khiển tổng quan: Thống kê các số liệu kinh doanh quan trọng thông qua biểu đồ doanh thu và biểu đồ trực quan về các sản phẩm bán chạy.
Quản lý người dùng: Xem danh sách thành viên, phân quyền tài khoản hoặc thực hiện khóa/mở khóa quyền truy cập của người dùng.
Quản lý sản phẩm: Cho phép admin thêm mới nông sản, cập nhật thông tin chi tiết, xóa sản phẩm và tải lên hình ảnh sản phẩm thông qua dịch vụ lưu trữ đám mây.
Quản lý danh mục: Tạo mới, chỉnh sửa hoặc xóa các danh mục sản phẩm để tổ chức gian hàng khoa học hơn.
Quản lý đơn hàng: Theo dõi toàn bộ đơn hàng phát sinh trên hệ thống, cập nhật trạng thái xử lý và vận chuyển cho khách hàng.
Hướng dẫn cài đặt
Để khởi chạy dự án trên máy tính cá nhân, bạn cần cài đặt sẵn Node.js và cơ sở dữ liệu MongoDB. Hãy thực hiện theo các bước sau:
Bước 1: Cấu hình và khởi chạy Server
Mở terminal và di chuyển vào thư mục dịch vụ máy chủ:
cd server
Cài đặt các thư viện và gói phụ thuộc cần thiết:
npm install
File .env cấu hình môi trường đã có sẵn, không cần setup thêm, chỉ việc dùng
Khởi động server:
npm run dev
Bước 2: Cấu hình và khởi chạy Client
Mở một cửa sổ terminal mới và di chuyển vào thư mục giao diện:
cd client
Cài đặt các gói phụ thuộc cho giao diện:
npm install
File .env cấu hình môi trường đã có sẵn, không cần setup thêm, chỉ việc dùng
Khởi chạy giao diện người dùng ở chế độ phát triển:
npm run dev
Sau khi hoàn thành, bạn có thể mở trình duyệt web và truy cập vào địa chỉ hiển thị trên terminal (thông thường là http://localhost:5173) để trải nghiệm hệ thống thương mại điện tử nông sản.
TÀI KHOẢN ADMIN: admin@gmail.com, password: 123456
Để khởi chạy dự án trên máy tính cá nhân, bạn cần cài đặt sẵn Node.js và cơ sở dữ liệu MongoDB. Hãy thực hiện theo các bước sau:
Bước 1: Cấu hình và khởi chạy Server
Mở terminal và di chuyển vào thư mục dịch vụ máy chủ:
cd server
Cài đặt các thư viện và gói phụ thuộc cần thiết:
npm install
File .env cấu hình môi trường đã có sẵn, không cần setup thêm, chỉ việc dùng
Khởi động server:
npm run dev
Bước 2: Cấu hình và khởi chạy Client
Mở một cửa sổ terminal mới và di chuyển vào thư mục giao diện:
cd client
Cài đặt các gói phụ thuộc cho giao diện:
npm install
File .env cấu hình môi trường đã có sẵn, không cần setup thêm, chỉ việc dùng
Khởi chạy giao diện người dùng ở chế độ phát triển:
npm run dev
Sau khi hoàn thành, bạn có thể mở trình duyệt web và truy cập vào địa chỉ hiển thị trên terminal (thông thường là http://localhost:5173) để trải nghiệm hệ thống thương mại điện tử nông sản.
TÀI KHOẢN ADMIN: admin@gmail.com, password: 123456