# Початок роботи — WIKI Helomi

> Перший вхід, меню й швидкий доступ, телефон, структура компанії й картки людей, перенесення даних з іншої CRM.


---

# Перші кроки в Helomi

Helomi — CRM для інтернет-магазину чи торгової компанії: замовлення з маркетплейсів і сайтів стають угодами, склад рахує залишки й резерв, ТТН створюються з угоди, поруч фінанси, каса, документи й ШІ-співробітники. Ця стаття — шлях першого дня: що де лежить і що налаштувати по черзі, щоб компанія почала працювати; кожен крок веде до докладної статті.

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

## 1. Як влаштований екран
Ліворуч — головне меню з розділами й відділами, угорі сторінки — назва, пошук і головна дія (чорна кнопка, наприклад «+ Нова угода»), рідкісні дії сховані в «⋮».

- **Меню ліворуч** згортається кнопкою «Згорнути» у вузьку рейку; відділи («Відділ продажу», «Бухгалтерія»…) розгортаються по кліку.
- **Панель швидкого доступу** — під робочим вікном: «⋯ → Додати цю сторінку на панель» ставить туди поточну сторінку. Докладно — [Швидкий доступ і меню телефона](quick-access.md).
- **«⋮» кожного розділу** — «Інструкція (WIKI)», «Налаштувати поля», «Вхід для ШІ».
- **Кружечок «?»** біля назви сторінки чи блоку пояснює, для чого він, і веде в потрібний розділ WIKI.
- **Кнопка ШІ** праворуч унизу — Ломі.

На телефоні меню ліворуч стає нижнім меню з чотирма кнопками й «Меню». Докладно — [Helomi на телефоні](mobile.md).

## 2. Люди й доступи
Спершу вирішіть, хто працює в Helomi і що кожен бачить: розділи меню, чиї угоди й клієнти, хто може видаляти чи проводити платежі.

1. Колега реєструється сам на сторінці входу.
2. Адміністратор підтверджує його в «Користувачах» (блок «Чекають підтвердження»).
3. У картці людини відмітьте розділи меню галочками або дайте готову роль.

Докладно — [Люди, ролі, доступи](settings-access.md). Відділи й підпорядкування видно в [Структурі](structure.md).

## 3. Бренди й юрособи
Бренд — під чим ви продаєте (магазин, сайт), юрособа — ФОП чи ТОВ, від якої виставляється рахунок і чек. Їх задають один раз, далі угоди, документи й каса беруть реквізити самі.

Докладно — [Бренди і юрособи](settings-brands.md).

## 4. Воронка й етапи
Воронка — шлях угоди від замовлення до «Виграно»; етапи повторюють ваш реальний процес: «Нові», «Прийнято», «На збірці», «Відправлено», «Виконано».

1. «Налаштування → Продажі → Воронки й етапи» → «+ Воронка».
2. Перейменуйте, додайте чи переставте етапи; кожному можна дати колір, роль і дію зі складом (резерв, списання).

Докладно — [Воронки, етапи, переходи](settings-funnels.md).

## 5. Поля угоди, клієнта й товару
Які поля є в угоді, клієнті, товарі й завданні, які обов'язкові й що видно в списку — вирішуєте ви, а не розробник.

1. «Налаштування → Типи даних → Угоди» (або «⋮ → Налаштувати поля» в самому розділі).
2. «Додати» — своє поле будь-якого типу; прапорці «обов'язкове», «при створенні», «у списку».

Докладно — [Типи даних і поля](settings-fields.md).

## 6. Склад і товари
Товари з артикулом, ціною, собівартістю й залишком живуть у «Складі»; угоди беруть їх звідти й резервують за етапом.

Перенесіть товари імпортом XLSX або додайте вручну. Докладно — [Склад і товари](products.md), [Імпорт і експорт](import-export.md).

## 7. Канали замовлень, доставка й оплати
Замовлення з Prom, Rozetka, Kasta, Епіцентру, OLX і ваших сайтів падають в угоди самі, щойно підключено канал; так само підключаються перевізники (Нова Пошта, Укрпошта, Meest) і банки.

Підключення — у розділі «Інтеграції»: картка сервісу → «Підключення» → ключ → «Перевірити». Каналів одного виду може бути кілька (два кабінети Prom, кілька відправників Нової Пошти). Докладно — поличка «Інтеграції» WIKI, наприклад [Prom](int-prom.md) і [Нова Пошта](int-nova-poshta.md).

## 8. Перша угода
Угода — одне замовлення: клієнт, товари, етап, оплата, доставка, документи й журнал в одній картці.

1. «Угоди» → «+ Нова угода».
2. Клієнт за телефоном або назвою, товари «+ Додати зі складу».
3. «Створити угоду» — далі ведіть її етапами й створіть ТТН з блоку «Доставка».

Докладно — [Угоди](deals.md), [Доставки і ТТН](shipping.md).

## 9. ШІ-співробітники: Ломі й Остап
У Helomi два «мозки», які керують рештою ШІ: Ломі — помічниця організації (ви кажете, що зробити, вона робить у CRM за вашими доступами), Остап — ваш власний Claude, ChatGPT, Kimi чи Gemini, який заходить у CRM з файлу сесії.

