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

# Ролі

Роль у Helomi — це типовий вигляд для посади: що людина бачить на екрані першим. Менеджеру — угоди, клієнти й завдання, комірнику — склад і доставки, бухгалтеру — фінанси й документи. Роль задає закріплене меню, колонки списків і «Головне» картки угоди й клієнта; кожен потім змінює це під себе. Права роль не змінює: хто що може відкривати, вирішують галочки в «Розділах меню» й «Доступах».

## Можливості
- П'ять вбудованих ролей: «Менеджер продажів», «Комірник», «Касир», «Бухгалтер», «Власник / директор».
- Свої ролі: «Дизайнер», «Оператор» — будь-яка назва.
- Для кожної ролі — закріплене меню (3–9 пунктів), «Головне» картки угоди й клієнта (до 8 полів), колонки списків (до 8).
- «Скинути до типових» для вбудованої ролі, «В архів» — для своєї.
- «Люди й ролі»: хто яку роль має; без призначення роль вгадується з доступів.
- «Поставити галочки розділів» — увімкнути людині розділи ролі одним кліком (інші її галочки лишаються).

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

> [!NOTE]
> Поки роль не призначена, Helomi вгадує її з доступів: адміністратор — власник, склад без клієнтів — комірник, фінанси без складу — бухгалтер, лише каса — касир, решта — менеджер.

## 2. Змінити типовий вигляд ролі
Набір ролі — це старт для всіх людей з цією роллю, які не закріпили своє.
1. Відкрийте «Налаштування → Команда й доступи → Ролі».
2. На картці ролі натисніть «Меню», «Головне» угоди», «Головне» клієнта», «Колонки угод» або «Колонки клієнтів».
3. Позначте пункти в потрібному порядку — номер біля галочки показує місце.
4. Натисніть «Зберегти».

Змінену вбудовану роль позначено «змінено»; «Скинути до типових» повертає набір Helomi.

## 2а. «Головне» картки за роллю
«Головне» — верхній блок картки угоди й клієнта, до восьми полів. Якщо роль задає свій набір (комірнику — клієнт, етап, товари, ТТН), люди з цією роллю бачать у «Головному» саме його; решта полів лишається в згорнутих групах картки. Якщо набір ролі збігається з типовим (у вбудованих «Менеджера» й «Власника»), діє вибір організації «У головному» в «Налаштування → Типи даних → Угоди» і «Клієнти».

1. Відкрийте «Налаштування → Команда й доступи → Ролі» і натисніть «Змінити» на картці ролі.
2. Натисніть «Головне» угоди» або «Головне» клієнта».
3. Позначте до восьми полів у потрібному порядку й натисніть «Зберегти» — картки людей з цією роллю покажуть новий набір при наступному відкритті.

> [!NOTE]
> Це лише вигляд: поля, їх обов'язковість і те, що бачить ШІ, задають «Типи даних». Колонки списків за роллю підключаються окремо.

## 3. Додати свою роль
Своя роль потрібна, коли посада не схожа на вбудовані.
1. Натисніть «Своя роль».
2. Введіть назву.
3. Змініть меню, «Головне» й колонки, як у розділі 2.

## 4. Увімкнути людині розділи ролі
Роль не відкриває розділів сама. Щоб людина побачила розділи своєї посади, увімкніть їй галочки.
1. На картці ролі виберіть людину в полі «кому поставити галочки розділів».
2. Натисніть «Поставити».

> [!WARNING]
> Це змінює доступи людини: вмикає розділи ролі. Вимкнути зайве — «Налаштування → Команда й доступи → Розділи меню» або картка людини.

## Можливі помилки
| що видно | чому | що зробити |
| --- | --- | --- |
| «Закріплене меню: від 3 до 9 пунктів» | у меню ролі замало або забагато пунктів | позначте від трьох до дев'яти |
| «Вбудовану роль не архівують» | «Менеджер», «Комірник» та інші потрібні завжди | змініть її або «Скиньте до типових» |
| людина не бачить пункт ролі | у неї нема доступу до розділу | увімкніть галочку в «Розділах меню» |

## Для ШІ-співробітників
Ролі змінює людина з доступом до «Налаштувань CRM». Свій вигляд людини ШІ бачить через «Мої налаштування»; набір «Головного» ролі людини — `GET /api/crm/ui/me` → `main_own` (лише коли роль задає свій набір; інакше діє «У головному» з «Типів даних», яке ШІ бачить у `fields[].main` картки розділу); змінювати ролі й доступи ШІ не може — це правило безпеки Helomi.

## Додаткова інформація
- [Закріплене меню](pinned-menu.md) — як людина змінює свої пункти.
- [Доступи й розділи](settings-access.md) — хто що може відкривати.
- [Що використовують](usage.md) — частота, за якою вирішують, що лишити на екрані.