Bắt đầu nhanh

TÓM TẮT

Clone → Install → Cấu hình env → npm run dev. Frontend chạy tại http://localhost:3000.

Yêu cầu hệ thống

Phần mềm	Phiên bản	Mục đích
Node.js	≥ 18.0	Frontend React app
Python	3.11+	Backend ML engine
Git	Latest	Source control

1. Clone & Install

git clone <repo-url>
cd workforce_planner

# Frontend dependencies
npm install

# Backend dependencies (optional - chỉ cần khi chạy ML engine)
cd forecast_engine
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cd ..

2. Cấu hình Environment

# Copy file env mẫu
cp .env.example .env

# Chỉnh sửa với keys thật
# VITE_SUPABASE_URL=https://your-project.supabase.co
# VITE_SUPABASE_ANON_KEY=your-anon-key

QUAN TRỌNG

KHÔNG commit file .env chứa keys vào git! File .gitignore đã được cấu hình sẵn.

3. Chạy Frontend

npm run dev
# → http://localhost:3000

4. Chạy Backend ML Engine (tùy chọn)

cd forecast_engine
source .venv/bin/activate
python main.py
# → http://localhost:8000/docs (Swagger UI)

5. Chạy Tests

# Frontend tests
npm test                # Chạy một lần
npm run test:watch      # Watch mode
npm run test:coverage   # Coverage report

# Type check
npx tsc --noEmit

# Full gate check
npm run test:gate       # vitest + tsc

Cấu trúc routes frontend

Path	Trang	Mô tả
/	Dashboard	Tổng quan metrics
/forecast	Forecast	Dự báo nhu cầu theo ngày/tuần
/forecast/orders	Order Forecast	Dự báo theo đơn hàng
/forecast/bsin	BSIN Forecast	Dự báo theo mã sản phẩm
/forecast/customers	Customer Forecast	Dự báo theo khách hàng
/workforce	Workforce	Kế hoạch nhân sự
/workforce/plan-v2	Workforce Plan V2	Kế hoạch nhân sự nâng cao
/analytics	Analytics	Phân tích báo cáo
/analytics/cost	Cost Analysis	Phân tích chi phí
/settings	Settings	Cấu hình hệ thống
/events	Sale Events	Quản lý sự kiện sale

Tài liệu liên quan

• Kiến trúc hệ thống — Hiểu cách các thành phần kết nối
• Frontend — Chi tiết về ứng dụng React
• Deploy Guide — Triển khai lên production