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

# Типи даних і поля

«Типи даних» — місце, де ви самі вирішуєте, з яких полів складаються клієнт, угода, товар, завдання, додатковий контакт і операція «Фінансів»: які поля є, які обов'язкові, що видно в списку, у формі створення й у картці, і в якому порядку. Змінили тут — і одразу бачите це в розділі, на телефоні, в імпорті та в тому, що читає ШІ, без жодної правки коду.

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

## 1. Налаштування
Дорога: «Налаштування → Типи даних» і тип: «Клієнти», «Угоди», «Товари», «Завдання», «Дод. контакти», «Фінанси» (поля операції: «Вивести при створенні» — шторка «Новий платіж», «Вивести в списку» — колонка журналу; стаття «Фінанси», розділ 1б). Поля власних розділів — «Налаштування → Типи даних → Власні розділи» (стаття «Власні розділи»).

Швидкий шлях із самого розділу: «⋮ → Налаштувати поля» у «Клієнтах», «Угодах», «Завданнях», «Товарах» і у власних розділах; у картці угоди — «⋮ → Налаштувати поля угоди». Пункт видно адміністратору.

На сторінці типу — пошук полів, таблиця з колонками «Увімкнено», «Назва», «Тип поля», «Обов'язкове поле», «Вивести в списку», «Вивести при створенні», «Блок», «ID» і «⋮» поля, внизу — сторінки, «Рядків на сторінці» (25 / 50 / 100) і «Всього». У «Завданнях» над полями ще таблиця «Типи завдань» (стаття «Довідники»).

Змінювати поля може людина з доступом до налаштувань (адміністратор або з галочкою «Налаштування CRM»).

## 2. Додати своє поле
1. Натисніть «Додати» під таблицею або «⋮ → Додати поле» вгорі.
2. У шторці «Користувацьке поле» заповніть «Назва *», «Тип поля *», «Блок *» (або «+ Новий блок…»).
3. Для «Списку» введіть «Варіанти списку *» по одному, кожен — клавішею Enter.
4. За потреби задайте «Значення за замовчуванням» — воно підставиться в новий запис.
5. Для полів клієнта є «Також відображати у розділах»: «Угоди» (внизу «Даних угоди» блоком «Поля клієнта» і колонкою в списку угод) і «Завдання» (у шторці завдання, у блоці про клієнта).
6. Поставте потрібні прапорці (розділ 3) і натисніть «Зберегти».

Ключ поля (латиницею) створюється з назви сам і видно в колонці «ID»; нове поле угоди одразу стоїть у картці.

## 3. Прапорці: обов'язкове, у списку, при створенні, в угоді
| Прапорець | Що робить |
| --- | --- |
| «Обов'язкове поле» | Без значення запис не створиться; наявне значення не можна стерти |
| «Вивести в списку» | Колонка в таблиці розділу |
| «Вивести при створенні» | Поле у шторці нового запису («Нова угода», «Новий клієнт»…) |
| «Вивести в угоді» (угоди) | Рядок у «Даних угоди» картки, на місці за порядком таблиці |
| «Вивести в угоді» (товари) | Колонка у вікні «Додати товар зі складу» |
| «Вивести в накладних» (товари) | Зберігається для шаблонів документів |
| «Видно колегам» (люди) | Поле в картці людини в «Структурі»; без галочки — лише сама людина й адміністратор (стаття [Люди: картки й анкети](people.md)) |
| «Додати у фільтр» | Фільтр за цим полем у списку розділу |
| «Дозволити мультивибір» | Кілька значень для «Рядка» або кілька варіантів для «Списку» |

Прапорці в рядку таблиці зберігаються одразу після кліку. Якщо поле приховане при створенні, обов'язковість при створенні не вимагається.

## 3а. Підказка поля
Підказка — одне речення під полем у формі створення: що станеться або звідки значення («Без клієнта угоду не збережуть. Новий створиться сам.»). Її бачать усі, хто заповнює форму, і ШІ-співробітники в описі розділу, тому людина й ШІ заповнюють поле однаково.

