Sổ Tay Bàn Giao & Lưu Ý Quan Trọng Hệ Thống Vion Cloud

Dưới đây là toàn bộ hệ thống vừa được thiết lập trên Vion Cloud. Bạn nên lưu lại thông tin này để quản lý và vận hành lâu dài:

1. Thông tin Kết nối VPS Vion Cloud

Địa chỉ IP VPS: 103.213.216.31
Cổng SSH (Port): 22
Tên đăng nhập (User): root
Mật khẩu SSH: x2CSproPp4Q1
Thư mục chứa dự án trên VPS: /var/www/vinhphaterp

Lưu ý bảo mật: Bạn nên lưu trữ mật khẩu an toàn hoặc tiến hành đổi mật khẩu ngay sau khi nhận bàn giao.

2. Quy trình Cập nhật Code Mới (Deploy)

Từ nay, bạn không cần truy cập VPS để cập nhật code nữa. Hệ thống đã cài GitHub Actions (CI/CD) tự động. Bạn chỉ cần thực hiện các lệnh Git cơ bản:

git add .
git commit -m "Cập nhật tính năng mới"
git push origin main

Sau khi push, GitHub sẽ tự động SSH vào VPS, pull code, build và reload app trong vòng 1 - 2 phút.

Nguyên tắc vận hành: Mọi cập nhật tính năng mới đều được tự động hóa hoàn toàn qua GitHub Actions, giúp giảm thiểu thao tác thủ công trên máy chủ.

3. Lưu ý về Cloudflare Turnstile & Tên miền (Domain)

Khi chưa trỏ Tên miền (Đang dùng IP 103.213.216.31)
Cloudflare Turnstile sẽ báo "Unable to connect to website" vì mã Sitekey đang đăng ký theo tên miền.
Khi bạn mua / trỏ Tên miền chính thức về VPS
- Bước 1: Vào nhà cung cấp Tên miền ➔ Tạo bản ghi A Record:
  - Host/Name: @ (hoặc quantri)
  - Value/IP: 103.213.216.31
- Bước 2: Đăng nhập VPS và chạy 1 dòng lệnh để bật SSL Miễn phí (HTTPS):
```
sudo certbot --nginx -d ten-mien-cua-ban.com
```
- Bước 3: Vào Cloudflare Dashboard ➔ Turnstile ➔ Thêm tên miền của bạn vào danh sách Allowed Domains.

4. Lệnh Quản trị VPS Thường Dùng (Cho Admin)

Nếu bạn SSH vào VPS bằng phần mềm như PuTTY, MobaXterm, hoặc Terminal, hãy sử dụng các lệnh sau:

Nhu cầu	Lệnh thực thi trên VPS
Xem danh sách app đang chạy	pm2 status
Xem log realtime của Backend API	pm2 logs vinhphat-api
Restart lại Backend API	pm2 restart vinhphat-api
Restart Web Server Nginx	sudo systemctl restart nginx
Sửa file môi trường .env Frontend	nano /var/www/vinhphaterp/.env
Sửa file môi trường .env Backend	nano /var/www/vinhphaterp/server/.env

5. Các GitHub Secrets Đã Lưu

Trên GitHub Repository (Settings ➔ Secrets ➔ Actions), hệ thống đã cấu hình các biến sau (không cần sửa trừ khi đổi VPS):

VION_VPS_HOST: 103.213.216.31
VION_VPS_USERNAME: root
VION_VPS_PORT: 22
VION_VPS_SSH_KEY: Key mã hóa tự động

So Sánh Triển Khai Dự Án VinhPhatERP Trên Vion Cloud (VPS) Và Vercel

Dưới đây là bảng so sánh chi tiết giữa việc deploy dự án VinhPhatERP trên Vion Cloud (VPS) và Vercel.

Bảng So Sánh Trực Quan

Tiêu chí so sánh	Vion Cloud (VPS Linux)	Vercel (Serverless PaaS)
Kiến trúc ứng dụng	Fullstack Server truyền thống: Chạy cả Frontend React lẫn Backend Node.js (Hono API) liên tục 24/7 bằng PM2.	Serverless: Tối ưu nhất cho Frontend (React/Next.js). Backend phải chạy dạng Serverless Function.
Tốc độ truy cập tại VN	Cực nhanh (Latency < 10ms) vì Server đặt trực tiếp tại các Data Center tại Việt Nam. Không lo đứt cáp biển.	Nhanh về CDN Static, nhưng API Serverless ở server nước ngoài (Singapore/US) có thể hơi độ trễ nhẹ.
Giới hạn thời gian (Timeout)	Không giới hạn. Thích hợp cho ERP xuất file Excel nặng, báo cáo phức tạp, cronjob, background job.	Bị giới hạn 10s - 60s/request. Nếu xử lý tác vụ ERP nặng sẽ dễ bị lỗi Timeout (504).
Chi phí	Giá cố định hàng tháng (ví dụ: vài trăm nghìn/tháng). Băng thông thả ga, không phát sinh chi phí ẩn.	Miễn phí gói Hobby (cá nhân). Tuy nhiên gói Pro ($20+/tháng) và tính tiền theo dung lượng/lượt request khi dùng nhiều.
Quyền quản trị & Tùy biến	Toàn quyền Root: Tự do cài thêm Redis, Docker, RabbitMQ, lưu file ổ cứng local, tạo Cronjob hệ thống.	Bị giới hạn: Không có ổ cứng lưu file cố định, không cài được phần mềm hệ thống ngoài môi trường Node.
Quản lý & Bảo trì	Cần tự quản lý Server (Nginx, Node, SSL, Security). (Tuy nhiên AI đã cấu hình sẵn CI/CD cho bạn rồi).	Tự động 100%: Vercel lo hết phần hạ tầng, SSL, CDN.

Lời Khuyên Cho Dự Án VinhPhatERP

1. Vì sao Vion Cloud (VPS) là lựa chọn tối ưu cho ERP của bạn?

VinhPhatERP có cấu trúc Fullstack (React + Hono Node Server riêng). Trên VPS, Node Server chạy liên tục bằng PM2, xử lý mượt các tác vụ ERP (tính toán đơn hàng, xuất hóa đơn, in phiếu, gọi API Supabase) mà không bị đứt kết nối hay dính giới hạn Serverless Timeout.
Server ở Việt Nam giúp nhân viên trong công ty bạn truy cập phần mềm ERP với tốc độ tức thì, ổn định ngay cả khi cáp quang biển gặp sự cố.

Đánh giá ưu tiên: Vion Cloud (VPS) mang lại sự ổn định, toàn quyền kiểm soát và tốc độ truy cập tức thì tại Việt Nam, rất phù hợp cho hệ thống ERP Fullstack.

2. Khi nào nên dùng Vercel?

Vercel rất xuất sắc nếu bạn làm trang Landing Page, Web bán hàng, Blog, hoặc app chỉ có Frontend.
Nếu muốn dùng Vercel cho dự án ERP này, bạn sẽ phải tách Backend Hono ra deploy riêng ở 1 chỗ khác hoặc chuyển Backend sang cấu hình Serverless Function adapter phức tạp hơn.

Lưu ý đặc biệt: Chỉ nên sử dụng Vercel cho các dự án thuần Frontend hoặc Landing Page. Triển khai ERP trên Vercel sẽ gặp rủi ro Timeout và đòi hỏi phải tách rời hạ tầng Backend phức tạp.

VPS Vion Cloud