1. Ломі з'являється в організації сама; її картка — «Інтеграції → ШІ».
2. Щоб працювати зі свого чату: «Інтеграції → ШІ» → картка «Остап» → «Підключити» → «Розумію» → «Підключити», далі «Створити ключ і завантажити файл» і киньте файл у свій чат.

Докладно — [Ломі](kamila.md), [Остап](ai-ostap.md), [ШІ-співробітники](ai-employees.md).

## Можливі помилки
| що бачите | чому | що зробити |
| --- | --- | --- |
| Колега зайшов, а меню порожнє | Його ще не підтвердили або не дали розділів | «Користувачі» → «Підтвердити», галочки розділів у картці людини |
| Немає пункту «Налаштування» | Налаштування відкриті лише адміністратору | Попросіть адміністратора або дайте людині права адміністратора |
| Замовлення з маркетплейсу не з'являються в угодах | Канал не підключено або вимкнено | «Інтеграції» → картка каналу → ключ, «Перевірити», перемикач «Інтеграція» |

## Для ШІ-співробітників
Ця стаття — карта першого дня; дії робляться інструментами розділів. Почніть з `help()` — карта WIKI з поличками й ключами статей, `help(query="…")` — пошук розділів за словами, `describe_section("<розділ>")` — поля й дії розділу з налаштувань організації. Налаштування компанії, доступи людей і ключі інтеграцій ШІ не змінює — це робить адміністратор.

## Додаткова інформація
- Уся WIKI відкрита без входу: можна кинути посилання на будь-яку статтю колезі чи своєму ШІ.
- Пов'язані статті: [Швидкий доступ і меню телефона](quick-access.md), [Моє меню](my-menu.md), [Helomi на телефоні](mobile.md), [Структура](structure.md), [Люди: картки й анкети](people.md).


---

# Структура

Структура — схема компанії: відділи, люди й ШІ в них і хто кому підпорядковується. Звідси одним натиском можна відкрити картку людини чи ШІ або написати їм у чат.

## Можливості
- Вигляд «Відділи»: угорі керівники без керівника, під ними відділи стовпчиками; відділ, чий голова підпорядкований людині з іншого відділу, показано всередині того відділу.
- Вигляд «Ієрархія»: дерево підпорядкування людей і ШІ з лініями; кожен керівник верхнього рівня — окрема гілка.
- Фільтр за компанією («Усі компанії»), пошук «Знайти людину або ШІ», «Лише керівники».
- Масштаб: «Збільшити», «Зменшити», «Вписати всю схему в екран», «Розгорнути все», «Згорнути гілку».
- Картка людини з анкетою («Про себе», освіта, стаж, навички, мови й свої поля компанії — лише те, що відкрито колегам), телефон дзвонить у клік; картка ШІ — з описом і фото; «Написати» — чат.
- Люди позначені теплим ореолом, ШІ — холодним; директор — чорною карткою.

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

## 2. Подивитися відділи
1. Відкрийте «Структура» → «Відділи».
2. Угорі — керівники, від них лінії до відділів. Відділ — стовпчик: голова карткою, люди рядками; підпорядковані глибше — з відступом.
3. Під стовпчиком — назва відділу й кількість людей і ШІ.

На телефоні відділи йдуть одним стовпчиком, назва — над відділом.

## 3. Ієрархія
1. «Структура» → «Ієрархія».
2. Полотно відкривається з керівниками по центру; тягніть його в будь-який бік або щипком змінюйте масштаб.
3. «Лише керівники» ховає рядових співробітників; «Розгорнути все» відкриває всі гілки, «Згорнути гілку» — одну.

На телефоні ієрархія — вертикальне дерево з лініями, без масштабу.

## 4. Знайти людину або ШІ
Пишіть у «Знайти людину або ШІ» — схема покаже збіг («Знайти в ієрархії»). Фільтр «Компанія» залишає лише людей вибраної компанії.

## 5. Картка і чат
- В «Ієрархії» клік по фото або відділу відкриває картку, клік по решті картки — чат.
- У картці людини: «Про себе» абзацом, відділ, керівник, компанії, телефон (клік — ваш робочий телефон набирає номер), пошта й заповнені поля анкети, відкриті колегам (стаття [Люди: картки й анкети](people.md)). Своя картка — кнопка «Заповнити картку» («Мій профіль»), адміністратор бачить «Змінити».
- У картці ШІ: опис, фото, посилання (застосунки ШІ — «Скачати застосунок», «Відкрити»), «Написати», «Задача».
- «Написати» людині відкриває особистий чат, ШІ — чат з ним (для ШІ з групою — груповий чат).

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Призначте керівників у картках (адмін-панель), щоб з'явилася ієрархія.» | Ні в кого не задано керівника | Задайте керівників у «Налаштування → Користувачі» |
| «Поки що нікого немає. Додай людей і ШІ в адмін-панелі.» | У компанії нема підтверджених людей і ШІ | Додайте й підтвердіть користувачів |
| Людини нема на схемі | Обліковий запис не підтверджено або вибрано іншу компанію | Підтвердіть людину, виберіть «Усі компанії» |
| «Відкрити працює, коли програму вже запущено на цьому ПК.» | Застосунок ШІ не запущено локально | Спершу «Скачати застосунок» і запустіть його |

