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

# Консоль платформи

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

## Можливості
- Список компаній зі станом, підпискою, «Оплачено до», кількістю людей, розміром бази й останнім входом.
- Підписка 3 000 грн на місяць, пробний період, рахунки, позначка «оплачено» вручну, автопризупинення.
- Тарифи з лімітами людей, ШІ-співробітників, власних розділів і місця.
- Звернення компаній і відповіді на них.
- «Увійти як власник» і вивантаження — лише з доступом підтримки, відкритим компанією на час.
- Видалення з утриманням 30 днів, оголошення для всіх компаній, журнал усіх дій консолі.
- Окремий логін і пароль адміністратора платформи.

## 1. Налаштування
- Консоль відкриває адміністратор платформи: «Налаштування → Компанія → Консоль платформи» або після входу окремою поштою адміністратора (вона одразу веде в консоль). Ліворуч — меню консолі: «Огляд», «Компанії», «Оплати», «Тарифи», «Підтримка», «Оголошення», «Журнал», «Ломі», «Сервер», «Налаштування»; унизу — «До своєї компанії» і «Вийти».
- Консоль → «Налаштування»: ціна підписки, пробний період, пільгові дні, відкрита чи закрита реєстрація компаній, реквізити для рахунків, email підтримки.
- Там само — «Вхід адміністраторів платформи»: пошта (не з жодної компанії) і пароль (щонайменше 10 символів, літери й цифри) → «Створити окремий вхід». Робочому акаунту компанії можна «Забрати права» — тоді ваша компанія справді така сама, як усі (останнього адміністратора забрати не можна).

Консоль і пункт «Тариф і оплата» з'являються, коли сервер працює в режимі кількох організацій; «Підтримка» тоді пише команді Helomi.

## 2. Огляд і компанії
«Огляд»: «Компаній» (і нових за 30 днів), «Дохід на місяць», «Сплачено за 30 днів», «Прострочено», «Пробний період», «Нові звернення»; нижче — прострочені рахунки й нові звернення.

«Компанії»: пошук «Назва, адреса чи email власника», таблиця «Компанія», «Стан», «Підписка», «Оплачено до», «Людей», «База», «Останній вхід». «+ Компанія» → «Назва *» і «Коротке ім'я (slug) *» (латиниця, цифри й дефіс; змінити потім не можна) → «Створити». Нові компанії створюються лише в суворому режимі сервера.

Клік по компанії — картка: «Власник і контакти», «Реквізити», «Підписка», «Рахунки», «Використання за 30 днів» (графіки), «Доступ підтримки», «Звернення».

## 3. Підписка, рахунки, оплати
- У картці компанії — «Підписка» → «Зберегти підписку». Наявні компанії стоять «без оплати», нові отримують пробний період.
- Рахунки виставляються самі; невчасно сплачена компанія призупиняється автоматично (перевірка щогодини).
- «Оплати»: фільтри «усі», «виставлені», «прострочені», «оплачені», «скасовані». Платіжної системи поки нема: «оплачено» в рядку рахунку ставиться вручну й продовжує підписку; рахунок можна скасувати.

## 4. Тарифи й ліміти
«Тарифи» — ліміти людей, ШІ-співробітників, власних розділів і місця для кожного тарифу, з кількістю компаній на ньому. Коли компанія впирається в ліміт, вона бачить «Тариф «…» дозволяє до N … Щоб додати більше, зверніться до адміністратора платформи». Розмір бази лише показується, але не блокує роботу.

## 5. Підтримка і доступ підтримки
- «Підтримка» в консолі: звернення всіх компаній. Фільтри одним рядком: пошук (тема, текст листування, автор, компанія, №),
  стан з лічильниками («Усі», «Нові», «Є відповідь», «Закриті»), тема («Помилка в системі», «Як налаштувати», «Пропозиція»,
  «Оплата й тариф», «Інше»), результат від людини («Вирішено», «Не вирішено», «Ще не оцінено») і компанія. У рядку — кольорова
  точка теми, компанія, автор, стан і результат; праворуч — листування, «Відповісти», «Закрити звернення».
- Після кожної відповіді людина в компанії бачить «Питання вирішено?»: «Так, вирішено» — звернення закривається з позначкою
  «вирішено»; «Ні, не вирішено» + пояснення — звернення знову нове, позначка «не вирішено», пояснення — в листуванні. Нова
  відповідь підтримки скидає оцінку, людина оцінює знову.
