Cách Mình Bắt Đầu Dự Án

Yêu cầu → Làm rõ → PRD → Setup Repo → Lập kế hoạch với Claude → Sprint đầu tiên

# [Tên Dự Án] PRD

## Vấn đề
Đang giải quyết pain point gì? Ai gặp vấn đề này?

## Giải pháp
Mô tả tổng quan cái mình xây.

## Người dùng
Ai sẽ dùng? Bao lâu một lần? Trình độ kỹ thuật?

## Yêu cầu

### Bắt buộc có (MVP)
- [ ] Yêu cầu 1
- [ ] Yêu cầu 2

### Nên có (v1.1)
- [ ] Tính năng phụ 1

### Không làm (loại bỏ rõ ràng)
- Không xây X
- Không hỗ trợ Y

## Ràng buộc kỹ thuật
- Phải dùng Supabase instance hiện có
- Phải tích hợp DataForSEO
- Ngân sách: $X/tháng cho chi phí API

## Chỉ số thành công
- Xử lý được 100 keywords trong dưới 5 phút
- Độ chính xác 90% so với kiểm tra thủ công

## Timeline
- Tuần 1: MVP
- Tuần 2: Polish và deploy

## Câu hỏi còn mở
- [ ] Xử lý rate limit thế nào?
- [ ] Có cần user account không?

# Tạo NextJS app
bunx create-next-app@latest project-name --typescript --tailwind --eslint --app

# Di chuyển vào thư mục
cd project-name

# Thêm Shadcn UI
bunx shadcn-ui@latest init

# Thêm dependencies thường dùng
bun add @supabase/supabase-js

project/
├── .env.example          # Template cho biến môi trường
├── .env.local           # Biến môi trường local (git-ignored)
├── README.md            # Tổng quan dự án
├── CHANGELOG.md         # Theo dõi thay đổi
├── docs/
│   └── PRD.md          # Tài liệu PRD
└── src/
    └── ...             # Code

# Database
SUPABASE_URL=
SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=

# API bên ngoài
DATAFORSEO_LOGIN=
DATAFORSEO_PASSWORD=

# AI
ANTHROPIC_API_KEY=
OPENAI_API_KEY=

# App
NEXT_PUBLIC_APP_URL=http://localhost:3000

I'm starting a new project: [tên dự án]

## Context
[Dán PRD hoặc yêu cầu chính vào đây]

## Tech Stack
- NextJS 14 with App Router
- Supabase for database
- Tailwind CSS + Shadcn UI
- [Công nghệ khác nếu có]

## Questions
1. Cấu trúc thư mục nên như thế nào?
2. Cần những bảng database nào?
3. Những component chính là gì?
4. Cần những API route nào?
5. Thứ tự xây dựng nên thế nào?

Please give me a detailed technical plan before we start coding.

## Folder Structure
src/
├── app/
│   ├── page.tsx           # Trang upload keywords
│   ├── results/
│   │   └── [id]/page.tsx  # Xem kết quả clustering
│   └── api/
│       ├── upload/route.ts
│       └── cluster/route.ts
├── components/
│   ├── keyword-upload.tsx
│   ├── cluster-view.tsx
│   └── progress-indicator.tsx
└── lib/
    ├── supabase.ts
    └── clustering.ts

## Database Schema
- clustering_jobs: id, user_id, status, created_at
- keywords: id, job_id, text, cluster_id
- clusters: id, job_id, label, keywords_count

## Build Order
1. Setup database + UI cơ bản
2. Upload file + parse keyword
3. FastAPI clustering endpoint
4. Hiển thị kết quả
5. Polish + xử lý lỗi

Based on the plan we discussed, please:
1. Tạo cấu trúc thư mục
2. Setup database schema (Supabase migration)
3. Tạo placeholder component
4. Setup biến môi trường

Chưa cần implement chức năng - chỉ cần khung sườn thôi.

git add .
git commit -m "Initial project structure

- Set up NextJS with Tailwind and Shadcn
- Create folder structure per technical plan
- Add database schema
- Configure environment variables

See docs/PRD.md for project requirements"

git push -u origin main