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

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

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

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