Develop

Domain develop

https://admin-db.longtu.club/

4.2. Cách chạy project

Sau khi clone source code frontend và backend, cần cấu hình file .env cho từng project trước khi start.

4.2.1. Cấu hình `.env` cho frontend admin

Tại thư mục sport-admin-client, tạo file .env với nội dung sau:

NODE_MODE=development

# VITE_API_SERVER=https://admin-db-api.longtu.club
VITE_API_SERVER=http://127.0.0.1:8000

VITE_API_DB_SERVER=https://thscore-db.longtu.club
VITE_API_DB_SERVER_USERNAME=db
VITE_API_DB_SERVER_PASSWORD=1
VITE_TIP_DOMAIN=https://thscore-db.longtu.club/bong-da/tips
VITE_SOCCER_API_KEY=15bca33657b59b88dda8f0428c808831
VITE_API_MINI_GAME=https://hu-dev.nospace.network
VITE_LIVE_SITES_BASE_URL=https://releasedb-dev.longtu.club

VITE_HEATMAP_API_KEY=0HuXX3WXh8Q8xlVrOKWtpqyAzrLYgStZd1jSJSEoVkV2mHMSdUUi4pxLRACteEMh
VITE_HEATMAP_LIB=https://cdnjs.cloudflare.com/ajax/libs/heatmap.js/2.0.2/heatmap.min.js
VITE_HEATMAP_STORE=https://wp.longtu.club/wp-content/themes/flatsome/assets/js/heatmap-store.js
VITE_HEATMAP_PAGE=https://wp.longtu.club/wp-content/themes/flatsome/assets/js/heatmap-page.js
VITE_API_SPORT_SERVER=https://api-sport-dev.tenmien.club
VITE_API_TRACKING_SERVER=https://user-tracking-api.nospace.network/api/v1

Ý nghĩa chính:

VITE_API_SERVER: API backend local của admin, frontend sẽ gọi vào địa chỉ này khi chạy local.

VITE_API_DB_SERVER: API DB server dùng cho các chức năng liên quan dữ liệu DB/release.

VITE_TIP_DOMAIN: domain tips dùng cho các chức năng tips.

VITE_API_MINI_GAME: endpoint minigame.

VITE_LIVE_SITES_BASE_URL: base URL phục vụ live sites / release data.

VITE_HEATMAP_*: cấu hình cho chức năng heatmap.

VITE_API_SPORT_SERVER: endpoint API sport.

VITE_API_TRACKING_SERVER: endpoint tracking user.

4.2.2. Cấu hình `.env` cho backend admin

Tại thư mục sport-admin-api, tạo file .env với nội dung sau:

APP_NAME=datasport
APP_ENV=local
APP_KEY=base64:6H3v6yKJGGUGAd9qjKB2ScHw01n9pQPY/fNXtlcldIc=
APP_DEBUG=true
APP_TIMEZONE=UTC
APP_URL={{APP_URL}}
APP_LOCALE=en
APP_FALLBACK_LOCALE=en
APP_FAKER_LOCALE=en_US
APP_MAINTENANCE_DRIVER=file
# APP_MAINTENANCE_STORE=database
PHP_CLI_SERVER_WORKERS=4
BCRYPT_ROUNDS=12

LOG_CHANNEL=stack
LOG_STACK=single
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug

DB_CONNECTION=mysql
# DB_HOST={{DB_HOST}}
# DB_PORT={{DB_PORT}}
# DB_DATABASE=datasport
# DB_USERNAME={{DB_USERNAME}}
# DB_PASSWORD='{{DB_PASSWORD}}'

DB_CONNECTION=mysql
DB_HOST=db
DB_PORT=3306
DB_DATABASE=datasport
DB_USERNAME=root
DB_PASSWORD=rootpassword

#dev
# DB_CONNECTION=mysql
# DB_HOST=185.199.53.139
# DB_PORT=23471
# DB_DATABASE=datasport
# DB_USERNAME=datasport
# DB_PASSWORD=7f^6hm2c-O-v-Kpo

