Plane Analytics — Tài liệu Dự án
Chào mừng bạn đến với kho tài liệu kỹ thuật của dự án Plane Analytics. Thư mục này chứa toàn bộ các hướng dẫn, đặc tả công thức và lộ trình phát triển.
📂 Cấu trúc tài liệu
| File | Nội dung |
|---|---|
ANALYTICS.md | Đặc tả công thức (Source of Truth) |
phase-1-setup.md | Thiết lập dự án, Data Modeling & Schema |
phase-2-parser.md | Engine xử lý và parse dữ liệu JSON từ Plane |
phase-3-analytics.md | Logic phân tích & các API Endpoints |
phase-4-ui.md | Triển khai giao diện người dùng (UI/UX) |
phase-5-ai.md | Tích hợp AI & Hoàn thiện sản phẩm (Đang phát triển) |
🛠 Tech Stack
| Thành phần | Công nghệ sử dụng |
|---|---|
| Framework | Next.js 16 (App Router) |
| Database | Neon Serverless Postgres |
| ORM | Drizzle ORM |
| Styling | Tailwind CSS v4 + Shadcn UI |
| Charts | Recharts |
| Validation | Zod |
| Runtime | Node v24.14.1 |
🚀 Hướng dẫn chạy dự án
Để thiết lập dự án ở môi trường local, vui lòng thực hiện các bước sau:
1. Cài đặt Dependencies
npm install
2. Cấu hình môi trường
Tạo file .env.local từ mẫu .env.local.example và điền DATABASE_URL từ Neon Console:
cp .env.local.example .env.local
3. Đồng bộ Database
npm run db:push
4. Khởi chạy Development Server
npm run dev
Hệ thống sẽ chạy tại http://localhost:6901.