Tài liệu Yêu cầu Triển khai
Hệ thống Quản lý Task Nội bộ

Vòng đời · Phân phối · Task con · Chat & Thông báo — module Quản lý công việc được xây ngay trên nền tảng NolimitHub, tận dụng tài khoản người dùng và hạ tầng thông báo sẵn có thay vì dựng app rời.

⭐ Đây là 2 mục quan trọng nhất. Dev đọc kỹ phần này để hiểu đúng vấn đề và phạm vi trước khi nghĩ tới cách làm. Toàn bộ thiết kế kỹ thuật (API/DB/cronjob/cấu trúc code) dev tự lo.

Các trạng thái và ý nghĩa được khoá cứng theo mô tả nghiệp vụ. Không thêm trạng thái ngoài danh sách dưới đây.

Mỗi task lớn mang các trường thông tin sau. Đây là danh sách trường nghiệp vụ; kiểu dữ liệu / bảng / index do dev tự thiết kế.

// Entity gợi ý — schema thực do dev tự thiết kế
Task {
  id              : UUID
  name            : String        // Tên task
  description     : Text          // Mô tả
  attachments     : List<File>    // Tài liệu đính kèm
  createdAt       : Timestamp
  createdBy       : User          // Người tạo
  dispatcher      : User?         // Người phân phối (cách 2)
  dueAt           : Timestamp     // Thời gian hết hạn
  priority        : Priority
  status          : LifecycleStatus // Tạo / Chờ giao / Chờ làm / ...
  assignees       : List<User>    // Người nhận — có thể nhiều
  chat            : Thread        // Chat gắn theo task lớn (e)
  subtasks        : List<SubTask> // Task con (d)
  history         : List<Change>  // Lịch sử thay đổi (f)
  closeLog        : CloseLog?     // Log ghi khi đóng task
}

Khi tạo: nhập Tên, Mô tả, đính kèm tài liệu (nếu có), mức ưu tiên, thời gian hết hạn. Sau đó chọn 1 trong 2 cách.

Một task lớn có thể chứa nhiều task con bên trong. Đây là quan hệ parent–child bắt buộc trong tài liệu này.

Thông tin task con

Vòng đời task con

Mỗi task lớn có một đoạn chat riêng để trao đổi xoay quanh task đó. Chat gắn ở cấp task lớn — task con dùng chung chat của task lớn, không có thread riêng cho task con.

g.1 · Thông báo trạng thái

Báo cho người liên quan khi task có diễn biến để mọi người nắm được tình hình. Các tình huống bắn thông báo:

g.2 · Thông báo tin nhắn — phải GỘP theo task lớn

Khi có tin nhắn mới trong một task, cộng dồn vào một thông báo của chính task đó — KHÔNG tạo thông báo mới cho từng tin nhắn. Khi người dùng mở / đọc task thì reset bộ đếm.

// Khi có chat mới trong taskId
on newChatMessage(taskId, message) {
  for recipient in task.participants {
    notif = findExisting(recipient, taskId, "chat")
    if notif exists {
      notif.unreadCount += 1                // CỘNG DỒN, không tạo mới
      notif.text = "Có {n} tin nhắn mới trong task ABC"
    } else {
      create(recipient, taskId, type="chat", count=1)
    }
  }
}

on userOpensTask(userId, taskId) {
  reset(userId, taskId, "chat")             // reset bộ đếm
}

2.2 · Mục tiêu & phạm vi

Sau khi làm xong

Ngắn hạn — release đầu

Chỉ số đo lường thành công

5 KPI dưới đây để xác định module đã giải quyết đúng vấn đề ở mục 2.1.

Bảng tham chiếu nhanh — không phải spec kỹ thuật chính thức; thiết kế API do dev tự lo.