#Управление рабочими процессами

# Анализ рабочего процесса: Уменьшение остатков при создании заказа

## Обзор рабочего процесса
**Название рабочего процесса:** Уменьшение остатков при создании заказа

### Триггер
- **Тип:** Событие после действия (Action)
- **Условие срабатывания:** срабатывает при выполнении действия «Создание» в коллекции `orders` (заказы) — глобальный триггер.
- **Связанные данные:** при срабатывании передаются связанные данные `details` (позиции заказа).
- **Режим выполнения:** асинхронный

---

### Цепочка выполнения узлов

**[Триггер] Создание заказа**
        │
        ▼
**[1] Цикл по позициям заказа (Loop)**
    * **Цель:** `{{$context.data.details}}`
    * *Действие: для каждой позиции выполняются следующие шаги:*
        │
        ▼
    **branchIndex=0 (тело цикла)**
        │
        ▼
    **[2] Запрос остатка товара (Query)**
    * **Коллекция:** `products`
    * **Условие фильтрации:** `id = {{$scopes.5u6lsjzf8vh.item.productId}}`
        │
        ▼
    **[3] Проверка достаточности остатка (Condition)**
    * **Движок:** `formula.js`
    * **Выражение:** `{{$jobsMapByNodeKey.n6rf8lf2lum.inventory}} < {{$scopes.5u6lsjzf8vh.item.quantity}}`
        │
        ├── **YES (branchIndex=1, остатка недостаточно, условие TRUE):**
        │   ▼
        │   **[4] Уведомление суперадминистратора (Notification)**
        │   *Отправка уведомления пользователям с ролью root, содержащего:*
        │   *название товара, ID товара, текущий остаток, требуемое количество в заказе.*
        │
        └── **NO (branchIndex=0, остатка достаточно, пустая ветка)**
        │
        ▼
    **[5] Уменьшение остатка (SQL)**
    * **SQL-запрос:** `UPDATE products SET inventory = inventory - :quantity`

---

### Описание ключевой логики

| Этап | Описание |
| :--- | :--- |
| **Триггер** | При создании заказа система передаёт в рабочий процесс полный список позиций. |
| **Цикл** | Позиции обрабатываются по очереди — каждая соответствует товару и его количеству. |
| **Запрос** | По `productId` определяется текущий остаток товара. |
| **Проверка** | Проверяется, выполняется ли `inventory < quantity` (то есть остатка недостаточно). |
| **Уведомление** | Если остатка недостаточно, пользователю с ролью `root` отправляется внутреннее уведомление. |
| **Уменьшение** | Остаток уменьшается напрямую через SQL; поскольку ветви сходятся, уменьшение выполняется независимо от достаточности остатка. |

---

### ⚠️ Возможные проблемы дизайна

`downstreamId` узла условия указывает на узел «Уменьшение остатка», то есть независимо от выбранной ветви (достаточно остатка или нет) в итоге выполняется уменьшение. Фактическое поведение:

- **Остатка достаточно** $\rightarrow$ остаток уменьшается напрямую (нормальный сценарий). ✓
- **Остатка недостаточно** $\rightarrow$ сначала уведомляется администратор, **затем всё равно выполняется уменьшение** (остаток может стать отрицательным).

**Анализ:** такой подход — это шаблон «разрешить продажу с превышением и предупреждать», но также возможна логическая ошибка (по замыслу при недостатке остатка уменьшение должно блокироваться). Нужно уточнить намерение у бизнес-заказчика.

---

### Текущее состояние

- **Состояние включения:** `false` (отключён)
- **История выполнения:** выполнялся 1 раз.
- **Контроль версий:** текущая версия заморожена, для изменений нужно создать новую версию.