Đặc tả Use Case

Luồng hoạt động (Activity Flow)

1. PM mở màn hình Danh sách Công việc (/tasks) hoặc mở tab Công việc trong chi tiết Dự án (/projects/[id]).
2. PM bấm nút "Thêm công việc" (hoặc dùng phím tắt N / nút nhanh trên đầu cột todo).
3. Hệ thống mở Panel / Modal tạo Task: Tự động điền projectId và contactId nếu đi từ trang Dự án.
4. PM nhập các trường thông tin:
   • Tiêu đề task (Bắt buộc): Tên sản phẩm bàn giao / deliverable rõ ràng.
   • Mô tả & Checklist (Bắt buộc): Tiêu chí nghiệm thu (Definition of Done), checklist các bước con.
   • Người phụ trách: Chọn từ danh sách auth_users thuộc tenant.
   • Hạn hoàn thành (Due date) & Độ ưu tiên: urgent / high / medium / low.
   • Tag phân loại: Chọn tag gp:* (giải pháp) và viec:* (loại lao động).
5. PM bấm "Tạo công việc":
   • Hệ thống validate tính hợp lệ (tiêu đề không rỗng, due date hợp lệ).
   • Hệ thống lấy taskCounter hiện tại (ví dụ: 76), tăng lên 77 và gán key: "CTC-77".
   • Hệ thống ghi bản ghi mới vào blob tasks[], tăng rev và phát sinh sự kiện SSE state_update.
   • Hiển thị thông báo thành công SM1 ("Đã tạo công việc CTC-77 thành công").

Đặc tả giao diện màn hình (Screen Spec)

Quy tắc nghiệp vụ (Business Rules)

Luồng hoạt động (Activity Flow)

1. Kế toán mở màn hình Báo giá & Hoá đơn (/invoices).
2. Chọn "Tạo hoá đơn mới" hoặc chọn "Quét hoá đơn (OCR)".
   • Nhánh tạo tay: Nhập khách hàng, mã số thuế, địa chỉ, chọn ngày xuất và hạn thanh toán.
   • Nhánh quét OCR: Upload ảnh/PDF hoá đơn → Hệ thống gọi OCR engine bóc tách: Số HĐ, Ngày lập, MST bên bán/mua, Tổng tiền trước thuế, Tiền thuế GTGT, Tổng thanh toán → Tự điền vào form.
3. Kế toán chỉnh sửa các dòng hàng hoá/dịch vụ (Line items):
   • Nhập Tên hàng hoá/dịch vụ, Đơn vị tính, Số lượng, Đơn giá, Thuế suất (0%, 5%, 8%, 10%).
   • Hệ thống tự tính: Thành tiền = Số lượng × Đơn giá; Tiền thuế = Thành tiền × Thuế suất; Tổng cộng.
4. Kế toán bấm "Lưu & Phát hành":
   • Hệ thống sinh số hoá đơn dạng CTC-INV-YYYY-NNNN.
   • Trạng thái hoá đơn chuyển thành sent (đã gửi cho khách).
   • Cập nhật số dư công nợ phải thu (AR) của đối tác.
5. Khi khách thanh toán: Kế toán bấm nút "Đánh dấu đã thanh toán (Mark Paid)" → Hệ thống tự động sinh 1 bản ghi giao dịch thu (Transaction type: income) trong sổ tài chính.

Quy tắc nghiệp vụ (Business Rules)

Luồng hoạt động (Activity Flow)

1. Sales mở màn hình Phễu Bán hàng / Dự án (/projects ở chế độ Phễu Deal).
2. Kéo thẻ Deal từ cột negotiation sang cột won (hoặc mở form sửa Project và đổi dealStage: won).
3. Hệ thống hiển thị Modal xác nhận Chốt Deal:
   • Yêu cầu xác nhận giá trị hợp đồng chính thức (dealValue).
   • Chọn ngày bắt đầu dự án và ngày bàn giao dự kiến.
   • Đính kèm file hợp đồng đã ký hoặc link tài liệu trên Google Drive.
