> Усі статті WIKI Helomi: /wiki/llms.txt

# ШІ Віктор — склад: збірка замовлень, наявність, повернення

Віктор — складський ШІ-співробітник Helomi без ШІ-мозку: він не розмовляє в чаті, а крутить цикл. Кожні кілька хвилин бере з «Угод» замовлення на етапі «Передали на збірку», видає їх збирачам на сторінці «Склад», після «Зібрано» переводить угоду далі й пише нотатку, стежить за товарами з малим залишком і розбирає повернення, забрані з пошти. Усі дані — з вашої CRM (угоди, товари, документи), налаштування — у його пульті, керувати ним можуть люди й інші ШІ (Ломі).

## Можливості
- Черга збірки з угод: етапи з роллю «Передали на збірку» у вибраних воронках, будь-якої давності.
- Картка замовлення для збирача: позиції з фото, артикулом і місцем, ТТН і перевізник, документи угоди, коментар складу, попередження про чужу ТТН чи доставку за наш рахунок.
- «Зібрано» → етап з роллю «Зібрано» + нотатка хто і коли зібрав; «Повернути менеджеру» → етап «Допомога» + причина.
- Перевірка наявності: запити «перерахуйте» на товари із залишком від 1 до порога; записаний підрахунок стає рухом «перерахунок» у картці товару.
- Розбір повернень: позиції повертаються на склад штатною дією угоди, часткове повернення лишає решту списаною.
- Усе підписане «ШІ Віктор» у журналі картки угоди, товару і в «Журналі» пульта.
- Гра для збирачів «ШІ Кіт» (вкладка «Склад → ШІ Кіт», кіт-король Кіктор) з балами за зібрані посилки й перевірки; кіт говорить через Ломі — [окрема стаття](kiktor.md).

## 1. Налаштування
Віктор з'являється сам в «Інтеграції (головне меню) → ШІ» як плитка «Віктор» і в «Налаштування → Команда → ШІ-співробітники». «Відкрити» на картці веде у вікно ШІ, кружечок «Налаштування» праворуч угорі вікна — його налаштування (вкладка «Налаштування»). Усі значення — тут, у коді нічого міняти не треба:

| Група | Налаштування | Що означає | Типово |
| --- | --- | --- | --- |
| Загальні | Застосовувати зміни | Вимкнено — кожна дія чекає підтвердження в журналі | так |
| Черга збірки | Як часто оновлювати чергу з угод, хв | Період кроку циклу | 5 |
| Черга збірки | Брати замовлення не старші за, днів | Вікно для «на підході» і спакованих; угоди на самій збірці беруться завжди | 30 |
| Черга збірки | Воронки, з яких іде збірка | «Усі» — кожна воронка, де є етап з роллю «Передали на збірку» | усі |
| Черга збірки | Ключ поля «Доставка за наш рахунок» | Так → попереджувальний стікер, посилка не йде в реєстр | dostavka_za_nash_rakhunok_988 |
| Черга збірки | Ключ поля «Коментар складу» | Показується збирачу першим банером | komientar_skladu_989 |
| Перевірка наявності | Запит «перерахуйте» для залишку від 1 до | Поріг малого залишку | 5 |
| Перевірка наявності | Сканувати залишки раз на, год | Як часто дивитись склад | 3 |
| Перевірка наявності | Після підрахунку товар не смикати, днів | Тиша після перерахунку | 90 |
| ШІ Кіт | Бали за посилку НП / іншої служби / перевірку | Нарахування збирачам | 1 / 2 / 1 |
| ШІ Кіт | Падіння ситості, ласки, «разом» за годину; днів без їжі | Життя кота | 2 / 1,5 / 1; 5 |
| ШІ Кіт | Кіт розмовляє; голос кота; як звучить кіт; історія кота | Розмова з котом через Ломі (`cat_talk`, `cat_voice`, `cat_voice_style`, `cat_story`) | так; Algieba; кіт-король; типова історія |
| ШІ Кіт | Кіт на збірці; розповідає серіал; як часто говорить сам; свої фрази | Кіктор на сторінці збірки замість старого кота (`cat_buddy`, `cat_buddy_story`, `cat_buddy_every`, `cat_buddy_phrases`) | так; так; 45 с; порожньо |
| ШІ Кіт | Скільки речей обстановки можна поставити | Скільки речей обстановки стоїть біля кота разом, 1–16 (`cat_decor_max`); місць кожного виду на сцені однаково не більше | 10 |
| ШІ Кіт | Звуки гри; гучність звуків гри | Муркотіння, мяукання, монетки й фанфари на сторінці кота й на збірці (`cat_sfx`, `cat_sfx_volume`, 5–100 %); кожен ще може вимкнути звуки на своєму пристрої | так; 60 % |

