🏗️ ChienLe Labs — Developer Documentation¶
Tài liệu kỹ thuật cho ChienLe Labs — nền tảng LMS hiện đại tích hợp AI Assistant và Lộ trình học tập.
Kiến trúc tổng quan¶
graph TD
subgraph Frontend ["🌐 Frontend (Next.js)"]
A["Admin Dashboard<br/>(Tiptap + AI Tool)"]
A2["Student UI<br/>(Roadmap & Courses)"]
end
subgraph Backend ["⚡ Backend (FastAPI)"]
B["API Routing"]
B2["AI Service<br/>(Gemini/OpenAI)"]
B3["Storage Service<br/>(R2)"]
end
A -->|AI Request| B2
A2 -->|Fetch Data| B
B -->|SQL| C["🗄️ Database<br/>PostgreSQL"]
B3 -->|S3 API| D["📦 Storage<br/>Cloudflare R2"] Tech Stack Mở rộng¶
| Layer | Công nghệ | Vai trò mới |
|---|---|---|
| Frontend | Next.js, Tiptap | Soạn thảo nội dung thông minh với AI |
| Backend | FastAPI, Python | Điều phối và fallback giữa các LLMs |
| AI Assistant | Google GenAI, OpenAI | Tóm tắt, sửa lỗi, tạo nội dung tự động |
| Roadmap | SQL Logic | Tự động hóa lộ trình học theo Module/Lesson |
| Học thử | Preview Flag | Trải nghiệm nội dung thực tế trước khi đăng ký |
| Storage | Cloudflare R2 | Phục vụ video/ảnh dung lượng lớn qua CDN |
Quick Links¶
-
Getting Started
Cài đặt môi trường và chạy project lần đầu
-
Tech Stack Detailed
Chi tiết thư viện, hạ tầng và cơ chế xử lý AI HTML Draw
-
Git Flow
-
Backend API
Architecture, endpoints, schemas
-
Frontend
Next.js structure, API integration
Dành cho ai?¶
Người mới join team
Bắt đầu từ Getting Started → đọc Project Structure → rồi Git Flow.
DevOps / Deploy
Xem Deployment Guide và CI/CD Pipeline.