- Доступ до даних компанії відкриває **сама компанія**: «Налаштування → Система → Підтримка → Доступ підтримки» — «на годину», «на добу» або «на тиждень» → «Відкрити доступ»; закрити раніше — «Закрити доступ». Поки доступ закрито, адміністратор платформи бачить лише назву, тариф і використання, а не угоди, клієнтів і файли.
- З відкритим доступом у картці компанії працюють «Увійти як власник» (вхід записується в журнал і видно компанії) і «Вивантажити» (архів бази й файлів).

## 6. Призупинити, видалити, вивантажити
Унизу картки компанії: «Призупинити» / «Увімкнути» і «Видалити». Видалена компанія одразу втрачає вхід, її дані зберігаються 30 днів (можна відновити), потім база й файли переносяться в архів на сервері. Однаково для всіх компаній, у тому числі компанії №1.

## 7. Оголошення і журнал
- «Оголошення» — текст, тип («звичайне» або «важливе») → «Опублікувати». У всіх компаніях воно показується пігулкою внизу екрана (над доком телефона).
- «Журнал» — усі дії консолі, оплати, доступи підтримки, реєстрації.
- «Сервер» — стан машини платформи (що зробити, ресурси, сервіси, база, бекапи, безпека). Це справа платформи, а не компанії,
  тому в режимі кількох організацій «Сервер» є лише в консолі, а з «Налаштування → Система» компаній прибраний; без режиму
  платформи (одна компанія, консолі нема) він лишається в «Налаштування → Система». Стан сервера бачить лише адміністратор
  платформи — і окремим входом адміністратора, і робочим акаунтом своєї компанії, поки цей акаунт є в списку «Консоль →
  Налаштування → Вхід адміністраторів платформи».

## 8. Що бачить компанія
- «Налаштування → Компанія → Тариф і оплата» — «Підписка», «Ціна» на місяць, «До сплати», «Як оплатити», таблиця рахунків («Рахунок», «Період», «Сума», «Стан», «Сплатити до»).
- «Налаштування → Система → Підтримка» — одна сторінка (раніше були дві: «Служба підтримки» і «Підтримка Helomi»):
  «+ Нове звернення» з темою (помилка в системі, як налаштувати, пропозиція, оплата й тариф, інше), список з тими самими
  фільтрами, листування, «Питання вирішено?», «Дописати», «Відкрити знову». Пише кожен працівник компанії й бачить свої
  звернення; адміністратор компанії бачить усі звернення компанії і керує «Доступом підтримки» (смуга вгорі сторінки).
  Стара адреса `/crm/settings/help-desk` відкриває ту саму сторінку.
- «Налаштування → Мій акаунт → Мої організації» — компанії, у яких людина працює з тією самою поштою, і перехід між ними.

## 9. Захист
- Кожен запит — лише в межах своєї компанії: чужі дані відповідають «не знайдено» (суворий режим).
- Вхід захищено від підбору пароля: 10 невдалих спроб за 15 хвилин — пауза.
- Реєстрація компаній: пастка для ботів, не більше 5 реєстрацій на годину з однієї адреси, вимоги до пароля; відкривається в консолі → «Налаштування».

## 10. Ломі для всіх компаній і на головній
Консоль → «Ломі» — ключі, якими Ломі працює в усіх компаніях, і її поведінка на головній сторінці.

