#Quản lý Workflow

# Phân tích Workflow: Trừ tồn kho hàng hóa khi tạo Order

## Tổng quan Workflow
**Tên Workflow:** Trừ tồn kho hàng hóa khi tạo Order

### Trigger
- **Kiểu:** Sự kiện sau Action (Action)
- **Điều kiện kích hoạt:** Khi Collection `orders` thực thi Action "create" sẽ kích hoạt (kích hoạt toàn cục).
- **Dữ liệu liên quan:** Mang theo dữ liệu liên kết `details` (chi tiết Order) khi kích hoạt.
- **Chế độ thực thi:** Bất đồng bộ

---

### Chuỗi thực thi Node

**[Trigger] Tạo Order**
        │
        ▼
**[1] Lặp chi tiết Order (Loop)**
    * **Mục tiêu:** `{{$context.data.details}}`
    * *Thao tác: với mỗi mục chi tiết thực thi các bước sau:*
        │
        ▼
    **branchIndex=0 (thân loop)**
        │
        ▼
    **[2] Truy vấn tồn kho hàng hóa (Query)**
    * **Collection:** `products`
    * **Điều kiện lọc:** `id = {{$scopes.5u6lsjzf8vh.item.productId}}`
        │
        ▼
    **[3] Kiểm tra tồn kho có đủ không (Condition)**
    * **Engine:** `formula.js`
    * **Biểu thức:** `{{$jobsMapByNodeKey.n6rf8lf2lum.inventory}} < {{$scopes.5u6lsjzf8vh.item.quantity}}`
        │
        ├── **YES (branchIndex=1, tồn kho không đủ, điều kiện là TRUE):**
        │   ▼
        │   **[4] Thông báo cho super admin (Notification)**
        │   *Gửi thông báo cho user vai trò root, nội dung gồm:*
        │   *Tên hàng hóa, ID hàng hóa, tồn kho hiện tại, số lượng cần của Order.*
        │
        └── **NO (branchIndex=0, tồn kho đủ, nhánh trống)**
        │
        ▼
    **[5] Trừ tồn kho (SQL)**
    * **Câu lệnh SQL:** `UPDATE products SET inventory = inventory - :quantity`

---

### Giải thích logic chính

| Giai đoạn | Mô tả |
| :--- | :--- |
| **Trigger** | Khi tạo Order, hệ thống mang theo danh sách chi tiết Order đầy đủ vào Workflow. |
| **Loop** | Xử lý từng dòng chi tiết, mỗi dòng tương ứng một hàng hóa và số lượng mua. |
| **Query** | Tìm tồn kho hiện tại của hàng hóa đó qua `productId`. |
| **Phán đoán** | Xác định `inventory < quantity` có đúng không (tức tồn kho có không đủ không). |
| **Thông báo** | Nếu tồn kho không đủ, gửi tin nhắn nội bộ nhắc nhở cho user có vai trò `root`. |
| **Trừ kho** | Cập nhật trực tiếp tồn kho qua SQL; do các nhánh hợp lại, dù tồn kho có đủ hay không cũng đều thực thi trừ kho. |

---

### ⚠️ Vấn đề thiết kế tiềm ẩn

`downstreamId` của Node Condition trỏ đến Node "Trừ tồn kho", nghĩa là dù đi nhánh nào (tồn kho đủ hay không đủ), cuối cùng đều hợp lại để thực thi Action trừ kho. Hành vi thực tế như sau:

- **Tồn kho đủ** $\rightarrow$ Trừ tồn kho trực tiếp (luồng bình thường). ✓
- **Tồn kho không đủ** $\rightarrow$ Thông báo cho admin trước, **sau đó vẫn thực thi trừ kho** (có thể dẫn đến tồn kho âm).

**Phân tích:** Thiết kế này thuộc mô hình "cho phép bán quá tồn kho và phát cảnh báo", cũng có thể là một sơ suất logic (ý ban đầu là chặn trừ kho khi tồn kho không đủ). Cần xác nhận thêm ý đồ thiết kế với bộ phận nghiệp vụ.

---

### Trạng thái hiện tại

- **Trạng thái kích hoạt:** `false` (đã tắt)
- **Lịch sử thực thi:** Đã thực thi 1 lần.
- **Quản lý phiên bản:** Phiên bản hiện tại đang ở trạng thái đóng băng, nếu cần sửa phải tạo phiên bản mới trước.