Етапи Віктор не вгадує за номерами: у «Налаштування → Воронки й етапи» у кожної воронки збірки мають бути етапи з ролями «Передали на збірку», «Зібрано» і «Допомога» (ролі ставляться в картці етапу). Нема ролі — крок повідомить про це в «Журналі».

Після збереження зміни діють із наступного кроку, без перезапуску.

## 2. Увімкнути або вимкнути Віктора
«Інтеграції → ШІ» → плитка «Віктор» → перемикач «Увімкнено». Те саме в пульті: «⋮ → Вимкнути». Вимкнений Віктор не робить нічого: цикл пропускається, кнопка «Запустити крок» сіра, інструменти інших ШІ відповідають «ШІ вимкнено». Черга на сторінці «Склад» лишається такою, як була на момент вимкнення.

## 3. Як замовлення потрапляє на збірку
Менеджер (або автоматика каналу) переводить угоду на етап з роллю «Передали на збірку». На наступному кроці Віктор створює завдання збірки: позиції угоди, ТТН з блоку «Доставка» (остання активна; кілька активних — збірка блокується, поки менеджер не прибере зайву), перевізник за форматом номера, документи з розділу «Документи», файли угоди (стікер PDF), коментар складу. Збирач на сторінці «Склад» тисне «Почати збірку» і отримує наступне вільне замовлення. Угода, яку перевели далі вручну, зникає з черги на наступному кроці.

«Запустити крок» у пульті оновлює чергу зараз, не чекаючи періоду.

## 4. Зібрано і «Повернути менеджеру»
«Зібрано» на сторінці «Склад» → Віктор переводить угоду на етап з роллю «Зібрано» своєї воронки і пише в картку угоди нотатку: скільки позицій і штук, хто збирав, час, ТТН. Усе видно в «Угоди → картка → Нотатки» і «Журнал», автор — «ШІ Віктор». «Повернути менеджеру» з причиною → етап з роллю «Допомога» + нотатка з причиною. Якщо етап не перевівся (нема ролі, заборонений перехід) — завдання показує помилку, а Віктор повторює на наступних кроках.

## 5. Перевірка наявності
Раз на кілька годин Віктор дивиться залишки складу і ставить запит «перерахуйте» на товари із залишком від 1 до порога (артикули А1…А9 не рахуються ніколи). Збирач рахує те, що на полиці, і вписує число. Віктор додає до нього штуки у зібраних, ще не відправлених посилках (вони зняті з полиці, але зі складу ще не списані — у картці запиту це «спаковано N») і записує залишок рухом «перерахунок» у картку товару, від свого імені. Товар, залишок якого поповнився вище порога, знімається зі списку сам.

## 6. Повернення на склад
Повернення, забрані з пошти (Ростік відмічає «забрали»), з'являються у «Склад → Повернення». Комірник відмічає кожну позицію: «товар є» або «не повертати N шт» (загублено, пошкоджено, не наш). «Повернути товар на склад» → для кожної повернутої позиції виконується штатна дія угоди «Повернути» (залишок плюс), не повернуті штуки лишаються списаними; при частковому поверненні решта списується назад, а якщо не вийшло — менеджеру ставиться завдання в угоді. У картку угоди іде нотатка з підсумком.

