# Deploy HỘI CHỢ LAB lên Tenten cPanel Jupiter — Từng bước

## Khả năng hạ tầng và nguyên tắc

HỘI CHỢ LAB là **static website**: chỉ HTML/CSS/JavaScript; không cần PHP runtime, MySQL, Node.js server, API key, Terminal, Composer hay thay đổi PHP version. Mọi tính toán chạy trong browser và dữ liệu lưu bằng localStorage theo origin. `HoiChoLab_Public.zip` gồm `index.html`, `assets/`, `.htaccess`, `robots.txt` ở cấp đầu.

Giải pháp an toàn mặc định: **tạo subdomain riêng** như `hoicholab.smartgear.website` để không ghi đè `smartgear.website` hoặc `fairplan.smartgear.website` đang có. Đây chỉ là ví dụ; kiểm tra danh sách Domains thực tế trước khi sử dụng.

## 1. Kiểm tra và sao lưu

**BẤM ĐÂU:** cPanel → Domains → List Domains; ghi lại domain và Document Root. Sau đó cPanel → Backup Wizard / Backup để tải backup tài khoản hoặc dùng File Manager nén thư mục tương ứng.

**LÀM GÌ:** Xác định domain mới; chỉ tạo khi chưa trùng. Nếu có file/dữ liệu ở Document Root dự kiến, backup và đặt tên thư mục khác, không xóa/overwrite.

**DẤU HIỆU THÀNH CÔNG:** Có bản ZIP backup tải được, Document Root được ghi nhận rõ.

**NẾU LỖI:** Đừng thao tác xóa, giữ nguyên website hiện tại.

## 2. Tạo subdomain độc lập

**BẤM ĐÂU:** cPanel → Domains → Create A New Domain.

**LÀM GÌ:** nhập ví dụ `hoicholab.smartgear.website`; **bỏ chọn Share document root**; Document Root nhập `public_html/hoicholab` (nếu thư mục này chưa chứa gì, thực tế cPanel cho phép). Nhấn Submit.

**DẤU HIỆU THÀNH CÔNG:** Trong Domains, `hoicholab.smartgear.website` trỏ `/public_html/hoicholab`, `smartgear.website` vẫn trỏ `/public_html`.

**NẾU LỖI:** Nếu subdomain không tạo được, kiểm tra quota/tên trùng và screenshot thông báo; không đổi Document Root của website chính.

## 3. Upload production ZIP

**BẤM ĐÂU:** cPanel → File Manager → `public_html` → `hoicholab` (hoặc Document Root thực tế ghi trong Domains).

**LÀM GÌ:** xác nhận thư mục trống hoặc đã backup. Chọn Upload → `HoiChoLab_Public.zip` → hoàn thành 100% → Go Back → chọn ZIP → Extract ngay tại Document Root. Đảm bảo không có lớp thư mục `public/`, `dist/`, `hoicholab/` lồng thừa.

**DẤU HIỆU THÀNH CÔNG:** Tại Document Root nhìn thấy:

```
index.html
assets/
  styles.css
  engine.js
  app.js
robots.txt
.htaccess
```

Nếu không thấy `.htaccess`: File Manager → Settings → Show Hidden Files (dotfiles).

**NẾU LỖI:** 404 / trang mặc định có thể do sai Document Root, thiếu index hoặc Extract sai cấp. 500 có thể do `.htaccess`; kiểm tra cPanel → Errors, thử sao lưu/đổi tên `.htaccess` riêng của subdomain để khoanh vùng (không chạm `.htaccess` website chính). 403 kiểm tra directory index và quyền file 644, thư mục 755.

## 4. DNS / HTTPS

**BẤM ĐÂU:** cPanel → SSL/TLS Status hoặc SSL/TLS Certificates → tìm subdomain mới; Domains để xem HTTPS Redirect.

**LÀM GÌ:** chờ/kiểm tra AutoSSL hợp lệ, không nhấn mua SSL nếu đã có chứng chỉ; chỉ bật Force HTTPS Redirect cho subdomain khi HTTPS thực sự thành công.

**DẤU HIỆU THÀNH CÔNG:** mở `https://hoicholab.smartgear.website` không có cảnh báo chứng chỉ, tải đủ CSS và JS, giao diện Market Day Editorial.

**NẾU LỖI:** Nếu ERR_CERT_COMMON_NAME_INVALID, tra đúng chứng chỉ của subdomain không-www và DNS; không bỏ qua cảnh báo. Nếu 404 asset xem Network DevTools; tất cả asset dùng đường dẫn tương đối `assets/...`.

## 5. Kiểm tra trên website thật (smoke test)

- Nạp dữ liệu mẫu: xem 3 sản phẩm, 550.000đ chi phí cố định, hòa vốn **49 phần**, lợi nhuận khi bán đủ **1.660.000đ**.
- Kịch bản Thận trọng: **55** phần, 23/15/17, lợi nhuận **72.000đ**.
- Kịch bản Cơ sở: **98** phần, 40/28/30, lợi nhuận **562.000đ**.
- Thử đổi giá/chi phí -> KPIs cập nhật; đổi lượt khách -> mốc hòa vốn giữ nguyên nếu giá/cost/mix giữ nguyên.
- Bán thử Trà chanh ×2, Cacao đá ×1 -> đơn **65.000đ**. Reload, lịch sử vẫn còn.
- Nạp dữ liệu mẫu không xóa đơn thử. Xóa đơn có xác nhận và tính lại lượng đã bán.
- Mở Insights, thử giả định, hoàn tác; mở Pitch Mode và thử Print.
- Kiểm tra mobile 390px/320px, nút menu và biểu đồ.
- Xem DevTools Console/Network: không có JS error, asset 404.

**NẾU LỖI:** Chụp màn hình/Console đã che thông tin nhạy cảm. Không xóa website/hosting để thử lại.

## 6. Dữ liệu được lưu ở đâu?

Ứng dụng lưu tất cả giả định và đơn bán thử trong localStorage key `hoi-cho-lab.market-day.v2`. Thông tin này **không nằm trong backup hosting**, khác thiết bị/trình duyệt sẽ không tự có dữ liệu cũ. Trong mục Bán thử có **Xuất JSON** và **Nhập JSON** để sao lưu/khôi phục toàn bộ giả định và đơn thử. Nhập JSON kiểm tra định dạng trước khi hỏi xác nhận thay thế dữ liệu. CSV xuất riêng lịch sử đơn.

## 7. Cập nhật & rollback

- Giữ bản ZIP production trước đó; khi cập nhật, sao lưu thư mục `hoicholab` hoặc ZIP các file hiện hành.
- Không xóa localStorage hoặc đổi storage key khi chưa chuẩn bị migration.
- Nếu bản mới lỗi, Extract lại ZIP cũ vào **đúng subdomain** (lưu ý ghi đè các file cần thiết, tránh file dư của bản mới), thử lại giao diện và dữ liệu đã lưu.
- Trình duyệt có thể cache CSS/JS, dùng hard refresh Ctrl+F5.
- Không xóa subdomain/thư mục dự án khác hoặc MySQL của dự án khác.

## Trạng thái phát hành

Đã tạo production ZIP, test logic và UI local; **chưa upload hoặc kiểm thử HTTPS trên Tenten thực tế**. Người triển khai cần xác nhận ảnh Domains/File Manager và kết quả smoke test để đánh dấu hoàn tất production.
