# Cài BD Offers Mini App trên Namecheap cPanel

## 1. Yêu cầu

- cPanel có mục `Setup Node.js App`.
- Chọn Node.js 22.
- Tạo subdomain, ví dụ `offers.example.com`.

## 2. Upload

1. Mở cPanel > File Manager.
2. Vào Home Directory, không vào `public_html`.
3. Tạo thư mục `bd-offers-miniapp`.
4. Upload và giải nén toàn bộ ZIP vào thư mục này.

Sau khi giải nén, `package.json` và `server.js` phải nằm trực tiếp tại:

`/home/CPANEL_USER/bd-offers-miniapp/`

Không để thành hai lớp như `bd-offers-miniapp/bd-offers-miniapp/server.js`.

## 3. Tạo Node.js App

Vào cPanel > Setup Node.js App > Create Application:

- Node.js version: `22`
- Application mode: `Production`
- Application root: `bd-offers-miniapp`
- Application URL: subdomain đã tạo
- Application startup file: `server.js`

Nhấn Create.

## 4. Cài dependency và khởi động

Trong màn hình quản lý app, nhấn `Run NPM Install`, sau đó nhấn `Restart`.

Gói ZIP đã có sẵn thư mục `.next` được build ở chế độ production. Nếu cPanel xóa
thư mục này, hoặc sau này cậu chỉnh source, hãy mở Terminal/SSH, kích hoạt virtual
environment bằng câu lệnh cPanel hiển thị rồi chạy:

```bash
cd ~/bd-offers-miniapp
npm run build
```

Sau đó quay lại Setup Node.js App và nhấn `Restart`.

## 5. Kiểm tra

- Mini App: `https://offers.example.com/`
- Admin prototype: `https://offers.example.com/admin`

## 6. Lưu ý

- Admin hiện là prototype frontend, chưa có database và đăng nhập.
- Không nhập affiliate URL, Telegram token hoặc mật khẩu thật.
- Nút PLAY chưa redirect ra operator thật.
- Chỉ dùng để kiểm tra giao diện trước khi hoàn thiện backend.