Cài đặt & Bắt đầu
Yêu cầu hệ thống
- Node.js >= 20.x
- pnpm >= 10.x
Cài đặt
# Clone repository
git clone <repo-url>
cd vppos-admin
# Cài đặt dependencies
pnpm install
# Cấu hình biến môi trường
cp .env.example .env
# → Điền giá trị API URL vào .env
Chạy Development
# Chạy toàn bộ hệ thống (tất cả MFEs)
pnpm dev
# Chỉ chạy 1 module cụ thể
pnpm dev --filter @vppos/container
pnpm dev --filter @vppos/inventory
Sau khi chạy, truy cập http://localhost:8080.
Các lệnh thường dùng
| Lệnh | Mô tả |
|---|---|
pnpm install | Cài đặt dependencies |
pnpm dev | Chạy dev servers (tất cả MFEs) |
pnpm build | Build production |
pnpm lint | Kiểm tra linting |
pnpm format | Format code với Prettier |
Xem đầy đủ
Tổng hợp tất cả lệnh (docs, storybook, docker, turbo...) → Tổng hợp lệnh
Biến môi trường
Tất cả MFE dùng chung 1 file .env ở root (qua Vite envDir).
| File | Mục đích | Git tracked? |
|---|---|---|
.env.example | Template mẫu | ✅ Committed |
.env | Local dev | ❌ Ignored |
cảnh báo
Không hard-code URL API, secret, hay credential trong source code. Luôn dùng biến môi trường.