Local Setup — Chạy project trên máy¶

Hướng dẫn step-by-step để clone repo và chạy cả Backend + Frontend trên máy local.

1. Clone Repository¶

git clone https://github.com/chienktv90/chienle-labs.git
cd chienle-labs

2. Setup Backend¶

2.1 Tạo Virtual Environment¶

WindowsmacOS / Linux

cd backend
python -m venv venv
venv\Scripts\activate

cd backend
python3 -m venv venv
source venv/bin/activate

2.2 Cài dependencies¶

pip install -r requirements.txt

2.3 Cấu hình `.env` cho Backend¶

Copy file mẫu và điền các giá trị quan trọng:

# Database
DATABASE_URL=postgresql://postgres:123456@localhost:5432/chienle_dev

# AI Assistant (Quan trọng cho tính năng AI Tool)
# Lấy tại: https://aistudio.google.com/
GOOGLE_API_KEY=AIzaSy... 
# Lấy tại: https://platform.openai.com/
OPENAI_API_KEY=sk-proj...

# Security (Để khớp với Frontend)
API_KEY=local_secret_key
ADMIN_PASSWORD=admin123

Lưu ý bảo mật

API_KEY ở backend phải trùng với NEXT_PUBLIC_API_KEY ở frontend để các yêu cầu Admin được chấp nhận.

3. Setup Frontend¶

3.2 Cấu hình `.env.local`¶

NEXT_PUBLIC_API=http://localhost:8000
# Phải khớp với API_KEY trong backend/.env
NEXT_PUBLIC_API_KEY=local_secret_key

4. Hướng dẫn lấy API Key¶

4.1 Google Gemini API (Ưu tiên)¶

Truy cập Google AI Studio.
Đăng nhập bằng tài khoản Google.
Nhấn Get API Key → Create API Key.
Sao chép và dán vào GOOGLE_API_KEY trong tệp .env.

4.2 OpenAI API (Duy trì cho fallback)¶

Truy cập OpenAI Dashboard.
Vào mục API Keys → Create new secret key.
Sao chép và dán vào OPENAI_API_KEY.

5. Tính năng Lộ trình học tập (Roadmap)¶

Hệ thống roadmap được xây dựng dựa trên cấu trúc Module -> Lesson trong cơ sở dữ liệu. 1. Sau khi chạy backend, truy cập /admin ở frontend. 2. Tạo Course mới -> Thêm Module -> Thêm Lesson. 3. AI Assistant sẽ hỗ trợ bạn viết nội dung trong từng Lesson bằng cách nhấn icon AI trong trình soạn thảo. 4. Học thử (Preview): Bật cờ is_preview trong chi tiết bài giảng để bài giảng đó hiển thị công khai, giúp học viên vào học thử nội dung video hoặc hình ảnh mà không cần đăng ký.