HƯỚNG DẪN CÀI ĐẶT MÔI TRƯỜNG DỰ ÁN SPORT ADMIN
HƯỚNG DẪN CÀI ĐẶT MÔI TRƯỜNG DỰ ÁN SPORT ADMIN#
Tài liệu hướng dẫn chuẩn bị môi trường local để chạy hệ thống gồm Frontend và BackendPhạm vi: clone source code, cài dependency, cấu hình môi trường và khởi động dự án local cho cả frontend Vue và backend PHP.
1. Tổng quan#
Hệ thống Sport Admin gồm 2 thành phần chính:Frontend (FE): xây dựng bằng Vue, chịu trách nhiệm hiển thị giao diện cho các site domain và xử lý tương tác phía người dùng.
Backend (BE): xây dựng bằng PHP, chịu trách nhiệm cung cấp API và xử lý nghiệp vụ hệ thống.
Mã nguồn được tách thành 2 repository riêng:Frontend: https://git.nospace.network/thscore/sport-admin/sport-admin-client
Backend: http://git.nospace.network/thscore/sport-admin/sport-admin-api
Sau khi clone source code về máy local, người dùng cần thực hiện lần lượt các bước: clone source, chạy backend, chạy frontend và kiểm tra hệ thống hoạt động trên môi trường dev.
2. Yêu cầu môi trường cài đặt#
Trước khi chạy dự án, cần chuẩn bị sẵn các công cụ sau trên máy:2.1. Công cụ cần thiết#
| Thành phần | Mục đích |
|---|
| Git | Dùng để clone source code từ repository |
| Docker | Dùng để chạy backend bằng container |
| Docker Compose | Dùng để khởi tạo các service backend theo file compose |
| Node.js | Dùng để chạy frontend Vue |
| npm | Dùng để cài dependency và chạy frontend |
2.2. Khuyến nghị#
Nên sử dụng phiên bản Node.js LTS đ ể đảm bảo tương thích dependency frontend.
Cần đảm bảo Docker Desktop hoặc Docker Engine đã được khởi động trước khi start backend.
Máy local cần có quyền truy cập vào domain nội bộ git.nospace.network.
3. Thông tin repository#
| Thành phần | Đường dẫn repository | Branch |
|---|
| Frontend | https://git.nospace.network/thscore/sport-admin/sport-admin-client | production |
| Backend | http://git.nospace.network/thscore/sport-admin/sport-admin-api | production |
| Branch Dev: | Develop | |
4. Hướng dẫn chạy dự án#
4.1. Clone source code#
Thực hiện clone cả frontend và backend về máy local:4.2. Cách chạy project#
cd ../sport-admin-api
- Tạo file .env
- docker compose -f docker-compose-dev.yml up -d
cd ../sport-admin-client
- Tạo file .env
- npm i
- npm run dev
Modified at 2026-03-26 03:29:11