- **Голос — Google (Gemini TTS).** «Ключ Google AI», перемикач «Озвучувати Ломі цим ключем у всіх компаніях», «Голос», «Модель озвучення», «Швидкість мовлення», «Рушій голосу Google» («Gemini, потім Chirp 3 HD» — типово: коли ліміт Gemini вичерпано на всіх ключах і моделях — Google Cloud Text-to-Speech, голоси Chirp 3 HD, 1 млн знаків на місяць безкоштовно, потрібен увімкнений Cloud Text-to-Speech API в проєкті ключа; «Chirp 3 HD, потім Gemini»; «лише Gemini»; «лише Chirp 3 HD»), галочка «Вичерпано ліміт моделі Gemini — брати іншу модель Gemini» (у кожної моделі свій ліміт), «Запасний голос, коли Google не озвучив» («Поліна» — безкоштовний голос Microsoft, типово; «вимкнено» — тоді без Google лише текст; під полем — скільки разів Поліна озвучила сьогодні), «Як говорити». Ключ зберігається зашифрованим і назад не показується — лише «задано ••••» і чотири останні символи.
- **Мозок — Anthropic (Claude).** «Ключ Anthropic» і перемикач «Думати Ломі цим ключем у всіх компаніях — платить платформа». Компанія зі своїм ключем бере свій.
- **Ломі на головній — для гостей.** Перемикач «Ломі говорить з гостями головної», стан («відповідає моделлю» або «без ключа — відповіді з WIKI», «голос Gemini» або «голос браузера»), лічильник «сьогодні запитань», «Модель для гостей» (claude-opus-5-5 — найрозумніша, claude-haiku-5-5 — найдешевша й найшвидша), «Запитань на добу (усі гості)», «Запитань з однієї адреси на годину», «Довжина відповіді гостю» (знаків, 150–1000, типово 500), «Запасні ключі Google» — скільки завгодно ключів Google у черзі: Ломі працює з основним, а коли той вичерпав добовий ліміт Google, одразу бере наступний (до вичерпаного повертається після півночі за тихоокеанським часом); біля кожного видно, скільки озвучень сьогодні й чи він на паузі, «Привітання» і «Екскурсія» — одна репліка на рядок у порядку Можливості, ШІ-співробітники, Інтеграції, WIKI, Телефон, Ціна, Почати; «Планети першого екрана» — що Ломі каже, коли гість торкається планети-розділу у вихорі, рядок на планету: Угоди, Склад, Фінанси, Документи, Доставки, Переписки, ШІ-співробітники, WIKI. Окрема група «Звуки розділів головної»: перемикач тихого фону, «Гучність фону» (0–1, типово 0,15), «Під голосом Ломі — частка гучності» (типово 0,5: чутно, але тихо) і для кожного розділу головної свій звук — Космос, Місто й сміх, Ліс, Тихий дощ у лісі, Парк із фонтаном, Море або Тиша; тематичні елементи розділу змінюються разом зі звуком. Записи — у суспільному надбанні. Для гостей ключ Anthropic береться з цієї сторінки завжди, незалежно від перемикача «для всіх компаній»; якщо його нема — ключ із .env сервера.

Гостям Ломі відповідає лише про Helomi і CRM, не бачить даних жодної компанії й нічого не змінює. Озвучити можна лише репліки, які видав сервер (вони підписані), тож ключ Google не використати для чужого тексту.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Увійти як власник» і «Вивантажити» неактивні | Компанія не відкрила доступ підтримки | Попросіть компанію відкрити доступ у «Налаштування → Підтримка» |
| Працівник не бачить «Доступ підтримки» | Доступом керує лише адміністратор компанії | Попросіть адміністратора |
| «Тема звернення: bug, howto, …» | Через API передано невідому тему | Візьміть одну з: `bug`, `howto`, `idea`, `billing`, `other` |
| «Платформа ще в м'якому режимі…» | Сервер не в суворому режимі | Увімкнути суворий режим на сервері, потім «+ Компанія» |
| «Тариф «…» дозволяє до N …» (у компанії) | Ліміт тарифу | Змініть тариф компанії в консолі |
| Немає пункту «Консоль платформи» | Ви не адміністратор платформи або сервер в одній організації | Увійдіть окремим входом адміністратора |
| «Стан сервера бачить лише адміністратор платформи» | Акаунт, яким ви ввійшли, не адміністратор платформи | Увійдіть окремим входом адміністратора (створюється в «Консоль → Налаштування → Вхід адміністраторів платформи») |

## Для ШІ-співробітників
Консолі для ШІ нема і не буде: ШІ-співробітник працює лише всередині своєї компанії. Тарифний ліміт ШІ-співробітників діє і на агентів, яких створює ШІ-творець. Звернення в підтримку пишуть люди: токен ШІ на `/api/platform/my/support*` отримує 403. Якщо людина просить ШІ «напиши в підтримку», ШІ підказує їй сторінку «Налаштування → Підтримка» і тему (помилка, як налаштувати, пропозиція, оплата, інше).

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