Viết Prompt cho Firestore (Next.js)

tasks                          ← công việc cần làm
  ├── {taskId}
  │   ├── title: string
  │   ├── description: string
  │   ├── status: "todo" | "in_progress" | "done" | "blocked"
  │   ├── priority: "low" | "medium" | "high" | "critical"
  │   ├── projectId: Reference → projects/{projectId}
  │   ├── assignee: Reference → users/{userId}
  │   ├── reporter: Reference → users/{userId}
  │   ├── tags: string[]
  │   ├── watchers: string[]
  │   ├── dependencies: string[]
  │   ├── isCompleted: boolean
  │   ├── isBlocked: boolean
  │   ├── isPinned: boolean
  │   ├── hasAttachments: boolean
  │   ├── estimatedHours: number
  │   ├── actualHours: number
  │   ├── percentComplete: number
  │   ├── storyPoints: number
  │   ├── dueDate: Timestamp
  │   ├── completedAt: Timestamp | null
  │   ├── createdAt: Timestamp
  │   └── updatedAt: Timestamp
  │
  └── {taskId}/comments        ← subcollection bình luận của task
      └── {commentId}
          ├── content: string
          ├── author: Reference → users/{userId}
          └── createdAt: Timestamp

projects                       ← dự án
  └── {projectId}
      ├── name: string
      ├── description: string
      ├── status: "active" | "archived" | "completed"
      ├── teamSize: number
      ├── createdAt: Timestamp
      └── updatedAt: Timestamp

users                          ← thành viên team
  └── {userId}
      ├── name: string
      ├── email: string
      ├── role: "admin" | "manager" | "developer" | "designer"
      ├── isActive: boolean
      ├── skills: string[]
      ├── createdAt: Timestamp
      └── updatedAt: Timestamp

Thêm function để tạo task mới trong Firestore:
- File: lib/firebase/tasks.ts
- Collection: "tasks"
- Fields bắt buộc: title, projectId, reporter
- Fields tùy chọn: description, assignee, dueDate, priority, tags
- Giá trị mặc định:
  - status: "todo"
  - priority: "medium"
  - isCompleted: false, isBlocked: false, isPinned: false
  - estimatedHours: 0, actualHours: 0, percentComplete: 0
  - createdAt: server timestamp, updatedAt: server timestamp
- Validation:
  - title: bắt buộc, 3–200 ký tự
  - projectId: phải tồn tại trong collection "projects"
  - dueDate: nếu có, phải là ngày trong tương lai
  - priority: chỉ nhận "low" | "medium" | "high" | "critical"
- Return: { id: string, task: Task }
- Error handling: ValidationError cho input sai, ProjectNotFoundError cho projectId sai
- Không tạo API route, chỉ utility function

Tạo function để lấy task theo ID:
- Collection: "tasks", Document ID: taskId
- Return: Task object với tất cả fields hoặc null nếu không tìm thấy
- Xử lý Firestore errors một cách thuần tuý
- Bao gồm TypeScript Task interface

Tạo function updateTask:
- Nhận taskId và partial task data
- Chỉ cập nhật các fields được cung cấp (partial update, không xóa fields khác)
- Fields cho phép cập nhật: title, description, status, priority, assignee,
  dueDate, tags, estimatedHours, actualHours, percentComplete, isBlocked, isPinned
- Ngăn chặn cập nhật: createdAt, reporter, projectId
- Tự động:
  - Set updatedAt = server timestamp
  - Nếu status chuyển sang "done", set isCompleted = true và completedAt = server timestamp
  - Nếu percentComplete = 100, tự động set status = "done"
- Validate status: chỉ nhận "todo" | "in_progress" | "done" | "blocked"
- Xử lý lỗi document not found

Thêm function deleteTask:
- Soft delete: set status thành "archived" (không xoá khỏi Firestore)
- Ghi lại: updatedAt = server timestamp
- Không xoá subcollection comments (giữ lại lịch sử)
- Return: true nếu thành công, false nếu taskId không tồn tại
- Xử lý not found một cách đuồ đặt (không throw lỗi)

Tạo function getTasksByStatus:
- Collection: "tasks"
- Filter: where("status", "==", status)
- status chỉ nhận: "todo" | "in_progress" | "done" | "blocked"
- Return: Task[]
- Order by: dueDate ascending
- Hỗ trợ phân trang (limit parameter, mặc định 20)

