gamehub-shop trong VS Code.npm install..env.example thành .env; tự đặt ADMIN_EMAIL, ADMIN_PASSWORD và SESSION_SECRET.npm run dev hoặc npm start.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.
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.
hieuvuhuy500-jpg/gamehub-shop và xác nhận render.yaml dùng gói Free.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.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.
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:
A cho hvv.com và www.hvv.com về IPv4 của VPS; chờ DNS cập nhật./opt/gamehub-shop, cài package và tạo file .env riêng trên VPS..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.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.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.
VNPAY_TMN_CODE, VNPAY_HASH_SECRET, VNPAY_PAYMENT_URL, VNPAY_RETURN_URL, VNPAY_IPN_URL./api/vnpay/ipn; trang kết quả là /nap-tien/ket-qua.localhost; cần domain/hosting có HTTPS (hoặc tunnel HTTPS chỉ để thử nghiệm) và tài khoản merchant trước khi kiểm tra thanh toán.SEPAY_BANK_CODE, SEPAY_ACCOUNT_NUMBER, SEPAY_ACCOUNT_NAME, SEPAY_WEBHOOK_SECRET và SEPAY_WEBHOOK_URL trong .env. URL phải là https://<domain>/api/sepay/webhook.node -e "console.log(require('crypto').randomBytes(32).toString('hex'))". Dùng đúng khóa đó cho SEPAY_WEBHOOK_SECRET và cấu hình xác thực HMAC-SHA256 của 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.
tên đăng nhập|mật khẩu./game/<tên-game>, liên kết từ các danh mục trên cửa hàng.node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" rồi đặt vào DELIVERY_ENCRYPTION_KEY..env an toàn và chỉ bán tài khoản có quyền phân phối.OPENAI_API_KEY vào .env; có thể đổi model bằng OPENAI_MODEL. Khóa chỉ được đọc ở máy chủ.Ứ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.