MÔ TẢ CHỨC NĂNG DỰ ÁN
Hệ thống FastFood Pro là một nền tảng quản lý và bán hàng đồ ăn nhanh (Fast Food) toàn diện, khép kín từ khâu đặt hàng của khách hàng đến quản trị chuỗi cung ứng, tồn kho nguyên liệu và tài chính của cửa hàng.
💎 Phân hệ Khách hàng (Frontend Client)
-
Trải nghiệm mua sắm Premium: Giao diện Glassmorphism thời thượng, hiệu ứng mượt mà (Framer Motion).
-
Tìm kiếm & Bộ lọc thông minh: Tìm kiếm Full-text search, lọc nhanh theo danh mục món ăn (Hamburger, Pizza, Gà Rán, Đồ uống,...), giá cả và thẻ tag.
-
Giỏ hàng Real-time: Thêm, sửa, xóa sản phẩm trong giỏ hàng tức thời.
-
Xác thực bảo mật: Đăng nhập/Đăng ký qua mã xác thực Email OTP và cơ chế bảo mật JWT (Access/Refresh Token qua HttpOnly Cookie).
-
Đánh giá & Review: Hệ thống đánh giá 5 sao kèm phản hồi và tự động tính điểm rating trung bình cho từng món ăn.
-
Theo dõi đơn hàng Real-time: Khách hàng nhận thông báo thay đổi trạng thái đơn hàng tức thì (đang chuẩn bị, đang giao, đã giao) qua Socket.io.
📊 Phân hệ Quản trị & Vận hành (Admin Dashboard)
-
Quản lý Kho Nguyên Liệu động: Theo dõi kho tồn thực tế của từng nguyên liệu thô (bột mỳ, thịt bò, phô mai,...), đơn vị tính và giá vốn tương ứng.
-
Tự động tính Giá Vốn Trung Bình (Weighted Average Cost): Khi admin nhập thêm nguyên liệu vào kho với giá mới, hệ thống tự động tính toán lại đơn giá vốn trung bình (COGS) của nguyên liệu đó để đảm bảo độ chính xác tài chính.
-
Quản lý Công Thức (Recipe): Thiết lập định lượng nguyên liệu cho từng món ăn (Ví dụ: 1 Hamburger bò cần: 2 lát bánh mì, 150g thịt bò, 1 lát phô mai).
-
Tồn Kho Động: Hệ thống tự động tính toán số lượng món ăn tối đa có thể bán dựa trên lượng nguyên liệu thực tế còn lại trong kho.
-
Báo cáo Tài chính Real-time: Dashboard hiển thị biểu đồ phân tích trực quan về Doanh thu, Chi phí giá vốn (COGS), Lợi nhuận gộp và Tỷ suất lợi nhuận (Margin) theo ngày/tháng.
-
Dự báo & Cảnh báo kho: Tự động đưa ra cảnh báo khi nguyên liệu chạm ngưỡng tối thiểu để admin kịp thời nhập hàng.
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
Nguồn: Sharecode.vn
📋 Yêu cầu hệ thống
-
Node.js: Phiên bản >= 18.x
-
MongoDB: Cơ sở dữ liệu NoSQL (Local hoặc Atlas)
-
Redis: Dịch vụ lưu trữ đệm (Cache) dùng cho BullMQ và Rate limit
Bước 1: Khởi chạy Redis & MongoDB (Nếu dùng Docker)
Nếu bạn có Docker trên máy, hãy khởi chạy nhanh Redis và MongoDB:
docker-compose up -d
Hoặc cấu hình trỏ thẳng biến môi trường về dịch vụ MongoDB/Redis có sẵn trên VPS của bạn.
Bước 2: Cài đặt & Khởi chạy Backend (Server)
-
Di chuyển vào thư mục backend và cài đặt thư viện:
-
Tạo file .env từ file mẫu .env.example và điền thông số kết nối:
-
Chạy script để khởi tạo dữ liệu danh mục, tài khoản mẫu và công thức món ăn:
npm run seed
node src/seeds/ingredient_seed.js
-
Khởi chạy server ở chế độ phát triển:Backend sẽ chạy tại: http://localhost:5000
npm run dev
Bước 3: Cài đặt & Khởi chạy Frontend (Client)
-
Di chuyển vào thư mục frontend và cài đặt thư viện:
cd ../frontend
npm install
-
Khởi chạy server dev:Frontend sẽ chạy tại: http://localhost:5173
npm run dev
🔑 Tài khoản dùng thử (Demo)