Thêm function searchTasks với nhiều điều kiện lọc:
- Collection: "tasks"
- Bộ lọc (tất cả tùy chọn):
  - projectId: exact match
  - assignee: exact match (userId)
  - status: exact match ("todo" | "in_progress" | "done" | "blocked")
  - priority: exact match ("low" | "medium" | "high" | "critical")
  - isBlocked: boolean
  - dueBefore: Timestamp range (dueDate <= dueBefore)
  - dueAfter: Timestamp range (dueDate >= dueAfter)
  - tags: array-contains
- Order by: dueDate ascending, updatedAt descending
- Return: Task[]
- Nếu không có bộ lọc, return tất cả tasks không phải "archived"

Cập nhật function searchTasks để hỗ trợ cursor-based pagination:
- Parameters: filters (như trên), pageSize (mặc định 20), lastDoc (DocumentSnapshot | null)
- Lần gọi đầu tiên: lastDoc = null (lấy trang đầu)
- Các trang tiếp theo: truyền lastDoc từ kết quả trước (dùng startAfter)
- Return: { tasks: Task[], lastDoc: DocumentSnapshot | null, hasMore: boolean }
- Order by: dueDate ascending

Thêm function searchTasksByTitle:
- Tìm kiếm query string trên field "title"
- Thực hiện dùng where("title", ">=", query) và where("title", "<=", query + "\uf8ff")
- Kết hợp client-side filter để loại kết quả không khớp
- Xử lý search string rỗng (return empty array)
- Return: Task[] với limit 30 kết quả đầu

Tạo hook hooks/useTasks.ts:
- Export hook: useTasks(filters: TaskFilters)
- State: { tasks: Task[], loading: boolean, error: Error | null }
- Lấy dữ liệu từ API endpoint /api/tasks/search với filters làm query params
- Gọi lại khi filters thay đổi (useEffect với filters làm dependency)
- Return: { tasks, loading, error, refetch }
- Xử lý cleanup khi component unmount

# Kiểu enum (giá trị cố định)
task:
  status:   todo | in_progress | done | blocked
  priority: low | medium | high | critical

project:
  status: active | archived | completed

user:
  role: admin | manager | developer | designer

# Mô tả cấu trúc task đầy đủ
task:
  id: text
  title: text (bắt buộc)
  description: text (tùy chọn)
  status: todo | in_progress | done | blocked
  priority: low | medium | high | critical
  projectId: id của project
  assignee: id của user (tùy chọn)
  reporter: id của user (bắt buộc)
  tags: danh sách text
  isCompleted: true | false
  isBlocked: true | false
  estimatedHours: số
  actualHours: số
  percentComplete: số (0–100)
  dueDate: timestamp
  completedAt: timestamp hoặc null
  createdAt: timestamp
  updatedAt: timestamp

# Sau đó yêu cầu thực hiện:
# createTask, getTask, updateTask, deleteTask, getTaskComments, addComment

Cho function getTaskWithDetails:
- Throw các lỗi cụ thể:
  - TaskNotFoundError khi taskId không tồn tại
  - ValidationError cho taskId format không hợp lệ
  - FirestoreError cho lỗi network/permission
- Bao gồm thông báo lỗi kèm ngữ cảnh (ví dụ: taskId nào gây lỗi)

Thêm validation cho createTask:
- title: bắt buộc, 3–200 ký tự
- projectId: bắt buộc, phải tồn tại trong collection "projects"
- dueDate: nếu có, phải là ngày trong tương lai
- priority: phải là "low" | "medium" | "high" | "critical"
- tags: mỗi tag tối đa 30 ký tự, tối đa 10 tags
- Return: { success: true, id: string } hoặc { success: false, errors: string[] }

Tạo function completeTask sử dụng Firestore transaction:
- Cập nhật task document:
  - status: "done"
  - isCompleted: true
  - completedAt: server timestamp
  - percentComplete: 100
- Cập nhật user stats trong collection "users":
  - Tăng completedTasksCount lên 1
  - Cập nhật lastActivityAt: server timestamp
- Dùng Firestore transaction để đảm bảo atomicity (cả 2 updates hoặc không cái nào)
- Return: task ID nếu thành công
- Tự động rollback nếu bất kỳ bước nào thất bại
- Throw TaskNotFoundError nếu taskId không hợp lệ

Thêm các Firestore function
Tạo CRUD cho tasks

Tạo một hàm tìm kiếm

Xây dựng toàn bộ hệ thống quản lý công việc