Actions & Transitions
Có 11 action điều khiển các transition giữa các trạng thái trong vòng đời tài liệu SPECS. Mỗi action chỉ dành cho một role cụ thể (Executor hoặc Manager) và có thể tạo ra side effect.
Bảng Actions
| Action Code | Role | Mô tả | Từ trạng thái | Đến trạng thái | Side Effect |
|---|---|---|---|---|---|
initialize | 👤 Executor | Bắt đầu soạn thảo tài liệu từ ticket mới tạo | created | draft | — |
delete | 👤 Executor | Xoá ticket vĩnh viễn | created | deleted | Hard delete — không thể khôi phục |
drafting | 👤 Executor | Đưa workflow về trạng thái Draft | rejected, change, on_hold | draft | Truyền toàn bộ request body để cập nhật nội dung |
request-review | 👤 Executor | Gửi yêu cầu review | draft | pending_review | — |
cancel-review | 👤 Executor | Huỷ yêu cầu review đang chờ | pending_review | draft | — |
start-review | 👑 Manager | Bắt đầu review | pending_review | in_review | — |
approve | 👑 Manager | Phê duyệt workflow | in_review | approved | Publish event businessUpdated ra message broker |
reject | 👑 Manager | Từ chối | in_review | rejected | — |
on-hold | 👑 Manager | Tạm dừng, chưa xử lý tiếp | in_review, pending_review | on_hold | — |
track-back | 👑 Manager | Đưa về trạng thái trước | in_review, pending_review, on_hold | draft | — |
change | 👑 Manager | Đánh dấu cần chỉnh sửa | in_review, approved | change | — |
Sơ đồ Transitions
Quy tắc quan trọng
Permission Enforcement
Khi Task Executor gọi action thuộc về Task Manager (hoặc ngược lại), hệ thống sẽ trả về 403 Forbidden.