State Machine
Vòng đời tài liệu SPECS được mô hình hoá dưới dạng state machine với 9 trạng thái và 16 transition. Mỗi tài liệu (ticket) di chuyển qua các trạng thái này từ lúc tạo mới đến khi được phê duyệt cuối cùng — hoặc bị reject, hold, hay yêu cầu chỉnh sửa dọc theo quá trình.
Các trạng thái
| Key | Label | Icon | Mô tả |
|---|---|---|---|
created | Created | ✦ | Ticket vừa được tạo, đang chờ khởi tạo. |
draft | Draft | ✏ | Tài liệu đang được soạn thảo hoặc chỉnh sửa. |
pending_review | Pending Review | ⏳ | Author đã gửi yêu cầu review; đang chờ Manager bắt đầu. |
in_review | In Review | 👁 | Manager đang review tài liệu. |
approved | Approved | ✓ | Tài liệu đã được phê duyệt và publish. |
rejected | Rejected | ✕ | Manager đã từ chối; author cần chỉnh sửa lại. |
on_hold | On Hold | ⏸ | Manager tạm dừng xử lý; chưa tiếp tục tiến triển. |
change | Change Requested | ↺ | Manager yêu cầu chỉnh sửa cụ thể cho tài liệu đã approved hoặc đang in-review. |
deleted | Deleted | 🗑 | Ticket đã bị hard-delete — không thể khôi phục. |
Pipeline End-to-End
Vòng đời tài liệu tích hợp với các hệ thống downstream:
Các điểm tích hợp chính
- Event
approve— khi Manager approve tài liệu, eventbusinessUpdatedđược publish lên message broker, sau đó sync nội dung đã phê duyệt vào Knowledge Base (4 loại tài liệu được index). - AI Agent đọc từ KB — AI Agent ở execution phase đọc Knowledge Base để sinh plan.
- Task Dispatcher — phân phối công việc ra 4 sub-agent chuyên biệt (Architecture, Business, Technical, Testing).
Chú thích
- Executor action — hành động do author tài liệu (Task Executor) khởi xướng.
- Manager action — hành động do reviewer/lead (Task Manager) khởi xướng.
- Rollback — transition ngược (ví dụ: cancel-review, track-back).
- System flow — luồng tự động / event-driven tới các hệ thống downstream.