Full Source Code Quản Lý Nhà Hàng F&B Chuẩn Enterprise - NextJS 16 + NestJS (Đủ POS, QR Order, KDS, Kho, Lương, AI) - Giá Chỉ 10 Triệu!
(#776) Full Source Code Quản Lý Nhà Hàng F&B Chuẩn Enterprise - NextJS 16 + NestJS (Đủ POS, QR Order, KDS, Kho, Lương, AI) - Giá Chỉ 10 Triệu!
10.000.000 đ
Mô tả
BÁN SOURCE CODE PHẦN MỀM QUẢN LÝ NHÀ HÀNG & F&B MULTI-TENANT (NEXT.JS 16 + NESTJS 11)
Bạn đang tìm kiếm bộ mã nguồn phần mềm quản lý nhà hàng F&B chuẩn Enterprise để làm sản phẩm SaaS bán thương mại, làm đồ án lớn hoặc triển khai cho khách hàng? HelloYou là hệ thống quản lý vận hành F&B full-stack hoàn chỉnh, tích hợp đầy đủ từ POS bán hàng, Gọi món QR Code, Màn hình bếp KDS, Quản lý kho nguyên liệu, Chấm công tính lương đến Trợ lý AI.
🌟 1. Tổng Quan Mã Nguồn Quản Lý F&B HelloYou
HelloYou được phát triển trên kiến trúc Multi-Tenant & Multi-Branch (Nhiều công ty / Nhiều chi nhánh), hỗ trợ một hệ thống đáp ứng vô số cửa hàng F&B đồng thời:
Tên sản phẩm: Mã nguồn hệ thống quản lý vận hành F&B HelloYou
Công nghệ Frontend: Next.js 16 (App Router), React 19, Tailwind CSS, HeroUI, Zustand.
Công nghệ Backend: NestJS 11, MongoDB (Mongoose), Redis, BullMQ Worker, Socket.IO, MinIO.
Hình thức: Bán full Source Code không mã hóa, sở hữu vĩnh viễn.
🚀 2. Chi Tiết Các Phân Hệ Tính Năng Chuẩn F&B
🛒 2.1. Phần Mềm POS Bán Hàng & Quản Lý Sơ Đồ Bàn
Sơ đồ bàn kéo thả: Cấu hình khu vực (Zone) và sơ đồ bàn ăn trực quan dạng đồ họa (@xyflow/react).
Thao tác đơn hàng: Mở bàn, chuyển bàn, gộp bàn, tách hóa đơn, quản lý lượt gọi món (Dining Rounds).
In hóa đơn & Thanh toán: Tích hợp in hóa đơn trực tiếp, thanh toán chuyển khoản qua mã QR động (VietQR).
📱 2.2. Hệ Thống Gọi Món QR Code (Storefront QR Order)
Khách hàng quét mã QR tại bàn bằng smartphone để xem thực đơn điện tử và đặt món trực tiếp.
Đơn hàng tự động đồng bộ xuống thu ngân POS và nhà bếp mà khách không cần tải app.
🍳 2.3. Màn Hình Nhà Bếp KDS (Kitchen Display System)
Nhận đơn Realtime qua kết nối WebSocket (Socket.IO).
Bếp cập nhật trạng thái chế biến (Chờ làm -> Đang làm -> Hoàn thành), giảm thiểu sót đơn giờ cao điểm.
📦 2.4. Quản Lý Kho & Định Lượng Nguyên Liệu (BOM)
Cấu hình định lượng nguyên liệu chi tiết cho từng món ăn (Bill of Materials).
Tự động trừ kho nguyên liệu chính xác ngay khi bán đơn hàng. Quản lý nhập - xuất - điều chuyển kho.
👥 2.5. Quản Lý Nhân Sự, Chấm Công & Bảng Lương (HR & Payroll)
Phân ca làm việc, chấm công nhân viên, quản lý đơn nghỉ phép và duyệt tạm ứng lương.
Tự động tổng hợp công và xuất phiếu lương (Pay Slip) hàng tháng.
🤖 2.6. Trợ Lý AI Thông Minh & Chat Nội Bộ
Tích hợp chuỗi AI (Gemini, OpenAI, Claude) hỗ trợ chủ nhà hàng tra cứu báo cáo và tư vấn vận hành.
Hệ thống Chat Realtime nội bộ giữa các bộ phận (Thu ngân - Bếp - Quản lý).
🛠️ 3. Thông Số Kỹ Thuật & Cấu Trúc Mã Nguồn
text
helloyou/
├── src/ # Frontend Next.js 16 (App Router, Tailwind, HeroUI)
│ ├── app/ # Các tuyến đường giao diện (Orders, Kitchen, Warehouse, HR...)
│ ├── components/ # Components giao diện tái sử dụng
│ ├── stores/ # Quản lý state với Zustand
│ └── services/ # Kết nối API Backend
├── backend/ # Backend NestJS 11 (MongoDB, Redis, Socket.IO)
│ ├── src/modules/ # Các module nghiệp vụ độc lập (Orders, Payroll, Inventory...)
│ └── src/queue/ # Tiến trình xử lý hàng chờ BullMQ Worker
├── Dockerfile # File đóng gói Docker Frontend & Backend
└── docker-compose.yml # Cấu hình tự động chạy MongoDB, Redis, MinIO, API & Worker
💵 4. Giá Bán & Quyền Lợi Sở Hữu
💰 Giá bán trọn gói: 10.000.000 VNĐ (Thanh toán 1 lần - Sở hữu vĩnh viễn).
📦 Bàn giao: Full Source Code Zip + File hướng dẫn cài đặt chi tiết
SETUP_GUIDE.md
🛠️ Bảo hành: 03 tháng bảo hành lỗi mã nguồn gốc đã bao gồm trong hợp đồng.
Hướng dẫn cài đặt
# 🛠️ HƯỚNG DẪN CÀI ĐẶT VÀ VẬN HÀNH HELLOYOU (LINUX & WINDOWS)
Tài liệu hướng dẫn cài đặt toàn diện hệ thống **HelloYou** trên cả 2 hệ điều hành **Linux** và **Windows**.
---
## 🛠️ YÊU CẦU TIỀN ĐỀ (PREREQUISITES)
Trước khi cài đặt, máy tính/server cần được cài đặt sẵn:
1. **Bun** (Phiên bản `>= 1.2.23` - *Bắt buộc dùng Bun cho cả Root và Backend*).
2. **Node.js** (Phiên bản `>= 20.19.0`).
3. **Docker & Docker Compose** *(Cách nhanh nhất để chạy MongoDB, Redis & MinIO)*.
4. **Git**.
---
## 🐧 PHẦN 1: HƯỚNG DẪN CÀI ĐẶT TRÊN LINUX (UBUNTU / DEBIAN / CENTOS)
### Cách 1: Triển khai nhanh bằng Docker Compose (Khuyên dùng cho Server/Production)
1. **Clone mã nguồn dự án:**
```bash
git clone https://github.com/your-repo/helloyou.git
cd helloyou
```
2. **Cấu hình file môi trường (.env):**
```bash
cp .env.example .env
cp .env.example backend/.env
```
*(Chỉnh sửa các khóa bí mật `JWT_ACCESS_SECRET`, `JWT_REFRESH_SECRET` trong file `.env`)*
3. **Khởi chạy toàn bộ hệ thống qua Docker:**
```bash
docker compose up -d
```
*Hệ thống sẽ tự động tải và khởi chạy 5 containers: Frontend (Cổng 3001), Backend API (Cổng 3002), Worker, MongoDB, Redis, MinIO.*
4. **Khởi tạo dữ liệu mẫu (Seed Data):**
```bash
# Chạy script tạo tài liệu mẫu và phân quyền ban đầu
docker compose exec backend bun x tsx src/seed.ts
docker compose exec backend bun x tsx src/seed-acl.ts
```
---
### Cách 2: Triển khai trực tiếp (Chạy Local/Development trên Linux)
1. **Cài đặt Bun (nếu chưa có):**
```bash
curl -fsSL https://bun.sh/install | bash
source ~/.bashrc
```
2. **Cài đặt dependencies cho cả Root & Backend:**
```bash
# Tại thư mục gốc dự án
bun install
# Cài đặt cho Backend
bun install --cwd backend
```
3. **Bật các dịch vụ hỗ trợ (MongoDB, Redis, MinIO):**
Bạn có thể bật nhanh 3 dịch vụ cơ sở dữ liệu qua Docker:
```bash
docker compose up -d mongodb redis minio
```
4. **Khởi tạo dữ liệu mẫu (Seed Data):**
```bash
cd backend
bun x tsx src/seed.ts
bun x tsx src/seed-acl.ts
cd ..
```
5. **Khởi chạy môi trường Dev:**
```bash
# Chạy đồng thời cả Frontend (Port 3000) và Backend API (Port 3002)
bun dev
```
- Frontend truy cập tại: `http://localhost:3000` hoặc `http://localhost:3001`
- Backend API truy cập tại: `http://localhost:3002`
---
## 🪟 PHẦN 2: HƯỚNG DẪN CÀI ĐẶT TRÊN WINDOWS (WINDOWS 10 / 11)
### Cách 1: Sử dụng Docker Desktop (Dễ nhất & Không lo lỗi môi trường)
1. **Tải và cài đặt [Docker Desktop cho Windows](https://www.docker.com/products/docker-desktop/)** (Đảm bảo đã bật WSL2 Backend).
2. **Mở PowerShell hoặc Command Prompt (CMD) dưới quyền Administrator:**
```powershell
git clone https://github.com/your-repo/helloyou.git
cd helloyou
```
3. **Tạo file môi trường `.env`:**
```powershell
copy .env.example .env
copy .env.example backend\.env
```
4. **Chạy hệ thống:**
```powershell
docker compose up -d
```
5. **Khởi tạo dữ liệu:**
```powershell
docker compose exec backend bun x tsx src/seed.ts
docker compose exec backend bun x tsx src/seed-acl.ts
```
---
### Cách 2: Chạy trực tiếp trên Windows (qua PowerShell / Terminal)
1. **Cài đặt Bun trên Windows (bằng PowerShell):**
```powershell
powershell -c "irm bun.sh/install.ps1 | iex"
```
2. **Cài đặt thư viện dependencies:**
```powershell
# Cài đặt thư mục root
bun install
# Cài đặt thư mục backend
cd backend
bun install
cd ..
```
3. **Chạy các Database (MongoDB, Redis, MinIO):**
*Nên chạy MongoDB, Redis qua Docker Desktop để có sẵn ReplicaSet:*
```powershell
docker compose up -d mongodb redis minio
```
4. **Seed dữ liệu vào Database:**
```powershell
cd backend
bun x tsx src/seed.ts
bun x tsx src/seed-acl.ts
cd ..
```
5. **Khởi chạy ứng dụng:**
```powershell
bun dev
```
---
## 📋 CÁC LỆNH KIỂM TRA & QUẢN LÝ THƯỜNG DÙNG
| Thao tác | Lệnh thực hiện |
| :--- | :--- |
| **Kiểm tra Typecheck Frontend** | `bun run typecheck` |
| **Kiểm tra Typecheck Backend** | `bun run typecheck:backend` |
| **Chạy riêng Frontend** | `bun run dev:frontend` |
| **Chạy riêng Backend** | `bun run dev:backend` |
| **Chạy riêng Background Worker** | `bun run start:worker` |
| **Xóa sạch dữ liệu Database** | `cd backend && bun x tsx src/clear.ts` |
Hình ảnh demo