7 bước triển khai Lê Yến Travel CRM lên hosting (cPanel, aaPanel, DirectAdmin…)
| Hạng mục | Tối thiểu |
|---|---|
| PHP | 8.1+ (khuyến nghị 8.2) |
| MySQL | 8.0 hoặc MariaDB 10.6+ |
| Extension PHP | pdo_mysql, mbstring, openssl, tokenizer, xml, ctype, json, bcmath, fileinfo |
| Composer | Có trong Terminal cPanel, hoặc upload sẵn thư mục vendor/ |
| Node.js + npm | 18+ — dùng khi build CSS trên server. Nếu không có Node: build trên máy dev rồi upload thư mục public/build/ |
| Cron | Bắt buộc cho nhắc thu / tour sắp đi tự động |
Upload toàn bộ project (FTP / File Manager) vào ví dụ /home/user/leyentravel/
Khuyến nghị
cPanel → Domains → chỉnh Document Root thành:
/home/user/leyentravel/public
Laravel chỉ expose thư mục public/ ra internet — an toàn hơn để code ở thư mục cha.
Nếu host không cho đổi docroot: xem mục «Phương án B» cuối trang.
cPanel → MySQL Databases:
user_leyentravel)Ghi lại: DB_HOST (thường localhost), tên DB, user, password.
.envSao chép .env.example thành .env trên server. Không upload .env từ máy dev.
APP_NAME="Lê Yến Travel CRM" APP_ENV=production APP_KEY= APP_DEBUG=false APP_URL=https://your-domain.com DB_CONNECTION=mysql DB_HOST=localhost DB_PORT=3306 DB_DATABASE=ten_database DB_USERNAME=ten_user DB_PASSWORD=mat_khau CACHE_DRIVER=file SESSION_DRIVER=file QUEUE_CONNECTION=sync
APP_URL phải đúng domain thật (https://…). Email nhắc thu, link phiếu xác nhận khách, VietQR đều dùng domain này.
cPanel → Terminal hoặc SSH:
cd ~/leyentravel composer install --no-dev --optimize-autoloader php artisan key:generate php artisan migrate --force php artisan storage:link
Lệnh migrate tạo toàn bộ bảng + index hiệu năng + cột công nợ lưu sẵn trên đơn hàng. Chạy lại an toàn khi cập nhật phiên bản mới.
Nạp dữ liệu:
# Production (dữ liệu thật đã export) php artisan db:import-production --force # Hoặc bộ demo cho khách xem thử (10 NCC, 20 đơn, 10 tour…) php artisan db:seed --class=DemoDataSeeder --force
Sau khi seed demo (chỉ local), bật SHOWCASE_ENABLED=true trong .env để mở /vi-du-thuc-te. Production: giữ SHOWCASE_ENABLED=false.
Tối ưu cache (sau migrate / seed):
php artisan config:cache php artisan route:cache php artisan view:cache
CRM không còn dùng Tailwind CDN. Thiếu bước này → trang trắng / mất style. Chọn một trong hai cách:
Cách A — Build trên server (có Node.js)
cd ~/leyentravel npm install npm run build
cPanel: Setup Node.js App → chọn phiên bản 18+, thư mục project → chạy lệnh trên trong Terminal.
Cách B — Build trên máy dev rồi upload
npm install && npm run buildpublic/build/ lên server — giữ nguyên cấu trúcpublic/build/manifest.json
Mỗi lần cập nhật code có đổi giao diện, phải chạy lại npm run build (hoặc upload lại public/build/).
chmod -R 775 storage bootstrap/cache
Hoặc File Manager: chuột phải storage/ và bootstrap/cache/ → Permissions → 775.
cPanel → Cron Jobs → chạy mỗi phút:
* * * * * cd /home/user/leyentravel && php artisan schedule:run >> /dev/null 2>&1
Thay /home/user/leyentravel bằng đường dẫn thật trên host.
Lịch tự động trong CRM:
Đăng nhập Admin → sidebar Cài đặt hệ thống:
| Thông tin công ty | Tên, hotline, STK VietQR doanh nghiệp & cá nhân |
| Mail / SMTP | Gửi nhắc thu, nhắc NCC; bật gửi tự động nếu cần |
| AI / Gemini | Bóc tách khách đoàn, tạo đơn từ chat, CTV viết bài |
| Zalo OA | Token OA (tùy chọn) — trang nhắc thu luôn có copy tin Zalo |
Checklist sau deploy:
/ — Trang chủ marketing/login — Đăng nhập CRM/tra-cuu-don — Khách tra cứu đơn/dashboard — Tổng quan (sau login)public/build/)
Bảo mật: Đổi mật khẩu tất cả tài khoản ngay sau khi import. Đặt APP_DEBUG=false, SHOWCASE_ENABLED=false trên production.
Cron: Thêm * * * * * php artisan schedule:run — nhắc nợ khách/NCC và tour khởi hành chạy theo lịch này.
Mỗi lần upload code mới lên server:
cd ~/leyentravel composer install --no-dev --optimize-autoloader php artisan migrate --force npm install && npm run build php artisan config:cache php artisan route:cache php artisan view:cache
Nếu host không có Node: build public/build/ trên máy dev rồi upload thay thế.
Một số host chỉ cho public_html:
/home/user/leyentravel/, trỏ subdomain vào leyentravel/public nếu host hỗ trợ.public/ vào public_html/, sửa đường dẫn index.php trỏ lên thư mục cha.index.php ở gốc (require public/index.php) nếu docroot là thư mục gốc — vẫn chạy được nhưng kém an toàn hơn phương án A.