Hướng Dẫn Cài Đặt — Admin Dashboard

Thư mục: admin/ | Cổng mặc định: 5173 | Công nghệ: Vue 3 + Vite + TypeScript

Yêu cầu

Node.js >= 18.3.0

npm >= 9.x

Go API Backend đang chạy tại http://localhost:33003

Cài đặt

Bước 1: Cài dependencies

Bước 2: Kiểm tra cấu hình

File .env.development đã có sẵn trong repo:

NODE_MODE=development
VITE_API_SERVER=http://localhost:33003

Nếu Go API chạy trên địa chỉ khác, sửa VITE_API_SERVER cho phù hợp.

Bước 3: Khởi động

Kết quả mong đợi:

  VITE v5.x.x  ready in 800 ms

  ➜  Local:   http://localhost:5173/

Mở trình duyệt tại http://localhost:5173 — sẽ thấy trang đăng nhập.

Các lệnh thường dùng

Lệnh	Mô tả
`npm run dev`	Chạy môi trường phát triển với hot-reload
`npm run build:dev`	Build cho môi trường development
`npm run build:stg`	Build cho môi trường staging
`npm run build:prod`	Build cho môi trường production
`npm run lint`	Kiểm tra và tự sửa lỗi code style
`npm run typecheck`	Kiểm tra kiểu dữ liệu TypeScript

Thay đổi địa chỉ API mà không cần build lại

Khi cần trỏ Dashboard sang API server khác (ví dụ khi deploy lên server thật), sửa file public/runtime.config.js:

Refresh trình duyệt là xong, không cần build lại. Cách này hữu ích khi deploy cùng một bản build lên nhiều môi trường khác nhau.

Build và chạy bằng Docker

Truy cập tại http://localhost:4173.

Xử lý sự cố

Lỗi CORS khi gọi API (thấy trong DevTools → Console)

Đảm bảo Go API đang chạy với APP_MODE=development — chế độ này tự động cho phép mọi nguồn kết nối.

Lỗi "Network Error" khi gọi API

Kiểm tra VITE_API_SERVER trong .env.development trỏ đúng địa chỉ Go API đang chạy.

Trang trắng sau khi đăng nhập

Xóa dữ liệu trình duyệt và thử lại:

Lỗi TypeScript khi build

Xem danh sách lỗi và sửa trước khi build.

Setup Guide

Hướng Dẫn Cài Đặt — Admin Dashboard#

Yêu cầu#

Cài đặt#

Bước 1: Cài dependencies#

Bước 2: Kiểm tra cấu hình#

Bước 3: Khởi động#

Các lệnh thường dùng#

Thay đổi địa chỉ API mà không cần build lại#

Build và chạy bằng Docker#

Xử lý sự cố#