- Колонка «Підказка (бачать люди і ШІ)» — клацніть по тексту в рядку поля, напишіть і натисніть Enter (Esc — скасувати). До 300 знаків.
- У вбудованих полів (ID, Назва, Телефон, Клієнт…) уже є типова підказка; її можна змінити або стерти, а кнопка «Типова» повертає її.
- У шторці власного поля — поле «Підказка» під назвою.
- У формах розділів (угода, клієнт, контакт, завдання, товар, платіж, запис власного розділу) підказка з'являється під полем, коли воно у фокусі або під курсором; на телефоні — завжди. Порожня підказка — рядка нема.
- Пишіть наслідок, а не повтор назви: не «Телефон клієнта», а «За номером шукаються клієнт, дублі й переписки».

## 4. Порядок і блоки
- Тягніть рядок за «↕» — порядок спільний для вбудованих і власних полів і однаковий у списку, формі створення й картці. Під час пошуку перетягування вимкнене.
- «⋮ → Перейменувати блок…» вгорі сторінки змінює назву блоку картки для всіх його полів.

## 5. Системні поля із замком
Вбудовані поля мають позначку «системне». Їх не можна видалити чи змінити тип; прапорці, без яких запис не існує (наприклад «Увімкнено» в ID, назви, клієнта, етапу, воронки угоди), заблоковані й сірі. Прочерк «—» означає, що для цього поля прояву нема (наприклад, колонки в шторці). Решту прапорців вбудованих полів можна вмикати й вимикати, а рядки — переставляти.

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

## 7. Унікальність і дублі
- «Контроль унікальності» — те саме значення в іншого запису не збережеться. Якщо дублі вже є, система попередить і запропонує ввімкнути все одно.
- «Відобразити дублі» — у «⋮» поля з'явиться «Показати дублі»: список повторюваних значень із номерами записів.

## 8. Вимкнути або видалити поле
- Зніміть «Увімкнено» — поле зникне з карток, списків і фільтрів, значення збережуться.
- «⋮ → Видалити» прибирає поле разом з усіма значеннями після підтвердження; дані не відновити. Поля, що прийшли з імпорту KeepinCRM, лише вимикаються.
- Зміна типу не перетворює старі значення: вони лишаються текстом і можуть показуватися некоректно.

На телефоні рядок таблиці стає карткою: назва з «↕» і «⋮», під нею тип, блок і ID, далі пігулки прапорців.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Потрібна назва поля» | Порожня «Назва» | Впишіть назву |
| «Для списку потрібні варіанти: введіть варіант і натисніть Enter» | Тип «Список» без варіантів | Додайте хоча б один варіант |
| «Поле «…» у цій сутності вже є» | Така назва вже зайнята | Дайте іншу назву |
| «Увімкнути унікальність не можна: є N повторюваних значень…» | Дублі вже є | «Показати дублі», виправте або підтвердіть примусово |
| «Системне поле (з імпорту) не видаляється — лише архівується» | Поле прийшло з KeepinCRM | Зніміть «Увімкнено» |
| «Виберіть хоча б одну воронку або «Усі воронки»» | «Лише вибрані» без жодної воронки | Позначте воронку |
| «Заповніть обов'язкове поле «…»» (у розділі) | Поле позначено обов'язковим | Заповніть його або зніміть прапорець тут |

## Для ШІ-співробітників
- Поля кожного розділу з прапорцями й варіантами — `describe_section("<key>")` (`deals`, `clients`, `tasks`, `products`, slug власного розділу). Обов'язкові поля діють для ШІ так само, як для людини: запис без них повертає помилку з назвою поля.
- Власні поля в запитах передаються в об'єкті `custom` за ключем поля.
- У кожного поля в `describe_section` є `hint` — та сама підказка, що людина бачить під полем: заповнюйте поле так, як вона каже.
- Змінювати поля вбудованих розділів і розділів людей ШІ не може: «Налаштування CRM» для ШІ закриті завжди. З правом творця «Свої розділи» ШІ читає поля будь-якого розділу (`fields_list`) і змінює лише поля своїх розділів (`fields_create`, `fields_update`, `fields_builtin_update`, `fields_delete` — видалення чекає підтвердження людини). Докладно — стаття «ШІ-творець».

## Додаткова інформація
- Пов'язані статті: [Угоди](deals.md), [Клієнти](clients.md), [Завдання](tasks.md), [Склад і товари](products.md), [Воронки, етапи, переходи](settings-funnels.md), [Власні розділи](custom-sections.md), [Налаштування: огляд](settings.md).
- Тип «Формула» є в коді для полів товарів (варіант Prom), але в шторці його вибрати не можна.