> [!IMPORTANT]
> Щоб товар повертався на склад лише тут, після перевірки, етап «Повернення» має «Склад: нічого» («Налаштування → Воронки й етапи», 23.10). Інакше етап повертає товар, щойно служба написала «відмова», поки посилка ще їде назад, і маркетплейси показують «в наявності» товар, якого нема на полиці. «Угода скасована» повертає товар одразу.

## 7. Пульт Віктора і режим на весь екран
Вікно — `/crm/ai/viktor` («Відкрити» на картці в «Інтеграції → ШІ» чи в «Структурі»): скільки зібрати, на підході, зібрано сьогодні, перерахувати, повернення; цикл; черга збірки; перевірка наявності; нижче — «Чекають підтвердження» й «Останні дії». Налаштування («Налаштування → ШІ-співробітники → Віктор» або кружечок у вікні) — вкладки «Налаштування» (з «Доступами й лімітами»), «API», «Огляд», «Журнал» (кожен крок: що зробив або чому впав). На комп'ютері пульт відкривається на весь екран: бокове меню згортається в рейку з кнопкою ☰, розділи переїжджають на нижню панель швидкого доступу. «Згорнути» — кружечок у шапці пульта, ☰ у рейці або «⋯ → Згорнути панель». Як відкривати наступного разу — «Швидкий доступ → Пульт ШІ на весь екран: як востаннє / завжди / ніколи». На телефоні пульт і так на весь екран, меню — у нижньому доку.

## Можливі помилки
| Як показується | Чому | Що зробити |
| --- | --- | --- |
| У «Журналі»: «у воронці «…» нема етапу з роллю «picked»» | У воронці збірки нема етапу «Зібрано» (або «Допомога») з роллю | «Налаштування → Воронки й етапи» → картка етапу → роль |
| Черга порожня, хоч угоди на збірці є | Воронку не вибрано в «Налаштуваннях → Воронки, з яких іде збірка», або Віктора вимкнено | Увімкнути; поставити «усі» або додати воронку |
| На завданні «CRM не підтвердив оновлення — повторюю» | Перехід етапу заборонений правилами воронки або угоду заархівовано | Перевірити угоду; Віктор повторить сам |
| «склад не прийняв нову кількість: …» при перерахунку | Активна інвентаризація по товару або товар видалено | Завершити інвентаризацію / знайти товар у складі |
| Інструмент ai_viktor_* → 403 «ШІ вимкнено» | Віктора вимкнули | Увімкнути в «Інтеграції → ШІ» |

## Для ШІ-співробітників
Ключ розділу в каталозі — `ai-viktor` (`describe_section("ai-viktor")`, `GET /api/ai/sections/ai-viktor`); доступ — галочка «ШІ Віктор (склад: збірка, наявність)» у «Доступах» співробітника (Ломі має її типово).
- `ai_viktor_status` — стан, налаштування, останній крок, воронки збірки.
- `ai_viktor_summary` — дашборд складу (зібрати, на підході, зібрано сьогодні, перерахувати, повернення).
- `ai_viktor_queue` — черга збірки; `ai_viktor_stock` — запити «перерахуйте»; `ai_viktor_returns` — повернення; `ai_viktor_journal` — хто що зібрав.
- `ai_viktor_run_step` — крок зараз.
- `ai_viktor_settings_save` — змінити налаштування (ті самі перевірки, що в пульті); `ai_viktor_enabled` — увімкнути/вимкнути. Обидві — через кошик підтверджень «Керування іншими ШІ» (у «Доступах» → «спочатку запитати»).
- `ai_viktor_stock_count` — записати підрахунок за запитом «перерахуйте».
Не вигадуйте id угод і запитів — беріть їх з `ai_viktor_queue` / `ai_viktor_stock`; не повторюйте дію, що вже чекає підтвердження.

## Додаткова інформація
Пов'язане: [Склад і товари](products.md), [ШІ Кіт](kiktor.md), [Угоди](deals.md), [Воронки й етапи](settings-funnels.md), [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md).