4. Sales bấm "Xác nhận Chốt Deal":
   • Hệ thống cập nhật dealStage = 'won', giữ nguyên hoặc chuyển status = 'planning'.
   • Hệ thống tự động kích hoạt Workflow Relay: gửi tin nhắn chúc mừng chốt deal tới nhóm Telegram công ty qua /api/me/relay/telegram.
   • Giá trị hợp đồng được cộng dồn vào tổng giá trị đối tác (Rollup Contract Value) trên màn hình /crm.
   • Thông báo tới Ban Giám đốc để thực hiện phân công nhân sự (Pha 4 trong quy trình).

Quy tắc nghiệp vụ (Business Rules)

Luồng hoạt động (Activity Flow)

1. Mở danh bạ Quy trình (/workflows): Bấm nút "Tạo quy trình mới" hoặc chọn 1 trong 5 mẫu dựng sẵn (Templates W1-W5).
2. Chuyển sang Visual Canvas (/workflows/[id]):
   • Cấu hình Trigger Node: Chọn loại status_change (bắt đối tượng Task/Project/Invoice đổi trạng thái) hoặc daily_scan (quét hạn hoá đơn, việc quá hạn, trạng thái ngâm lâu).
   • Thêm Condition Node: Kéo dây nối từ Trigger; thiết lập bộ lọc logic (ví dụ: tags has gp:ctc-ai-transform).
   • Thêm Action Nodes: Nối các hành động cần thực thi:
     • Action 1: create_task với tiêu đề [Kickoff] {name}, hạn sau 3 ngày, gán cho phụ trách dự án.
     • Action 2: send_telegram với nội dung 🎉 Dự án {name} đã chốt! Team chuẩn bị kickoff..
3. Kiểm thử & Lưu quy trình:
   • Bấm nút "Chạy thử (Test Run)" để kiểm tra luồng logic và cấu trúc biến thay thế.
   • Bật toggle "Kích hoạt (Active)" và bấm "Lưu quy trình".
   • Hệ thống lưu cấu trúc toạ độ Graph WorkflowGraphDef lên server và chuyển đổi sang cấu trúc phẳng WorkflowDef cho Engine chạy.
4. Engine thực thi & Chống lặp 3 lớp:
   • Khi sự kiện thoả mãn, Engine kiểm tra Fired Key per-user trong user_data (Lớp 1).
   • Engine kiểm tra tag ẩn wf:<id>:<key> trong store trước khi tạo task (Lớp 2).
   • Engine thực thi hành động và gửi bản ghi log lên server qua POST /api/workflow-runs.

Quy tắc nghiệp vụ (Business Rules)

Luồng hoạt động (Activity Flow)

1. Tác giả mở module Kỹ năng (/skills):
   • Bấm nút "Tạo kỹ năng mới" hoặc "Nhập từ file Markdown (.md)".
   • Nếu nhập Markdown, hệ thống tự động bóc tách: H1 thành Tên kỹ năng, Text mở đầu thành Tóm tắt (Summary), H2 thành Các bước thực hiện (Steps), Checkbox - [ ] thành Checklist nghiệm thu, Link thành Tài nguyên (Resources).
   • Tác giả rà soát và lưu kỹ năng ở trạng thái status = 'draft' (Bản nháp cá nhân).
2. Gửi Yêu cầu Phát hành (/requests):
   • Tác giả chuyển sang trang /requests, bấm "Gửi yêu cầu mới".
   • Chọn loại kind: 'skill', tiêu đề "Đề xuất phát hành SOP Bóc tách Deliverables v1.2", liên kết targetId tới kỹ năng vừa soạn.
   • Yêu cầu được khởi tạo ở trạng thái status: 'new'.
3. Admin / BOD Tiếp nhận & Thẩm định:
   • Admin mở yêu cầu, xem trước nội dung kỹ năng, chuyển trạng thái sang reviewing (khoá quyền sửa của tác giả).
   • Admin đóng góp ý kiến qua trường reviewNote (hỗ trợ @mention tác giả).
4. Phê duyệt & Phát hành Chính thức:
   • Admin bấm "Phê duyệt & Phát hành", nhập số hiệu phiên bản releasedVersion = 'v1.2'.
   • Hệ thống tự động bật cờ published = true, chuyển status = 'active' của Kỹ năng.
   • Server tự động snapshot toàn bộ nội dung def vào lịch sử versions[] (lưu 20 phiên bản).
   • Trạng thái yêu cầu chuyển thành released; thông báo chúc mừng được gửi tới tác giả.

Quy tắc nghiệp vụ (Business Rules)