YÊU CẦU MÔI TRƯỜNG (PREREQUISITES)

Trước khi bắt đầu, máy tính của bạn cần cài sẵn:

• NodeJS: Phiên bản 22.12.0.

• MongoDB: Cài đặt MongoDB Compass (để chạy local) hoặc có tài khoản MongoDB Atlas (Cloud).

• Trình soạn thảo: VS Code.

CÀI ĐẶT SERVER (BACKEND)

• Bước 1: Giải nén file code, mở thư mục backend bằng VS Code.

• Bước 2: Mở Terminal (Ctrl + `) và chạy lệnh cài đặt thư viện:

  npm install
  

• Bước 3: Tạo file cấu hình môi trường.

  PORT=5000
  MONGO_URI=mongodb://localhost:27017/ten_database_cua_ban
  
  # Cấu hình bảo mật JWT
  JWT_SECRET=bi_mat_khong_bat_mi_123
  JWT_EXPIRES_IN=7d
  
  # Cấu hình đường dẫn
  BACKEND_URL=http://localhost:5000
  API_BASE=/api
  FRONTEND_URL=http://localhost:5173
  
  # CẤU HÌNH VNPAY (SANDBOX)
  # Đăng ký tại: sandbox.vnpayment.vn/merchantv2
  VNP_TMN_CODE=DIEN_MA_TMN_CUA_BAN
  VNP_HASH_SECRET=DIEN_MA_SECRET_CUA_BAN
  VNP_URL=https://sandbox.vnpayment.vn/paymentv2/vpcpay.html
  VNP_RETURN_URL=http://localhost:5000/api/payment/vnpay-return
  
  # CẤU HÌNH GOOGLE LOGIN
  # Lấy tại: console.cloud.google.com
  GOOGLE_CLIENT_ID=DIEN_CLIENT_ID_CUA_BAN
  GOOGLE_CLIENT_SECRET=DIEN_CLIENT_SECRET_CUA_BAN
  

  Hướng dẫn lấy key nhanh:

  • MONGO_URI: Nếu dùng MongoDB Compass local, link thường là mongodb://localhost:27017/WatchStore.

  • VNPAY: Đăng ký tài khoản test tại sandbox.vnpayment.vn, vào email lấy VNP_TMN_CODE và VNP_HASH_SECRET điền vào.

  • Google: Nếu chưa biết lấy, bạn có thể để trống tạm thời (chức năng login Google sẽ không chạy, nhưng web vẫn hoạt động bình thường).

  • Tại thư mục gốc của backend, bạn tạo một file mới đặt tên là .env

  • Copy toàn bộ nội dung bên dưới dán vào file .env:

• Bước 4: Tại thư mục backend, chạy lệnh node seeder.js để đưa dữ liệu lên mongodb

• Bước 5: Khởi chạy backend: npm run dev
• 
  

CÀI ĐẶT CLIENT (FRONTEND)

• Bước 1: Mở thư mục frontend bằng VS Code.

• Bước 2: Mở Terminal và chạy lệnh:

  npm install
  

• Bước 3: Cấu hình kết nối tới Server.

  • Tạo file mới tên là .env trong thư mục frontend.

  • Dán nội dung sau vào:

  VITE_API_URL=http://localhost:5000
  

  (Lưu ý: Port 5000 phải trùng với PORT bạn đã khai báo bên Server)

• Bước 4: Khởi chạy Website:

  npm run dev

• Sau khi chạy xong bước 3, Terminal sẽ hiện đường dẫn Localhost (thường là http://localhost:5173)

• Giữ phím Ctrl và click vào link đó để mở trình duyệt.