Bỏ qua

Môi trường demo

Docker dev

Cần Docker và make.

cp .env.docker.example .env
make setup
make links

Lệnh hữu ích:

make logs
make down
make migrate
make seed

Nếu port mặc định đang bận:

cp docker-compose-dev.local.yaml.example docker-compose-dev.local.yaml
# Sửa APP_PORT và FORWARD_DB_PORT trong file local
make up

Chạy trực tiếp

Cần Node.js 20+ và pnpm.

cp .env.example .env
pnpm install
pnpm db:migrate
pnpm db:seed
pnpm db:seed:scenarios
pnpm dev

Ứng dụng sử dụng PostgreSQL theo biến DATABASE_URL trong file .env.

Vai trò Username Mật khẩu
SUPER_ADMIN admin admin123
ADMIN demo-admin demo1234
OPERATOR demo-operator demo1234
SCOREKEEPER demo-scorekeeper demo1234
VIEWER demo-viewer demo1234

Bốn tài khoản demo-* được chia sẻ vào giải HCMC Badminton Open 2026 với đúng vai trò tương ứng.

Bộ dữ liệu tình huống

Chạy pnpm db:seed:scenarios để tạo các tình huống Badminton và Pickleball theo cách idempotent:

  • Giải sẵn sàng bốc thăm.
  • Giải vòng loại trực tiếp đang vận hành.
  • Giải đã hoàn tất toàn bộ trận đấu.
  • Giải 16 đội, 4 bảng, đã hoàn tất vòng bảng và loại trực tiếp.

Các tình huống này dùng để kiểm tra chia bảng, tránh trùng câu lạc bộ, sơ đồ giải, xếp lịch hai giai đoạn và màn hình công khai.

Mục Giá trị
Đăng nhập http://localhost:3000/login
Trang công khai http://localhost:3000/t/hcmc-badminton-open-2026
Bảng live http://localhost:3000/t/hcmc-badminton-open-2026/live
Trọng tài sân C1 http://localhost:3000/r/hcmc-badminton-open-2026/c/C1
Hồ sơ cá nhân http://localhost:3000/profile

Khi đưa lên production

Các tài khoản trên chỉ dành cho môi trường demo. Đổi mật khẩu, vô hiệu hóa tài khoản demo và tắt RUN_SEED_ON_START trước khi đưa lên production.

Làm mới PIN sân demo

Chạy lệnh sau khi cần tạo lại PIN cho toàn bộ sân demo:

pnpm db:reset-demo-pins

PIN mới được hiển thị tại Giải đấu → Sân cho vai trò được phép. Dùng nút QR hoặc Sao chép link để tạo URL có token truy cập; không ghi cố định PIN trong tài liệu hoặc gửi ảnh PIN qua kênh công khai.

Tài liệu kỹ thuật