# Керівництво користувача та огляд інтеграції

## 1) Що таке FnBright

**FnBright** — це платформа аналітики від **MainaraSoft** для побудови звітності та дашбордів для ресторанного бізнесу. Платформа має **API-конектор** до **Syrve (iiko)**: ми під’єднуємося до OLAP-звітів API Syrve, регулярно забираємо показники, нормалізуємо їх і виводимо у зрозумілі інтерактивні панелі.

## 2) Яку користь ви отримуєте

- **Зниження ризиків шахрайства** (контроль скасувань, знижок, нетипових операцій) — втрати зменшуються до **15%**.
- **Точність обліку** вища на **25%** завдяки прямій інтеграції з POS.
- **Скорочення витрат** (ФОП/продукти/операційні) — до **20%**.
- **Підвищення продуктивності** — автоматизація рутинних задач економить до **30%** часу.

> Результати залежать від процесів конкретного закладу; цифри вище — орієнтири, яких досягають клієнти після впровадження.

## 3) Що всередині: набір дашбордів

У стандартній поставці доступні **шість класичних панелей**:  
**Загальний**, **Продажі**, **Витрати**, **Персонал**, **Меню**, **Склад**. Кожна панель інтерактивна й показує дані в режимі, наближеному до реального часу.

Коротко про вміст:

- **Загальний.** Сумарні метрики бізнесу: тренди, відхилення від минулих періодів, частка зарплат і продуктів, «хто більше продає/дає знижки», топ-страви/товари.
- **Продажі.** Детальніше про тренди, знижки й скасування, кількість гостей/чеків, середній чек, прибуткові дні та години.
- **Витрати.** Вартість персоналу, продуктів, собівартість і прибуток, години, коли втрачаються гроші.
- **Персонал.** Продажі офіціантів, хто що добре/слабо продає, відпрацьований час і внесок у касу, знижки та скасування.
- **Меню.** Популярність позицій, ціни, частка виручки, скасування/знижки по стравах, тренди за днями й часом.
- **Склад.** Поточні залишки по категоріях і позиціях, негативні залишки, прогнози закупівель.

## 4) Як це працює (архітектура інтеграції)

1. **Підключення до Syrve API.** Ви надаєте доступ до вашого API-сервера Syrve (домен/URL, ключ/токен, список закладів/терміналів).
2. **Конектор FnBright.** За розкладом робляться запити до **OLAP-звітів** (категорії продажів, чеки, скасування, знижки, собівартість, залишки тощо).
3. **Обробка та збагачення.** Нормалізація довідників, мапінг мереж/закладів/відділень, підрахунок KPI (середній чек, APC, labor cost, дисконт, ануляції).
4. **Візуалізація.** Дані потрапляють у дашборди FnBright, де їх можна фільтрувати за датою, часом, містом, закладом, категоріями меню й персоналом.

## 5) Кому це потрібно

- Власникам/керівникам мереж — бачити **картину по всій мережі** та швидко знаходити «де тече».
- Операційним директорам — контролювати **часи пікового заробітку/втрат** і продуктивність змін.
- HR/навчання — бачити **сильних і слабких** офіціантів, планувати коучинг.
- Фінансистам — **контроль собівартості**, витрат на персонал і запаси.

## 6) Як почати користуватися (покроково)

1. **Укласти доступ.** Надати FnBright доступ до Syrve API (адреса сервера, API-ключ, перелік організацій/store).
2. **Налаштувати мапінг.** Визначити структуру мережі (місто → заклад → підрозділ), валюти, часові пояси.
3. **Обрати дашборди.** Увімкнути стандартні панелі або замовити унікальні (можемо додати під ваші KPI).
4. **Ініціальний імпорт.** Підтягнути історичні дані за домовлений період.
5. **Розклад оновлень.** Встановити частоту (наприклад, щогодини/щодобово) і «вікно» для нічних перерахунків.
6. **Доступи.** Створити ролі: власник, операційний менеджер, бухгалтер, керівник зміни; видати логіни.
7. **Навчання.** Короткий онбординг: фільтри, «ячейки» з деталізацією (drill-down), експорт/шари доступу.

> Типовий строк активації — **протягом дня** після отримання доступів. Контакти для підключення: **+38 (063) 514-82-56**, **smartcafe.com.ua**. Також дивіться [Демо за посиланням](https://app.powerbi.com/view?r=eyJrIjoiOGY4NzQ3MzUtZTcwOC00YjIyLWE4ZWUtMDNmMjZhYTJlMDE3IiwidCI6ImEyYTdkNzg3LTRjYWMtNGQyZi1hMDkzLTYyYWNjYjgzY2YzZCIsImMiOjZ9)

## 7) Щоденний сценарій роботи

- Відкрити **Загальний** дашборд → перевірити тренди/відхилення за вчора та за тиждень.
- Перейти в **Продажі** → подивитись години максимальної виручки й динаміку середнього чека.
- Відкрити **Персонал** → знайти працівників з високою часткою знижок/скасувань, запланувати коучинг.
- Відкрити **Меню** → відстежити лідерів/відстаючих і позиції з частими скасуваннями.
- Відкрити **Склад** → перевірити негативні залишки й необхідні закупівлі.

## 8) Поради з інтерпретації

- Дивіться **динаміку**, а не лише «зріз за день».
- Зіставляйте **знижки/скасування** з конкретними змінами та офіціантами.
- Перевіряйте **часові «ями»** — часто саме там губиться маржа.

## 9) Безпека та права доступу

- Інтеграція використовує **читання** OLAP-зрізів Syrve через API; операцій на запис не виконуємо.
- Доступ регулюється рольовою моделлю FnBright; з’єднання шифрується (HTTPS/TLS).
- Персональні дані відображаються лише в обсязі, необхідному для звітності.

## 10) Поширені питання

**Чи можна додати власні показники/дашборди?** Так, платформа підтримує кастомні панелі під ваші KPI.   
**Яка деталізація можлива?** До рівня чека, позиції, працівника, години — залежно від доступних OLAP-полів.   
**Чи працює для мережі з кількох міст?** Так; є фільтри за містом/закладом/підрозділом.

---

Готові зробити ресторан **ефективнішим**: підняти продуктивність, зменшити витрати і вирівняти якість. Якщо потрібен шаблон технічного підключення (які саме OLAP-звіти й поля державається з Syrve), надам із прикладами запитів і рекомендованим розкладом оновлень.