FAQ / Документація
Коротко про те, як влаштована система Digital Menu Board і як нею користуватись.
Як влаштована система
1С — джерело правди про склад меню: назва, ціна, доступність (увімкнено/вимкнено), категорія. Ці дані приходять автоматично через конектор і не редагуються в адмінці.
Все, чого немає в 1С — опис, алергени, фото, грамаж, override назви страви чи категорії, порядок категорій, приховування — це "надбудова" (enrichment), яка живе окремо і не злітає при наступній синхронізації з 1С.
Дошка (board) на телевізорі читає готове об'єднане меню з публічного API раз на ~20 секунд і сама оновлюється — нічого вручну на телевізорі робити не треба.
Статуси локації
ONLINE — дані синхронізувались з 1С нещодавно (<30 сек), все добре.
WARNING — синхронізації давно не було (>30 сек), але останні дані ще є. Часто саме означає, що конектор/1С зараз "мовчить" — варто перевірити.
OFFLINE — синхронізації взагалі ще не було для цієї локації.
Це статус даних, а не статус фізичного екрана! Чи живий сам телевізор/kiosk-браузер — дивіться в розділі "Екрани" (там окремий ONLINE/OFFLINE за heartbeat самого екрана).
Розділи адмінки (по локації)
Меню — список усіх страв локації. Тут: приховати/показати окрему страву (чекбокс "Показувати"), додати опис/алергени/фото/грамаж/override назви, фільтр за назвою і категоріями. Категорія на дошці з'являється сама, щойно в ній є хоч одна страва з "Показувати" — ручного вимикача категорії більше нема. Значок ● біля назви категорії (панель зліва) — категорія зараз на дошці, ○ — нема видимих страв. Над таблицею страв — текстовий рядок "На дошці зараз: ...", щоб одразу бачити реальний стан без здогадок.
Порядок категорій — у якому порядку категорії йдуть на дошці. Три способи, усі зберігаються одразу: стрілками ▲▼, перетягуванням за ⠿ (миша, десктоп), або впишіть номер позиції в поле (якщо позиція вже зайнята — запитає підтвердження). Є пошук категорії зверху.
Екрани — які фізичні екрани (kiosk-браузери) виходили на зв'язок для цієї локації, коли востаннє, яка версія/роздільність/орієнтація.
Налаштування — код і назва локації, інтервал ротації сторінок дошки, показ копійок у ціні, тема (світла/темна), фонове фото дошки (посилання або завантаження файлу), логін/пароль конектора (1С) і опційна безпека екрана (додатковий логін/пароль поверх kiosk-посилання).
Вхід, реєстрація і заклади (tenant)
Три способи увійти: логін/пароль, кнопка "Увійти через Google" (якщо налаштовано; дозволено лише з довірених email-доменів — їх додає SUPER_ADMIN на сторінці "Довірені домени"), або самостійна реєстрація (посилання "Зареєструватися" на сторінці входу — логін і пароль обов'язкові, email опційний).
Якщо ви ще не прив'язані до жодного закладу — система запитає назву закладу/мережі (можна обрати наявний зі списку або створити новий). Власник закладу може додати вас і до іншого закладу (розділ "Користувачі" — там-таки можна одразу задати вам логін/пароль або скинути пароль пізніше) — один юзер може бути в кількох закладах одночасно. Якщо закладів у вас кілька — у шапці з'являється перемикач, і ви бачите локації того, що обрано ("Усі мої заклади" — все відразу). SUPER_ADMIN бачить і керує локаціями всіх закладів і може видаляти заклади (розділ "Користувачі", кнопка "Видалити заклад" — локації при цьому не видаляються, лише стають "нічийними").
Kiosk URL / посилання для телевізора
На головній сторінці (Локації) — кнопка "Copy kiosk URL". Це посилання містить секретний токен локації і його треба відкрити в браузері на самому екрані/медіаплеєрі (в kiosk-режимі, на весь екран). Токен — не логін-сесія: він просто "запечений" у посиланні один раз, тому втрата й відновлення інтернету на екрані ніколи не показує форму входу чи помилку авторизації.
Не публікуйте kiosk-посилання публічно — воно дає доступ до меню локації без пароля.
Часті питання
Змінив дані в меню, а на екрані старе. Зачекайте ~20-30 сек — дошка сама підтягує зміни. Якщо довше — перевірте статус локації (WARNING/OFFLINE) і чи не "заснув" сам браузер на екрані (розділ "Екрани").
Категорія не з'являється на дошці, хоч я її ввімкнув(ла). Категорія з'являється сама, лише якщо в ній є хоч одна страва з увімкненим "Показувати" — перевірте на сторінці "Меню" значок ●/○ біля назви категорії й рядок "На дошці зараз" зверху.
Перейменував категорію/страву, а після синхронізації з 1С назва повернулась стара. Такого не має статись — override зберігається окремо саме для того, щоб не злітати. Якщо все ж трапилось — створіть запит у підтримку.
Змінив код локації, а kiosk-посилання перестало працювати. Код входить у посилання дошки — після зміни коду треба заново скопіювати kiosk URL (на головній сторінці) і оновити його на екрані.
Архівував локацію по помилці. Розділ "Архівовані локації" на головній сторінці — кнопка "Відновити". Дані страв/налаштувань при архівації не видаляються.
Потрібна допомога?
Щось не так або не виходить, чи навпаки — усе працює, просто потрібна дія, яку сам адмін-панеллю не зробити (нова локація, наприклад, потребує налаштування конектора на стороні 1С/сервера). В обох випадках — service desk, туди ж:
🛠 Створити запит у підтримку — щось зламалось, працює не так, як очікували, чи просто питання.
➕ Запросити нову локацію — новий заклад/точка потребує окремих MENU_BOARD_ID/SECRET і підключення конектора на стороні 1С — це робить підтримка, самостійно в адмінці цього не налаштувати (тут можна лише створити саму локацію кнопкою "+ Нова локація" на головній сторінці — але без конектора вона не питиме дані з 1С).