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

# Власні розділи

Власний розділ — розділ, якого нема серед стандартних, але потрібен саме вашій компанії: ремонти, проєкти, заявки, гарантійні випадки. Його пише ваш ШІ одним файлом (дані, свій вигляд і логіка) або ви збираєте в конструкторі без коду: назва, іконка, етапи, поля, що є в картці; правила передачі створюють з запису угоду, клієнта, задачу чи запис іншого розділу. У меню зліва розділ ставиться перемикачем на його плитці.

## Можливості
- Галерея «Власні розділи»: плитки розділів і прозорий квадрат «+ Додати розділ» — туди перетягують файл розділу від ШІ.
- «У меню зліва» на плитці (і відділ меню), порядок — перетягуванням плиток. Окремого пункту «Розділи» в меню нема.
- Файл розділу від ШІ: дані, своя сторінка й агент одним файлом; ШІ-співробітник з правом творця встановлює сам (стаття [Розділ від ШІ](section-package.md)).
- Назва розділу й запису, іконка з фірмового набору, опис «Для чого розділ (бачать люди й ШІ)».
- Етапи з кольорами й позначкою «завершальний»; дошка за етапом або за полем-списком.
- «Що є в картці»: відповідальний, клієнт, угода, бренд, нотатки, файли.
- Поля тим самим конструктором «Типи даних», що в угод і клієнтів: обов'язковість, «при створенні», «у списку» діють і у формі, і в API.
- Список, дошка, картка-шторка з нотатками, файлами й журналом.
- Правила передачі: новий запис або етап → угода, клієнт, задача, запис іншого розділу.
- Окремий доступ до кожного розділу; імпорт і експорт XLSX; архів.

## 1. Налаштування: галерея і новий розділ
«Налаштування → Типи даних → Власні розділи» — галерея: кожен розділ плиткою (іконка, назва, що всередині — «код · сторінка, агент, дані» або «конструктор · N записів», хто створив), останній — прозорий квадрат «+ Додати розділ».

**Файл від ШІ (з кодом і своїм виглядом):**
1. «Інструкція для ШІ» — збережіть файл і дайте його своєму ШІ (Claude, ChatGPT, Gemini) разом з описом розділу; або «+ Розділ» → «Скопіювати завдання для ШІ».
2. ШІ віддасть файл розділу (`.sgsection.json` або `.html`). Перетягніть його в квадрат «+ Додати розділ» (або «+ Розділ» → «Вибрати файл»).
3. Відкриється перевірка: «Що буде зроблено», «Зауваги», «Помилки». Якщо такий розділ уже є — «Оновити «…»» або «Окремий розділ поруч».
4. «Показати в меню зліва» (і відділ меню) → «Встановити» / «Оновити».

**ШІ-співробітник зробить сам:** напишіть Ломі чи іншому ШІ «Зроби розділ Ремонти…» — з правом творця він встановить розділ сам, у галереї з'явиться плитка, а в меню зліва її ставите ви.

**Конструктор без коду:**
1. «+ Розділ» → «Зібрати вручну».
2. Заповніть «Назва розділу» (наприклад, «Ремонти»), «Назва запису» («Ремонт»), «Іконка», «Опис».
3. «Етапи (дошка)»: назви, кольори, порядок «Вище» / «Нижче», позначка «завершальний»; «без етапів», якщо етапи не потрібні.
4. «Дошка за»: «за етапом», за полем-списком або «без дошки».
5. «Що є в картці»: «Відповідальний», «Клієнт», «Угода», «Бренд», «Нотатки», «Файли».
6. «Розділ увімкнено» → «Створити». З'явиться плитка в галереї.

**Меню зліва:** на плитці — «У меню зліва» і відділ меню («основний список» або відділ, як він називається в меню). Пункт бачать усі, кому розділ доступний; сховати лише для себе — «Моє меню». Порядок пунктів — перетягуванням плиток.

**«⋮» на плитці:** «Відкрити», «Налаштувати розділ» / «Налаштувати дані», «Поля», «Таблиця даних» (записи розділу з кодом стандартним списком), «Код і версії», «Файл розділу» (вивантажити, дати ШІ доробити й завантажити назад — «Оновити»), «Видалити».

## 2. Поля розділу
1. На плитці «⋮ → Поля» або з розділу «⋮ → Налаштувати поля» — відкриються «Типи даних» цього розділу.
2. Додайте поля будь-якого типу; позначте «обов'язкове», «при створенні», «у списку».
3. Вбудовані поля (назва, етап, клієнт…) видно з замком: їх не вимкнути, лише налаштувати показ і обов'язковість.

