🏗️ ChienLe Labs — Developer Documentation¶
Chào mừng bạn đến với tài liệu nội bộ của ChienLe Labs — nền tảng quản lý khóa học full-stack.
Kiến trúc tổng quan¶
graph LR
A["🌐 Frontend<br/>Next.js<br/>chienle.dev"] -->|HTTPS| B["⚡ Backend<br/>FastAPI<br/>api.chienle.dev"]
B -->|SQL| C["🗄️ Database<br/>PostgreSQL<br/>Supabase"]
B -->|S3 API| D["📦 Storage<br/>Cloudflare R2"]
A -->|Direct Upload| D Tech Stack¶
| Layer | Công nghệ | Mô tả |
|---|---|---|
| Frontend | Next.js, Tailwind CSS, TanStack Query | App Router, TypeScript |
| Backend | FastAPI, Uvicorn | Python API server |
| ORM | SQLAlchemy | Database abstraction |
| Migrations | Alembic | Schema version control |
| Validation | Pydantic v2 | Request/Response schemas |
| Storage | Cloudflare R2 + Boto3 | S3-compatible object storage |
| Database | PostgreSQL | Via Supabase (prod) / Local (dev) |
Quick Links¶
-
Getting Started
Cài đặt môi trường và chạy project lần đầu
-
Git Flow
Branching strategy và quản lý môi trường Local → Test → Prod
-
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.