Phase 1 — Setup & Data Modeling
Tài liệu này ghi lại quá trình thiết lập nền tảng kỹ thuật ban đầu cho dự án Plane Analytics.
| Thông tin | Chi tiết |
|---|---|
| Ngày hoàn thành | 2026-04-17 |
| Trạng thái | ✅ Hoàn thành |
1. Mục tiêu
Thiết lập nền tảng vững chắc cho hệ thống:
- Khởi tạo dự án Next.js 16 với App Router.
- Cấu hình kết nối Neon Serverless Postgres.
- Định nghĩa Database Schema sử dụng Drizzle ORM.
- Thiết lập hệ thống validation với Zod.
2. Công nghệ sử dụng
| Package | Phiên bản | Vai trò |
|---|---|---|
next | 16.2.4 | Framework chính |
drizzle-orm | ^0.45 | Quản lý Database |
@neondatabase/serverless | latest | Driver kết nối Neon |
drizzle-kit | ^0.31 | Công cụ Migrations |
zod | latest | Xác thực dữ liệu |
shadcn/ui | 4.3.0 | Thư viện giao diện |
recharts | ^3.8 | Hiển thị biểu đồ |
3. Database Schema
Hệ thống sử dụng các bảng chính sau để lưu trữ và phân tích dữ liệu:
🏢 Bảng workspaces
Lưu trữ thông tin về không gian làm việc của Plane.
👥 Bảng members
Thông tin nhân sự và thành viên trong workspace.
📁 Bảng projects
Các dự án cụ thể được import để phân tích.
🔄 Bảng cycles
Các chu kỳ làm việc (Sprints/Iterations).
🎫 Bảng issues
Đơn vị công việc chính. Đây là bảng quan trọng nhất chứa trạng thái, độ ưu tiên và thời gian hoàn thành.
📈 Bảng analytics_snapshots
Lưu trữ kết quả tính toán metrics để theo dõi lịch sử thay đổi hiệu suất.
4. Cấu trúc thư mục dự án
src/
├── app/ # Giao diện & API (App Router)
├── db/ # Kết nối & Schema Database
├── lib/ # Logic xử lý chính (Analytics, Parser)
├── components/ # UI Components (Charts, Layout)
└── messages/ # Đa ngôn ngữ (i18n)
5. Kết quả đạt được
- ✅ Hoàn thành setup Next.js 16 với App Router và TypeScript.
- ✅ Cấu hình Tailwind CSS v4 với Dark Mode mặc định.
- ✅ Định nghĩa đầy đủ 6 bảng Database với quan hệ chặt chẽ.
- ✅ Kiểm tra TypeScript: 0 lỗi.
Cập nhật lần cuối: 17/04/2026