## Для ШІ-співробітників
Картки людей читаються розділом `people` (доступ — «Структура»): `people_list q=…`, `people_get` (стаття [Люди: картки й анкети](people.md)). 5`. Змінювати відділи, керівників і доступи ШІ не може за правилом безпеки.

## Додаткова інформація
- Пов'язані статті: [Переписки](chats.md), ШІ-співробітники (`ai-employees.md`), «Люди, ролі, доступи» (`settings-access.md`).


---

# Люди: картки й анкети

Картка людини — це її анкета для колег: хто вона і чим займається, освіта, стаж, де працювала, навички, мови й свої поля компанії. Людина сама заповнює й змінює свою картку в «Моєму профілі», адміністратор — у «Користувачах», а колеги бачать її в «Структурі» (лише поля, відкриті колегам) і можуть подзвонити в клік.

## Можливості
- Типова анкета: «Про себе», «День народження», «Місто», «Працює в компанії з», «Стаж роботи, років», «Освіта», «Де працював», «Навички», «Мови», «Захоплення».
- Свої поля будь-якого типу (рядок, текст, число, дата, список, так/ні, посилання) — «Налаштування → Типи даних → Люди».
- Людина бачить свою картку повністю, з позначкою, скільки заповнено, і сама її змінює.
- Галочка «Видно колегам» на кожному полі: решту бачать лише сама людина й адміністратор.
- «Обов'язкове» поле: без нього людина не збереже профіль (і ШІ через API теж).
- У «Користувачах» — колонка «Анкета» (скільки заповнено), свої колонки («Вивести в списку») і пошук по анкеті: «польська», «Excel», «Львів».
- Ломі знаходить колег за анкетою («хто знає польську?») і на прохання людини записує щось у її картку.

## 1. Налаштування
Поля картки налаштовує адміністратор або людина з доступом «Налаштування CRM»: «Налаштування → Типи даних → Люди» (або «Налаштувати поля» на сторінці «Користувачі» чи в «Моєму профілі» адміністратора).

У таблиці дві частини:
- **Системні поля** (з позначкою «системне»): «Прізвище та ім'я», «Фото», «Посада», «Відділ», «Керівник», «Телефон», «Пошта», «Компанії». Їх не видалити й тип не змінити; можна сховати від колег («Видно колегам»), показати колонкою в «Користувачах» і переставити. «Телефон» можна зробити обов'язковим. Ім'я видно завжди, пошту не вимкнути — це логін.
- **Анкета й свої поля** — звичайні поля: перейменуйте, змініть підказку, порядок і блок, зробіть обов'язковим, сховайте від колег або видаліть. Видалене поле анкети назад саме не повернеться.

| Прапорець | Що робить для людей |
| --- | --- |
| «Обов'язкове поле» | Людина не збереже профіль, поки поле порожнє; заповнене не можна стерти |
| «Вивести в списку» | Колонка в «Налаштування → Користувачі» |
| «Видно колегам» | Поле в картці людини в «Структурі» й у пошуку колег; без галочки — лише сама людина й адміністратор |

«Вивести при створенні» для людей нема: людина реєструється сама на сторінці входу. Зміни діють одразу, без перезапуску; кожна зміна поля — у «Журналі змін» налаштувань.

## 2. Заповнити свою картку
1. «Налаштування → Мій акаунт → Мій профіль».
2. Угорі — ім'я, телефон і фото, нижче — блок «Про мене» з анкетою й пігулкою «заповнено 4 з 10».
3. Заповніть поля й натисніть «Зберегти» вгорі — тост «Профіль збережено». Обов'язкове порожнє поле підсвічене рядком «Обов'язкове поле — заповніть його», а сервер не пропустить збереження з тостом-поясненням.

Поля з позначкою «лише вам» колеги не бачать. Посаду, відділ і пошту змінює адміністратор. На телефоні поля йдуть одне під одним, підказки під полями видно завжди.

## 3. Хто що бачить
- **Сама людина** — усю свою картку, змінює ім'я, телефон, анкету й свої поля.
- **Адміністратор** — усі картки повністю, змінює анкету будь-кого (у «Користувачах»).
- **Колеги** — ім'я і поля з галочкою «Видно колегам» (типово відкрито все, крім того, що адміністратор сховав).
- **ШІ-співробітник** — те саме, що колеги; на прохання людини в чаті — її картку повністю.

## 4. Картки в «Користувачах»
«Налаштування → Команда → Користувачі»: колонка «Анкета» показує, скільки людина заповнила; поля з «Вивести в списку» — окремими колонками. Пошук шукає не лише за ім'ям і поштою, а й по анкеті. «змінити» відкриває шторку людини: під основними полями — блок «Анкета»; «Зберегти» записує лише змінені поля анкети, тож незаповнене людиною обов'язкове поле не заважає змінити посаду. Номер телефону в рядку дзвонить у клік (стаття [Телефонія](telephony.md)).

## 5. Картка колеги в «Структурі»
Натисніть фото людини в «Структурі»: у картці — «Про себе» абзацом, відділ, керівник, компанії, телефон (дзвонить у клік з вашої робочої лінії), пошта й заповнені поля анкети, відкриті колегам. Порожні поля не показуються. Своя картка має кнопку «Заповнити картку» (веде в «Мій профіль»), адміністратор бачить «Змінити» (веде в «Користувачі»).

## 6. Свої поля
«Налаштування → Типи даних → Люди → Дії з полями → Додати поле»: назва, тип, блок («Анкета» або «Додаткові поля»), підказка, «Обов'язкове», «Вивести в списку», «Видно колегам». Нове поле одразу з'являється в «Моєму профілі» кожної людини, у шторці «Користувачів» і в картці «Структури». Приклади: «Розмір форми» (список S, M, L), «Сертифікати», «Табельний номер» (лише адміністратору — без «Видно колегам»).

## Можливі помилки
| Як показується | Чому | Що зробити |
| --- | --- | --- |
| «Обов'язкове поле картки не можна залишити порожнім: …» | Поле позначене «Обов'язкове» у «Типи даних → Люди» | Заповніть поле або зніміть «Обов'язкове» |
| «Невідомі поля картки людини: …» | Поле видалили або перейменували ключ (запит з ШІ чи старої вкладки) | Оновіть сторінку; ключі полів — у «Типи даних → Люди» (колонка ID) |
| «Чужу картку змінює адміністратор…» | Спроба змінити картку колеги без прав адміністратора | Попросіть адміністратора або людину саму |
| «Ім'я й телефон людина змінює сама…» | Адміністратор змінює ім'я чи телефон через анкету | Ім'я й телефон колеги — у шторці «Користувачів», основні поля |
| У «Структурі» колега без анкети | Не заповнив або поля сховані від колег | Попросіть заповнити «Мій профіль»; перевірте «Видно колегам» |

## Для ШІ-співробітників
Розділ у каталозі — `describe_section("people")` (доступ — розділ «Структура»), поля — з «Типи даних → Люди» (`custom.<ключ>` — анкета й свої поля).
- `people_list q=…` — картки колег з пошуком по імені, посаді й анкеті («хто знає польську»); колегам — лише поля «Видно колегам».
- `people_get user_id=…` — картка однієї людини.
- `people_me` — картка людини, яка зараз просить у чаті (уся, з незаповненими обов'язковими `missing`).
- `people_update_me values={custom: {ключ: значення}, phone?}` — змінити картку людини, яка попросила. Лише на її прохання в чаті (Ломі; Остап — людина, що створила файл сесії); без людини — 403.

Чужу картку ШІ не змінює, поля й прапорці не налаштовує (ПРАВИЛА §5); кожна зміна — у журналі картки з підписом «<ШІ> за проханням <людина>».

## Додаткова інформація
- Пов'язані статті: [Структура](structure.md), [Люди, ролі, доступи](settings-access.md), [Типи даних](settings-fields.md), [Телефонія](telephony.md), [Налаштування](settings.md) («Мій профіль»).


---

# Швидкий доступ і меню телефона

Швидкий доступ — ваші кнопки на сторінки, якими ви користуєтесь найчастіше: на комп'ютері це панель під робочим вікном (до 10 кнопок), на телефоні — нижнє меню (до 4 кнопок). На кнопку можна поставити будь-яку сторінку Helomi — розділ, картку, сторінку налаштувань, пульт ШІ-співробітника; налаштування особисті, у кожної людини свої.

## Можливості
- Панель на комп'ютері — скляна смуга на всю ширину під робочим вікном, до 10 кнопок; активна кнопка біла з контуром.
- Нижнє меню на телефоні — до 4 кнопок.
- Будь-яка сторінка цього сайту: розділи меню, сторінки налаштувань (адміністратору), ШІ-співробітники, нещодавно відкриті сторінки, своя адреса.
- Значок підбирається сам за розділом чи назвою; його й назву можна змінити.
- Порядок — перетягуванням або стрілками «Вище» / «Нижче».
- Панель і нижнє меню вмикаються й вимикаються окремо.

## 1. Налаштування
1. «Налаштування → Мій акаунт → Швидкий доступ» (адреса `/crm/dock`); на панелі — «⋯» → «Налаштувати панель».
2. Угорі «Для якого пристрою»: «Комп'ютер» або «Телефон». У кожного пристрою свої кнопки.
   На комп'ютері сторінка ділиться на дві колонки: ліворуч — ваші кнопки, праворуч — «Додати сторінку». Кожна колонка
   гортається окремо (сторінка стоїть на місці), тож довгий перелік сторінок не зсуває список ваших кнопок.
3. Вимикачі «Показувати панель на комп'ютері» і «Показувати нижнє меню на телефоні».
4. «Як виглядатиме панель» / «Як виглядатиме нижнє меню» — прев'ю.
5. «Типові» повертає кнопки за замовчуванням.
6. «Зберегти». Налаштування зберігаються у вашому профілі; якщо доступу до CRM нема, — лише на цьому пристрої («Збережено на цьому пристрої»).

## 2. Додати поточну сторінку на панель
1. Відкрийте потрібну сторінку (картку угоди, вкладку, звіт, пульт ШІ).
2. На панелі праворуч натисніть «⋯» → «Додати цю сторінку на панель». Коли панель порожня, ця кнопка видна прямо на панелі.
3. Щоб прибрати — «⋯» → «Прибрати цю сторінку з панелі».

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

## 4. Згорнути або вимкнути панель
- «⋯» → «Згорнути панель» або маленька стрілочка під панеллю по центру. Згорнута панель — стрілочка під вікном; натисніть її, щоб показати панель знову.
- Вимкнути зовсім — «Показувати панель на комп'ютері» на сторінці «Швидкий доступ».

## 5. Нижнє меню телефона
1. «Швидкий доступ» → «Телефон».
2. Виберіть до 4 кнопок з усіх пунктів меню, доступних вам, або будь-яку сторінку.
3. «Зберегти». Меню з'явиться внизу кожної сторінки на телефоні.

Нижнє меню налаштовується лише на цій сторінці: рядка «Додати цю сторінку в нижнє меню» в «Меню» телефона нема.

Розділи, які ви сховали в «Моєму меню» (стаття [Моє меню](my-menu.md)), не потрапляють у типові кнопки нижнього меню. Якщо ви поставили їх кнопкою самі, вони лишаються.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Уже 10 кнопок — приберіть одну в налаштуваннях» | Панель повна | Приберіть кнопку на сторінці «Швидкий доступ» |
| Своя адреса не зберігається | Адреса веде на інший сайт | Вказуйте лише сторінки цього сайту Helomi |
| Кнопки нема в каталозі | Розділ вам не відкрито | Попросіть доступ у адміністратора |
| «Нічого не знайдено — додайте свою адресу нижче.» | Пошук не знайшов сторінку | Додайте її через «Своя адреса» |

## Для ШІ-співробітників
Швидкий доступ — особисте налаштування вигляду людини; інструментів для нього нема і не передбачено.

## Додаткова інформація
- Пов'язані статті: [Helomi на телефоні](mobile.md).


---

# Моє меню

«Моє меню» — сторінка, де кожен налаштовує своє ліве меню: переставляє розділи й відділи мишкою, додає свої відділи, перейменовує й видаляє їх, ховає розділи, якими не користується, і вибирає, чи їздить за мишкою ручка згорнутого меню. Так меню стає коротшим лише для вас, у колег воно не змінюється. Що кому дозволено, вирішує адміністратор у «Налаштування» → «Розділи»: там галочка закриває розділ людині повністю.

## Можливості
- Перемикач «у меню» на кожному розділі, який вам доступний.
- «Сховати відділ» і «Показати відділ» — увесь відділ одним кліком. Відділ, у якому сховано всі розділи, зникає з меню повністю.
- Перетягування мишкою: розділ — на інше місце у відділі або в інший відділ; відділ — на інше місце (за ручку ⠿ біля назви).
- «+ Відділ» — свій відділ; «⋮» біля назви — «Перейменувати», «Вище / лівіше», «Нижче / правіше», «Видалити відділ».
- «Типове меню» повертає розташування й показ розділів як було.
- Сторінка займає всю ширину екрана: відділи стають у стільки колонок, скільки вміщується.
- Пошук розділу за назвою.
- Ручка меню на комп'ютері: згорнуте меню — три рисочки на лівому краї, розгорнуте — язичок «‹», що виростає з його краю; перемикач «Ручка їздить за мишкою».
- Вибір зберігається у вашому профілі й діє на всіх ваших пристроях: комп'ютері, телефоні, планшеті.

## 1. Де знайти
Ліве меню → група «Налаштування» → «Моє меню» (поруч із «Профіль» і «Швидкий доступ»). Адреса — `/crm/menu`.

## 2. Сховати розділ або цілий відділ
1. Вимкніть перемикач біля розділу або натисніть «Сховати відділ» біля назви відділу.
2. Угорі видно лічильник «у меню N з M».
3. «Зберегти». Розділ одразу зникне з лівого меню. Після збереження з'явиться напис «Збережено — меню оновлено на всіх ваших пристроях».

## 2а. Переставити розділи й відділи, свої відділи
1. Наведіть мишку на розділ (ліворуч ручка ⠿) і перетягніть його: лінія показує, куди він ляже — між розділами того ж відділу чи в інший відділ. У порожній відділ — на напис «Перетягніть сюди розділ».
2. Відділ перетягується за ручку ⠿ біля його назви: смужка ліворуч чи праворуч показує, куди він стане.
3. «+ Відділ» → назва → новий порожній відділ; перетягніть у нього розділи.
4. «⋮» біля назви відділу: «Перейменувати», «Видалити відділ» — його розділи перейдуть у перший відділ, нічого не губиться.
5. На телефоні (перетягувати пальцем браузер не дає) — «⋮» біля розділу: «Вище», «Нижче», «У відділ «…»».
6. «Зберегти». Ліве меню одразу стане таким, як на сторінці: відділ «Основне» першим без підпису, решта — згортаються, як раніше.
   Нові розділи, які з'являться в Helomi пізніше, самі стануть у свій відділ. Порожній відділ у меню не показується.

## 3. Повернути розділ
Увімкніть перемикач біля розділу або натисніть «Типове меню» → «Зберегти» (повертає і розташування відділів).

## 4. Чим відрізняється від «Налаштування → Розділи»
- «Моє меню» лише ховає пункт з вашого меню. Сторінка й далі відкривається за адресою, з посилань і з кнопок «Швидкого доступу», якщо ви її туди поставили.
- «Налаштування» → «Розділи» (адміністратор) закриває розділ людині: його немає ні в меню, ні за адресою.
- «Моє меню», «Швидкий доступ» і «Профіль» сховати не можна: з них повертаються до налаштування.
- У нижньому меню телефона сховані розділи не з'являються як типові кнопки. Якщо ви самі поставили їх кнопкою, вони лишаються.

## 5. Згорнути й розгорнути меню ручкою
Коли ліве меню згорнуте, на лівому краї екрана замість кружечка ☰ — вузька смуга з трьома рисочками, а вікно розділу стоїть ближче до краю, тож на екран влазить більше. Відкривається й закривається меню в одному місці: натиснули рисочки — меню виїхало, а рисочки стали стрілкою «‹» у язичку, що виростає з краю меню, на тій самій висоті; натиснули язичок — меню поїхало назад.

1. Наведіть мишку на лівий край екрана: смуга підсвітиться, рисочки поїдуть за мишкою вгору чи вниз.
2. Натисніть рисочки: меню виїде, вікно розділу відсунеться праворуч.
3. Натисніть язичок «‹» на краю меню: меню сховається, рисочки повернуться на край екрана. Язичок стоїть у проміжку між меню й вікном і на вікно не заходить; поряд із мишкою він їздить уздовж краю меню, але не заходить на його заокруглені кути.
4. Щоб рисочки й язичок не їздили за мишкою, а стояли посередині, відкрийте «Налаштування → Моє меню» і вимкніть «Ручка їздить за мишкою» в блоці «Ручка меню · на комп'ютері».

> [!NOTE]
> Перемикач діє одразу, без кнопки «Зберегти», і на всіх ваших пристроях. На телефоні ручки немає: меню відкривається, як раніше.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Збережено на цьому пристрої» | Немає доступу до CRM або сервер не відповів: вибір збережено лише тут | Повторіть пізніше або попросіть адміністратора відкрити розділи CRM |
| Розділу немає в списку «Моє меню» | Адміністратор його вам не відкрив | Попросіть доступ у «Налаштування» → «Розділи» |
| Сховане з'явилося знову на іншому пристрої | Сторінку на тому пристрої ще не оновили | Оновіть сторінку |
| Рисочки й «‹» не їздять за мишкою | Вимкнено «Ручка їздить за мишкою» | Увімкніть його в «Моє меню» → «Ручка меню · на комп'ютері» |
| Повідомлення «Сервер не відповів» після перемикача ручки | Вибір діє на цьому пристрої, але не дійшов до профілю | Натисніть «Повторити» або перемкніть ще раз пізніше |

## Для ШІ-співробітників
Це особисте налаштування людини (`/api/crm/me/prefs/menu`, `{hidden: [адреси], layout: {groups: [{name, items: [адреси]}]}, follow: false}`; `follow` є лише тоді, коли ручка не їздить за мишкою). Інструментів для нього в ШІ немає: ШІ не змінює меню людей. Доступи до розділів теж налаштовує лише людина-адміністратор.

## Додаткова інформація
- Пов'язані статті: [Швидкий доступ і меню телефона](quick-access.md), [Люди, ролі, доступи](settings-access.md).


---

# Helomi на телефоні

Helomi працює на телефоні в браузері або як встановлений застосунок: ті самі розділи, дані й права, що на комп'ютері, але списки стають картками, форми — шторками на весь екран, а внизу є нижнє меню з чотирма вашими кнопками і «Меню». Окремо нічого налаштовувати не треба — сторінки самі підлаштовуються під ширину від 390 px.

## Можливості
- Нижнє меню: до 4 вибраних кнопок і «Меню» з усіма пунктами.
- Рядки «Угод», «Клієнтів», «Завдань», «Документів» — компактні картки; порожні поля сховані.
- Фільтри за кнопкою «Фільтри», щоб не займали екран.
- Шторки й вікна запису — на весь екран; кнопки внизу шторки над нижнім меню.
- Меню «⋮» — шторка знизу з затемненням.
- Кнопка ШІ внизу праворуч; її можна перетягнути, місце запам'ятовується.
- Застосунок на головному екрані: Android — .apk або «Встановити застосунок» у Chrome, iPhone — «На початковий екран».

## 1. Налаштування: встановити застосунок
- **Android, повний застосунок**: на головній сторінці платформи (`/welcome`) — «Скачати .apk для Android» (файл `/Squaregram.apk`), відкрийте файл і встановіть.
- **Android через Chrome**: меню Chrome → «Встановити застосунок».
- **iPhone (веб-формат)**: відкрийте Helomi у Safari → «Поділитися» → «На початковий екран».

## 2. Нижнє меню і «Меню»
1. Унизу кожної сторінки — чотири кнопки і «Меню». Без вашого вибору там перші чотири доступні вам розділи (типово «Структура», «Угоди», «Склад», «Чати»).
2. «Меню» відкриває шторку з усіма пунктами лівого меню.
3. Змінити кнопки — «Налаштування → Мій акаунт → Швидкий доступ» → «Телефон» (докладно — стаття «Швидкий доступ»). Вимкнути нижнє меню — там само, «Показувати нижнє меню на телефоні».

Поки відкрита шторка чи вікно документа, а також клавіатура, нижнє меню й кнопка ШІ ховаються, щоб не закривати кнопки.

## 3. Списки й фільтри
- У «Угодах» шапка в три рядки: назва, пошук, дії; фільтри — за кнопкою «Фільтри» (лічильник показує, скільки ввімкнено), період «з … по …».
- Картка рядка показує назву, суму боргу чи термін, етап і статуси, товари чи контакти, номер і прапорці, «⋮».
- У «Документах» — пошук, «Знайти» і «Фільтри» (шаблон, статус, компанія, дати); у картці документа — PDF, друк, видалити.
- У «Складі» вкладки — ряд пігулок, що прокручується; пошук — окремим рядком.

## 4. Картка угоди на телефоні
- Угорі «Етап N з M», смуга прогресу і ряд етапів з повними назвами, що прокручується; поточний — по центру. Натискання на етап переводить угоду (стрибок більше ніж на один етап — з підтвердженням).
- Чорна кнопка наступного етапу на всю ширину, під нею вибір етапу і «⋮».
- «Підпис — значення» складено: підпис дрібно над значенням.
- «Товари» — картки позицій (фото, назва й сума, кількість, ціна, знижка, собівартість, «⋮»); значення змінюються дотиком.

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

## 6. Налаштування на телефоні
«Налаштування» відкриваються списком груп на весь екран з пошуком; на сторінці налаштувань угорі — «‹ Налаштування · група». Таблиці налаштувань стають картками, форми — в одну колонку, «Зберегти» — внизу групи.

## 7. Оновити іконку застосунку
Іконка встановленого застосунку оновлюється при наступному запуску після оновлення Helomi (Chrome може спитати «Оновити іконку?»). Якщо лишилась стара — приберіть Helomi з головного екрана і знову «Встановити застосунок» у меню Chrome.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| На головному екрані стара іконка | Chrome ще не підхопив нову | Перезапустіть застосунок; якщо не допомогло — встановіть заново |
| У нижньому меню нема потрібного розділу | Розділ не вибрано або вам не відкрито | Додайте його в «Швидкий доступ → Телефон» або попросіть доступ |
| Кнопки внизу шторки не видно | Відкрита клавіатура | Сховайте клавіатуру або прокрутіть шторку |
| Нижнє меню зникло | Вимкнено «Показувати нижнє меню на телефоні» | Увімкніть на сторінці «Швидкий доступ» |

## Для ШІ-співробітників
Телефонна версія — вигляд для людини; ШІ-співробітники працюють через ті самі інструменти й API без інтерфейсу, тож окремих інструментів тут нема.

## Додаткова інформація
- Пов'язані статті: [Швидкий доступ](quick-access.md), [Угоди](deals.md), [Документи](documents.md).


---

# Імпорт і експорт

Імпорт і експорт XLSX переносить дані між Helomi, Excel та іншою CRM: клієнтів, угоди, завдання, товари складу, прайс-лист, документи й записи власних розділів. Файли сумісні з шаблонами KeepinCRM, а файл експорту можна виправити й завантажити назад — збіг за вибраним полем оновить наявний запис замість дубля.

## Можливості
- «Завантажити шаблон» — XLSX з правильними колонками і прикладом.
- Пошук наявних записів за вибраним полем: збіг оновлює, нема збігу — створює новий.
- Перевірка без запису («Перевірити», пробний прогін): що буде створено, оновлено, без змін і з помилками.
- Файл помилок: лише рядки, що не пройшли, з поясненням у першій колонці.
- Експорт усіх, за поточним фільтром або вибраних галочками, з вибором полів (зокрема додаткових).
- Файл експорту імпортується назад без змін.

## 1. Налаштування і доступ
- Імпорт і експорт є в «⋮» шапки кожного розділу (у «Документах» — «⋯»). Права ті самі, що на розділ; для завдань імпорт потребує доступу «Завдання: масові дії».
- Колонки додаткових полів беруться з «Налаштування → Типи даних». Обов'язкові поля перевіряються для нових записів так само, як при ручному створенні.
- Повне перенесення з KeepinCRM зі збереженням id — окрема сторінка «Налаштування → Імпорт із KeepinCRM» (стаття `int-keepincrm`).

## 2. Імпорт: загальний порядок
1. Відкрийте розділ → «⋮ → Імпорт».
2. «Завантажити шаблон», заповніть його (або візьміть файл експорту чи шаблон KeepinCRM).
3. Виберіть файл.
4. Виберіть поле пошуку наявних записів (або «не шукати» — усі рядки нові).
5. «Перевірити» — побачите, що буде створено й оновлено, нічого не змінюючи.
6. «Імпортувати». Підсумок покаже, скільки створено, оновлено, пропущено й з помилками; «Завантажити файл помилок» (або «Файл з помилками») — виправте рядки й завантажте лише їх.

Порожня клітинка при оновленні нічого не змінює. Кожна зміна потрапляє в журнал запису.

## 3. Експорт: загальний порядок
1. Відфільтруйте список, якщо потрібна частина, або позначте рядки галочками.
2. «⋮ → Експорт».
3. Виберіть, що вивантажити (усі / за фільтром / вибрані) і поля («Вибрати всі» / «Зняти всі»). Вибір полів запам'ятовується.
4. «Експортувати» — XLSX завантажиться.

## 4. Клієнти
- «Імпорт клієнтів»: обов'язкова колонка `company` (назва); телефони, email, джерело, відповідальний, теги, коментар, знижка, націнка, філія, день народження, лід, нотатки (`commentN_note`), додаткові контакти (`contactN_*`), додаткові поля за назвою. «Поле для пошуку існуючих»: назва, контактна особа або телефони. Телефони, email, теги й контакти при оновленні доповнюються. До 5 000 рядків.
- «Експорт клієнтів»: «Усі клієнти» (разом з архівними), «За поточним фільтром» або вибрані.

## 5. Угоди
- «Імпорт угод»: шаблон з колонками KeepinCRM і аркушем «Довідка»; «Унікальне поле для оновлення» — «Не оновлювати — завжди нові», назва, Id або додаткове поле. Товари — колонки `job1…jobN` (з каталогу за артикулом або назвою, інакше вільні позиції), клієнт — за телефоном (нема — створюється), нотатки `comment1_note…`, ТТН. Перегляд показує «буде створено», «буде оновлено», «без змін», «помилка».
- «Експорт угод»: «Стандартні поля», «Додаткові поля угоди», «Поля клієнта (client_*)», «Товари угоди»; з поточними фільтрами; до 20 000 рядків.

## 6. Завдання
- «Імпорт завдань»: шаблон з колонками KeepinCRM і додатковими полями; «Пошук збігів» — «Назва завдання (оновити знайдену)» або не шукати; невідома компанія створює нового клієнта; «Останні імпорти» з файлами помилок.
- «Експорт завдань»: вибрані колонки, «Які завдання» — вибрані або всі за фільтром.

## 7. Товари складу і прайс-лист
- «Імпорт товарів» (склад): XLSX або CSV; «Шукати наявний товар за» — «ID, а якщо нема — артикулом», «ID», «Rozetka Offer ID», «Артикулом», «Назвою». Колонка `parent_id` (артикул основного товару) створює модифікації; `category_id` — шлях «Папка / Підпапка» (нові папки створюються); фото — посиланнями; нова наявність записується в журнал як перерахунок. Пробний прогін покаже нові, оновлені, без змін і помилки.
- «Експорт товарів»: «Усі товари складу», відфільтровані (папка, пошук, фільтри) або вибрані; поля по групах.
- Прайс-лист: «Імпорт прайс-листа» з «Ключ збігу» (ID, Rozetka Offer ID, Артикул, Назва) і «Експорт прайс-листа» — див. статтю «Прайс-лист».

## 8. Документи
- «⋯ → Імпорт документів»: «Шаблон файлу» (колонки: Номер, Шаблон, Угода (ID) або Клієнт (ID), Статус, Компанія, Дата, Сума; файл експорту теж підходить), «Як шукати існуючі» — «Не шукати — кожен рядок новий документ», «За ID документа», «За шаблоном і номером»; XLSX до 5 000 рядків.
- «⋯ → Експорт документів»: «Що вивантажити» — усі, за фільтром або позначені галочками у списку; вибір полів.

## 9. Власні розділи
«⋮ → Експорт XLSX» (за поточними фільтрами) і «⋮ → Імпорт XLSX» (колонки за назвами полів, обов'язкова «Назва», спершу перевірка).

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Потрібен файл Excel .xlsx» / «Це не файл Excel (.xlsx) — збережіть як .xlsx або .csv» | Інший формат | Збережіть файл як .xlsx |
| «У файлі нема рядків з даними» / «Файл порожній» | Порожній файл або лише заголовок | Додайте рядки |
| «Файл завеликий (макс. … МБ)» / «Забагато рядків …» | Перевищено ліміт | Розбийте файл на частини |
| «Потрібна колонка «title» (Назва), «sku» (Артикул) або «id» …» | Нема колонки для товару | Візьміть шаблон |
| «Збіг за «…», але такої колонки у файлі нема» | Вибрано поле пошуку, якого нема у файлі | Додайте колонку або виберіть інше поле |
| «Телефон … уже є в клієнта #…» (у файлі помилок) | Імпорт без пошуку наявних натрапив на дубль | Увімкніть пошук за телефонами |
| «Виберіть хоча б одне поле» | Експорт без полів | Позначте поля |
| «Немає доступу до масових дій із завданнями (імпорт)» | Не відкрито «Завдання: масові дії» | Попросіть доступ |

## Для ШІ-співробітників
5`. ШІ створює й змінює записи по одному інструментами розділів (`deals_create`, `clients_create`, `tasks_create`, `records_create` з `idempotency_key`, щоб повтор не дав дубля).

## Додаткова інформація
- Пов'язані статті: [Клієнти](clients.md), [Угоди](deals.md), [Завдання](tasks.md), [Склад і товари](products.md), [Прайс-лист](pricelist.md), [Документи](documents.md), [Власні розділи](custom-sections.md).