## 3. Передача в інші розділи
1. На плитці «⋮ → Налаштувати розділ» — блок «Передача в інші розділи» → «+ Правило».
2. Коли: новий запис або запис перейшов на етап (наприклад, «Готово»).
3. «створити в»: угода, клієнт, задача або інший власний розділ.
4. «+ що передати»: поле цілі і що в нього підставити — текст або значення з запису (`{title}`, `{custom.ключ}`).
5. Для угоди, клієнта й задачі можна позначити зв'язок — створене прив'язується до запису.

Приклад: запис перейшов на «Готово» → задача «Видати клієнту». Створення проходить ті самі перевірки, що й вручну: обов'язкові поля цілі мають бути заповнені правилом.

Тригерів і автоматичних задач за налаштуваннями тригерів для записів власних розділів поки нема — лише правила передачі (`features.csv`: «Тригери й задачі для записів власних розділів» — далі).

## 4. Доступ до розділу
- Кожен власний розділ має свій ключ доступу `x:<коротке ім'я>`; сторінка з кодом без своїх даних — `xe:<коротке ім'я>`. Галочка — у «Налаштування → Розділи меню» (або в картці людини в «Користувачі»). Пункт у меню зліва бачать лише ті, кому розділ доступний.
- Людям новий розділ типово відкритий, ШІ-співробітникам — лише якщо адміністратор відкрив його в доступах ШІ.

## 5. Працювати із записами
Записи власного розділу ведуть так само, як угоди: список і дошка етапів, картка-шторка з полями, нотатками, файлами й журналом. Які поля є і що під ними підказано — налаштовує власник розділу в його «Типах даних».

1. Пункт розділу в меню зліва (якщо його туди поставили) або «Власні розділи» → плитка → назва.
2. Вкладки «Список» і «Дошка» (якщо є етапи або поле-список); фільтр за етапом («усі» або етап), галочка «Архів», «Пошук».
3. «+ <Назва запису>» (наприклад, «+ Ремонт»; у порожньому розділі — «Додати перший») → форма з полями «при створенні» → «Створити».
4. Клік по запису відкриває картку-шторку: поля (змінюються на місці), етап, відповідальний, клієнт («Телефон або назва»), «Нотатки», «Файли» («Прикріпити файл»), «Журнал».
5. На дошці перетягніть картку в іншу колонку — етап зміниться, спрацюють правила передачі.

## 6. Архів і видалення
- «в архів» / «з архіву» у картці запису.
- Видалити запис назавжди може лише адміністратор; інші переносять в архів.
- Розділ без записів можна видалити; розділ із записами — лише вимкнути.

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

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

## Для ШІ-співробітників
Власний розділ видно в каталозі за коротким ім'ям: `describe_section("<slug>")` повертає поля, етапи й обов'язкові. Потрібен доступ до розділу `x:<slug>` (і «Власні розділи»).

| Інструмент | Що робить |
| --- | --- |
| `records_meta` | Опис розділу: етапи, поля, обов'язкові, відповідальні |
| `records_list` | Записи з `q`, `stage`, `responsible_id`, `client_id`, `archived` |
| `records_get` | Картка запису: поля, нотатки, журнал |
| `records_create` | Новий запис (обов'язкові поля — з «Типів даних»); передавайте `idempotency_key` |
| `records_update` | Змінити запис: етап, поля, відповідальний |

ШІ з правом творця встановлює цілий розділ файлом (дані, сторінка, агент): `sections_package_guide` → `sections_package_check` → `sections_package_install`, свій розділ вивантажує `sections_package_export` і оновлює з `update`; перелік — `sections_gallery`. Інструкція — стаття [Розділ від ШІ](section-package.md). У меню зліва розділ ставить людина.

ШІ з правом творця «Свої розділи» може також створювати власні розділи й поля по одному інструментами `sections_list`, `sections_create`, `sections_update`, `sections_rule_targets`, `sections_delete` (порожній свій розділ; **спочатку запитати**), `fields_list`, `fields_create`, `fields_update`, `fields_builtin_update`, `fields_delete` (**спочатку запитати**) — і змінювати лише створене собою.

Чого не робити:
- Не вигадувати `slug` і назви етапів — брати з `records_meta`.
- Не змінювати розділи, створені людьми або іншими ШІ.
- Не видаляти записи: інструмента видалення нема, у людини це робить лише адміністратор.

## Додаткова інформація
- Пов'язані статті: [Розділ від ШІ: файл розділу](section-package.md), [Розширення (код)](extensions.md), [Імпорт і експорт](import-export.md), [Угоди](deals.md), [Завдання](tasks.md).