SESSION_DRIVER=database
SESSION_LIFETIME=120
SESSION_ENCRYPT=false
SESSION_PATH=/
SESSION_DOMAIN=null

BROADCAST_CONNECTION=log
FILESYSTEM_DISK=local
QUEUE_CONNECTION=database
CACHE_STORE=database
CACHE_PREFIX=
MEMCACHED_HOST=127.0.0.1

REDIS_CLIENT=phpredis
REDIS_HOST={{REDIS_HOST}}
SUPPLIER_FILE_BASE_URL=https://releasedb-dev.longtu.club

REDIS_PASSWORD=null
REDIS_PORT=6379

MAIL_MAILER=log
MAIL_SCHEME=null
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=
AWS_USE_PATH_STYLE_ENDPOINT=false

VITE_APP_NAME="${APP_NAME}"

JWT_SECRET=Am6LJgZH6XRaPiOODzQCiVFkXwjw1grebLrtpUS5aUZxMlhWTLLopitpu2dyiTtR
JWT_ALGO=HS256

#DB_API_URL=https://thscore-db.longtu.club
DB_API_URL=https://releasedb-dev.longtu.club
DB_API_USERNAME=db
DB_API_PASSWORD=1

Ý nghĩa chính:

APP_ENV=local, APP_DEBUG=true: bật chế độ chạy local để debug.

DB_HOST=db, DB_PORT=3306, DB_DATABASE=datasport, DB_USERNAME=root, DB_PASSWORD=rootpassword: cấu hình kết nối MySQL trong Docker.

SESSION_DRIVER=database, QUEUE_CONNECTION=database, CACHE_STORE=database: session, queue, cache đang dùng database.

JWT_SECRET: khóa dùng cho xác thực JWT.

DB_API_URL, DB_API_USERNAME, DB_API_PASSWORD: cấu hình kết nối API DB ngoài.

SUPPLIER_FILE_BASE_URL: base URL dùng cho file release/supplier.

4.2.3. Start backend

Di chuyển vào thư mục backend:

Khởi động toàn bộ service backend bằng Docker:

Kết quả mong đợi:

container backend được khởi động

database MySQL được khởi động

backend sẵn sàng chạy ở môi trường local

Nếu cần kiểm tra container đang chạy:

Nếu cần xem log backend:

4.2.4. Start frontend

Di chuyển vào thư mục frontend:

Cài đặt dependency:

Chạy project frontend:

Kết quả mong đợi:

frontend được start ở chế độ development

trình duyệt có thể truy cập theo URL local do Vite cung cấp, thường là:

http://localhost:2609/

4.2.5. Thứ tự chạy khuyến nghị

Để tránh lỗi kết nối API hoặc DB, nên chạy theo thứ tự sau:

Tạo file .env cho backend.

Tạo file .env cho frontend.

Start backend bằng Docker.

Kiểm tra backend và database đã chạy ổn định.

Start frontend bằng npm run dev.

Mở trình duyệt và kiểm tra giao diện admin.

4.2.6. Lưu ý khi chạy local

Frontend đang trỏ API local qua:

VITE_API_SERVER=http://127.0.0.1:8000

Frontend đang trỏ API develop qua:

VITE_API_SERVER=https://admin-db-api.longtu.club

Nếu backend local không expose đúng cổng 8000, frontend sẽ không gọi được API.

Backend dùng DB host là db, nên cần chạy đúng qua Docker Compose để container resolve được hostname này.

Một số chức năng vẫn gọi ra dịch vụ ngoài như:

releasedb-dev.longtu.club

user-tracking-api.nospace.network

api-sport-dev.tenmien.club

Vì vậy khi chạy local vẫn cần mạng để dùng các API ngoài đó.

Domain develop#

4.2. Cách chạy project#

4.2.1. Cấu hình .env cho frontend admin#

4.2.2. Cấu hình .env cho backend admin#

4.2.3. Start backend#

4.2.4. Start frontend#

4.2.5. Thứ tự chạy khuyến nghị#

4.2.6. Lưu ý khi chạy local#

4.2.7. Tóm tắt lệnh chạy nhanh#