gamehub-shop

GTN GAMING SHOP

Chạy local

  1. Cài Node.js LTS và mở thư mục gamehub-shop trong VS Code.
  2. Chạy npm install.
  3. Sao chép .env.example thành .env; tự đặt ADMIN_EMAIL, ADMIN_PASSWORD và SESSION_SECRET.
  4. Chạy npm run dev hoặc npm start.
  5. Mở http://localhost:3000.

Chế độ npm run dev bỏ qua thư mục dữ liệu để Nodemon không khởi động lại máy chủ khi có đơn hàng hoặc sản phẩm mới. Lần đầu chạy, ứng dụng tạo tài khoản quản trị từ ADMIN_EMAIL và ADMIN_PASSWORD. Admin và khách đăng nhập tại /dang-nhap; tài khoản có quyền admin sẽ tự chuyển vào /admin, còn khách được chuyển đến trang tài khoản. Khu vực Admin không hiển thị trên giao diện khách và được bảo vệ theo quyền tài khoản. Không gửi nội dung .env hoặc khóa bí mật qua chat. Phiên đăng nhập được mã hóa và lưu trong data/sessions, được ghi nhớ tối đa 30 ngày và gia hạn khi sử dụng; đăng xuất sẽ kết thúc phiên. Nếu SESSION_SECRET chưa được đặt ở môi trường local, ứng dụng tạo khóa ổn định trong data/.session-secret. Giữ nguyên thư mục data và SESSION_SECRET để các phiên tiếp tục hoạt động sau khi khởi động lại; không dùng tùy chọn ghi nhớ trên thiết bị dùng chung.

Demo miễn phí trên Render

Render chạy website trên máy chủ đám mây nên có thể truy cập khi máy tính cá nhân tắt. render.yaml dùng web service miễn phí và cấp URL onrender.com, nhưng không có ổ đĩa bền vững. Free service có thể ngủ sau 15 phút không có truy cập, cần khoảng một phút để thức dậy, và mọi dữ liệu trên ổ đĩa tạm (bao gồm data/db.json, kho hàng và phiên đăng nhập) có thể mất khi service ngủ, khởi động lại hoặc triển khai lại. Chỉ dùng để xem thử, không lưu dữ liệu/tài khoản khách và không bán hàng thật.

  1. Mở Render, chọn New > Blueprint, kết nối kho GitHub riêng hieuvuhuy500-jpg/gamehub-shop và xác nhận render.yaml dùng gói Free.
  2. Khi Render hỏi biến môi trường, tự nhập ADMIN_EMAIL, ADMIN_PASSWORD mạnh và DELIVERY_ENCRYPTION_KEY gồm 64 ký tự hex. Tạo khóa bằng lệnh node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"; giữ bí mật và không gửi qua chat. Render tự tạo SESSION_SECRET.
  3. Chờ triển khai thành công rồi mở URL onrender.com do Render cấp. Tên miền riêng phải được đăng ký riêng rồi thêm vào Render và cấu hình DNS; tên miền không làm dữ liệu của gói miễn phí được lưu bền vững.

Không đưa .env, data/db.json, node_modules hoặc khóa bí mật lên GitHub. Gói Render miễn phí không phù hợp cửa hàng thật cần giữ kho tài khoản; để lưu dữ liệu lâu dài, cần hosting trả phí có ổ đĩa bền vững hoặc chuyển sang cơ sở dữ liệu production phù hợp. Dữ liệu trên máy tính cá nhân không tự được chuyển lên hosting.

Chuẩn bị VPS Ubuntu và HTTPS cho khách

Tên miền hvv.com hiện mới là tên dự kiến; VPS chưa được thuê và website chưa được đưa lên Internet. Khi đã sở hữu domain và VPS Ubuntu 24.04:

  1. Trỏ bản ghi DNS A cho hvv.com và www.hvv.com về IPv4 của VPS; chờ DNS cập nhật.
  2. Cài Node.js LTS, Nginx và Certbot trên VPS. Triển khai mã nguồn vào /opt/gamehub-shop, cài package và tạo file .env riêng trên VPS.
  3. Trong .env production, đặt NODE_ENV=production, PORT=3000, email/mật khẩu admin mạnh, SESSION_SECRET tối thiểu 32 ký tự và DELIVERY_ENCRYPTION_KEY 64 ký tự hex. Không chép .env hoặc data/db.json lên kho mã nguồn.
  4. Chạy Node bằng systemd, chỉ bind ứng dụng ở 127.0.0.1:3000, rồi cấu hình Nginx làm reverse proxy cho hvv.com và www.hvv.com.
  5. Mở firewall VPS cho SSH, HTTP (80) và HTTPS (443), sau đó cấp chứng chỉ TLS bằng Certbot. Ứng dụng production tin cậy một reverse proxy để HTTPS session cookie hoạt động.
  6. Trước khi nhận tiền thật, chuyển dữ liệu JSON sang cơ sở dữ liệu production phù hợp, bật sao lưu và kiểm thử khôi phục. Chỉ cấu hình VNPay sau khi có tài khoản merchant và IPN/Return URL HTTPS hoạt động.

Không chia sẻ mật khẩu SSH, khóa riêng, .env hoặc thông tin merchant qua chat. Chưa có VPS/domain được cấp phát nên hiện chưa tồn tại URL công khai để gửi khách.

Nạp tiền VNPay

Chuyển khoản tự động qua SePay

Thẻ cào vẫn bị khóa. Chỉ mở sau khi có tài khoản tại nhà cung cấp thẻ cào chính thức và tài liệu API/đối soát được xác minh; không thu thập serial/PIN trực tiếp trên website.

Kho hàng và giao tự động

Trợ lý AI và giao diện

Trước khi mở bán công khai

Ứng dụng vẫn lưu dữ liệu nghiệp vụ trong JSON và session trong các tệp mã hóa; disk bền vững giúp giữ các tệp này qua lần khởi động lại nhưng không biến JSON thành cơ sở dữ liệu production. Đây chỉ phù hợp một instance, không hỗ trợ mở rộng nhiều tiến trình. Trước khi nhận tiền thật, cần chuyển dữ liệu sang cơ sở dữ liệu production phù hợp, cấu hình sao lưu, rà soát bảo mật và hoàn tất kiểm thử với tài khoản VNPay của bạn. Không dùng giao dịch sandbox cho khách thật.