docs: додати нетехнічний посібник власника для адмін-панелі

Покроковий посібник простою мовою для власника кафе/персоналу без
технічного бекграунду: замовлення, меню, промокоди, відгуки, склад,
постачальники, налаштування, персонал, резервні копії — за реальними
кнопками й пунктами меню з коду bober_bbq/admin/*.py та шаблонів.

docs/ПОСІБНИК_ВЛАСНИКА.md

@@ -0,0 +1,373 @@
+# Посібник власника — адмін-панель Bober BBQ
+
+Цей посібник — для власника кафе та персоналу, які щодня користуються адмін-панеллю (сайт, куди ви заходите через браузер за адресою на кшталт `https://ваш-домен/admin`). Він не вимагає технічних знань. Все, що стосується серверів, коду, змінних середовища чи SSH — не тут: там, де потрібен розробник, так і написано.
+
+## Зміст
+
+1. [Вхід і ролі користувачів](#1-вхід-і-ролі-користувачів)
+2. [Дашборд — що ви бачите одразу після входу](#2-дашборд)
+3. [Замовлення](#3-замовлення)
+4. [Меню: категорії та товари](#4-меню-категорії-та-товари)
+5. [Промокоди](#5-промокоди)
+6. [Відгуки клієнтів](#6-відгуки-клієнтів)
+7. [Клієнти (користувачі)](#7-клієнти-користувачі)
+8. [Розсилка повідомлень у Telegram](#8-розсилка-повідомлень-у-telegram)
+9. [Статистика](#9-статистика)
+10. [Склад (облік сировини)](#10-склад-облік-сировини)
+11. [Постачальники](#11-постачальники)
+12. [Telegram-чати для сповіщень про замовлення](#12-telegram-чати-для-сповіщень-про-замовлення)
+13. [Налаштування закладу](#13-налаштування-закладу)
+14. [Якщо оплата карткою «зависла»](#14-якщо-оплата-карткою-зависла)
+15. [Адміністратори (доступи персоналу)](#15-адміністратори-доступи-персоналу)
+16. [Резервні копії бази даних](#16-резервні-копії-бази-даних)
+17. [Журнал дій](#17-журнал-дій)
+18. [Статус системи та технічні проблеми](#18-статус-системи-та-технічні-проблеми)
+19. [Коли звертатись до розробника, а не діяти самому](#19-коли-звертатись-до-розробника-а-не-діяти-самому)
+
+---
+
+## 1. Вхід і ролі користувачів
+
+1. Відкрийте адресу адмін-панелі у браузері, введіть **логін** і **пароль**, натисніть кнопку входу.
+2. Якщо кілька разів поспіль ввести пароль неправильно — вхід тимчасово заблокується на кілька хвилин (захист від підбору пароля). Це нормально, просто зачекайте вказаний час.
+3. Ліворуч — бічне меню з розділами. Угорі праворуч — дзвіночок 🔔 із кількістю нових замовлень (оновлюється сама кожні ~20 секунд і видає звуковий сигнал, коли з'являється нове замовлення) та ваш профіль (логін і роль).
+4. Внизу бічного меню — поточний графік роботи закладу і статус «● Працюємо» / «● Зачинено».
+
+**Дві ролі:**
+
+- **Адміністратор** — повний доступ до всього: меню, замовлень, клієнтів, промокодів, розсилки, статистики, відгуків, налаштувань, адміністраторів, резервних копій, журналу дій, статусу системи, і до постачальників (за замовчуванням).
+- **Менеджер** — бачить і працює лише з: Замовленнями, Клієнтами, Статистикою, Telegram-чатами та переглядом меню (без права редагувати). Не бачить у меню й не може відкрити: Налаштування, Адміністраторів, Резервні копії, Журнал дій, Статус системи, Промокоди, Розсилку. Доступ до розділу «Постачальники» менеджеру можна додатково увімкнути в Налаштуваннях (див. розділ 13).
+
+---
+
+## 2. Дашборд
+
+Головна сторінка після входу. Тут одним поглядом видно:
+
+- Кількість замовлень сьогодні/вчора за типами (Доставка, Самовивіз, У закладі), виручку, середній чек — і зміну у відсотках порівняно з учора.
+- Кругову діаграму статусів замовлень за сьогодні.
+- Топ-5 товарів, які найбільше продавались сьогодні.
+- Фінанси за сьогодні: скільки картою, скільки готівкою.
+- Останні 8 замовлень.
+- Короткий блок з рейтингом (середня оцінка й останні відгуки) — детальніше в розділі «Відгуки».
+- Позначки, чи підключені Telegram-чати для сповіщень про доставку/самовивіз/замовлення в закладі.
+
+---
+
+## 3. Замовлення
+
+### 3.1. Як прийти нове замовлення й обробити його
+
+1. Коли клієнт робить замовлення через Telegram-бот або Mini App, воно автоматично надходить: (а) у відповідний Telegram-чат персоналу (Доставка / Самовивіз / У закладі — див. розділ 12), і (б) з'являється в адмін-панелі зі статусом **«Нове»**. Дзвіночок 🔔 угорі показує лічильник і видає звук.
+2. Натисніть на дзвіночок або відкрийте **«Всі замовлення»** (чи розділи «Доставка» / «Самовивіз» / «У закладі» в меню) — знайдіть замовлення й натисніть **«Відкрити»** (або клікніть по рядку).
+3. На сторінці замовлення ви побачите: тип, клієнта, телефон, адресу/час прибуття/столик (залежно від типу), спосіб і статус оплати, список товарів, суму, а зверху — візуальний прогрес-індикатор етапів.
+
+### 3.2. Як змінити статус замовлення
+
+На сторінці замовлення, у блоці **«Дії із замовленням»**, є кнопки з наступним(и) можливим(и) статусом(ами) — система сама пропонує лише логічні наступні кроки:
+
+- «Нове» → **«Підтверджено»** або **«Скасувати»**
+- «Підтверджено» → **«Готується»** або «Скасувати»
+- «Готується» → **«Готове»** або «Скасувати»
+- «Готове» → **«Передано кур'єру»** (лише для доставки), **«Виконано»** або «Скасувати»
+- «Передано кур'єру» → **«Виконано»** або «Скасувати»
+
+Натискання кнопки статусу одразу зберігає зміну й (якщо увімкнено в Налаштуваннях) надсилає клієнту повідомлення в Telegram про зміну статусу.
+
+Якщо статус став кінцевим («Виконано» або «Скасовано») — кнопок дій більше немає.
+
+**Скасування замовлення:** натисніть кнопку **«Скасувати»**, впишіть причину (необов'язково, але бажано — наприклад «клієнт відмовився») і натисніть **«Підтвердити скасування»**. Якщо ввімкнено облік сировини — списані для цього замовлення інгредієнти автоматично повернуться на склад.
+
+Є ще запасний спосіб — блок **«Ручна зміна статусу»** внизу сторінки: оберіть будь-який статус зі списку і натисніть **«Оновити статус»» (працює без обмежень на «логічну послідовність», для нетипових ситуацій).
+
+### 3.3. Як позначити замовлення оплаченим готівкою
+
+Для замовлень з оплатою готівкою, ще не позначених оплаченими, на сторінці замовлення (і прямо в списку замовлень) є кнопка **«💵 Позначити оплаченим»** / **«💵 Оплачено»**. Натисніть її, коли отримали гроші від кур'єра/клієнта. Якщо у закладі увімкнена фіскалізація (Checkbox) — після цього автоматично почне формуватись фіскальний чек (з'явиться на сторінці замовлення за кілька секунд).
+
+Оплата карткою через Monobank позначається оплаченою автоматично системою — вручну це чіпати не потрібно (див. розділ 14, якщо оплата зависла).
+
+### 3.4. Як створити замовлення вручну (дзвінок, за столиком, тощо)
+
+Для замовлень, які клієнт зробив НЕ через Telegram-бот (подзвонив, прийшов особисто) — щоб вони теж потрапили в статистику й автоматично списали сировину зі складу:
+
+1. У меню ліворуч натисніть **«➕ Нове замовлення»**.
+2. Оберіть **тип замовлення** (Доставка / Самовивіз / У закладі) — поля форми зміняться відповідно (адреса для доставки, час прибуття для самовивозу, номер столика для «У закладі»).
+3. Вкажіть ім'я й телефон клієнта (необов'язково).
+4. У блоці **«Товари»** оберіть товар і кількість, натисніть **«+ Додати товар»** для наступних позицій.
+5. Оберіть **спосіб оплати** (Готівка/Картка), чи вже **оплачено**, і **початковий статус** замовлення.
+6. Натисніть **«Створити замовлення»**.
+
+### 3.5. Як відредагувати вже створене замовлення (лише для ролі «Адміністратор»)
+
+На сторінці замовлення натисніть **«✏️ Редагувати замовлення»**. Можна змінити тип, дані клієнта/адресу, склад товарів, додати **персональну знижку** (сума й причина), спосіб і статус оплати. Суму доставки/знижку самовивозу система порахує заново сама за поточними налаштуваннями. Статус виконання («Готується», «Виконано» тощо) тут не редагується — це робиться окремо на сторінці замовлення (розділ 3.2).
+
+### 3.6. Фіскальний чек (Checkbox)
+
+Якщо в Налаштуваннях увімкнена фіскалізація через Checkbox — при позначенні оплаченим (готівка) або оплаті карткою чек формується автоматично у фоні (з'являється на сторінці замовлення за кілька секунд, у полі «Фіскальний чек»). Якщо сталася помилка формування — на сторінці замовлення зʼявиться кнопка **«🧾 Повторити фіскалізацію»**.
+
+### 3.7. Видалення замовлення назавжди (лише «Адміністратор»)
+
+У блоці **«Небезпечна зона»** внизу сторінки замовлення — кнопка **«🗑 Видалити замовлення назавжди»** (з підтвердженням). На відміну від скасування, замовлення повністю зникає зі списків і статистики. Списану сировину буде повернуто на склад автоматично. Якщо по замовленню вже сформовано фіскальний чек — видалення тут **не** скасовує сам чек у Checkbox/податковій, це лише прибирає запис із вашої бази.
+
+---
+
+## 4. Меню: категорії та товари
+
+### 4.1. Категорії
+
+Розділ **«Категорії»** у меню.
+
+1. Щоб **додати категорію**: внизу сторінки введіть назву в поле «Додати категорію» і натисніть **«Додати»**.
+2. Щоб **перейменувати** або **зробити категорію активною/неактивною** (сховати з меню клієнта): відредагуйте назву й прапорець «активна» прямо в рядку таблиці, натисніть **«Зберегти»**.
+3. Порядок відображення категорій у меню клієнта змінюється стрілками **↑ / ↓** у першому стовпці.
+4. **«Видалити»** — видаляє категорію разом з усіма товарами в ній (запитає підтвердження).
+
+### 4.2. Товари (страви)
+
+Розділ **«Товари»** у меню; можна фільтрувати за категорією.
+
+1. **«➕ Додати товар»** (кнопка на сторінці списку товарів, або пункт «Новий товар»): оберіть категорію, введіть назву, опис, вагу/обʼєм, ціну, за бажанням завантажте фото, позначте **алергени** (галочками — покажуться клієнту іконками на картці страви), вкажіть порядок сортування, позначте «Активний», щоб товар показувався в меню. Натисніть **«Зберегти»**.
+2. Щоб **відредагувати** товар — відкрийте його зі списку товарів, змініть потрібні поля, **«Зберегти»**.
+3. Щоб **тимчасово прибрати страву з меню**, не видаляючи її — у списку товарів скористайтесь кнопкою перемикання активності (показано/приховано) біля товару.
+4. **«Видалити»** товар — видаляє його остаточно.
+5. Якщо в закладі увімкнено облік сировини (розділ 10), на сторінці редагування товару зʼявиться кнопка **«🧾 Рецептура (склад страви)»** — там вказується, скільки якого інгредієнта йде на одну порцію, щоб склад списувався автоматично при кожному замовленні.
+
+---
+
+## 5. Промокоди
+
+Розділ **«Промокоди»** (лише для ролі «Адміністратор»).
+
+1. Щоб **створити промокод**: у блоці «Новий промокод» введіть код (літерами, автоматично у верхньому регістрі), відсоток знижки (1–100%), за бажанням — мінімальну суму замовлення, ліміт кількості використань, дату закінчення дії та прапорець «Лише для першого замовлення клієнта». Натисніть **«Створити промокод»**.
+2. У таблиці промокодів видно, скільки разів кожен вже використали.
+3. **«Вимкнути» / «Увімкнути»** — тимчасово зупиняє дію промокоду без видалення.
+4. **«Видалити»** — прибирає промокод остаточно.
+
+---
+
+## 6. Відгуки клієнтів
+
+Розділ **«Відгуки»** (лічильник ⭐, доступний усім ролям).
+
+Тут показано середню оцінку, розподіл оцінок 1-5 зірок і список усіх оцінених замовлень з датою, номером, клієнтом і оцінкою. Можна фільтрувати за конкретною кількістю зірок кнопками нагорі («Усі», «5 ⭐», «4 ⭐» тощо). Клік по рядку відкриває саме замовлення. Клієнти отримують запит на оцінку (кнопки 1-5) автоматично після статусу «Виконано» — цю функцію можна вимкнути в Налаштуваннях (розділ 13).
+
+---
+
+## 7. Клієнти (користувачі)
+
+Розділ **«Користувачі»**. Список усіх клієнтів, які писали в Telegram-бот: ім'я, username, кількість замовлень, загальна сума покупок, дата першого й останнього замовлення. Клік по клієнту (або кнопка **«Відкрити»**) відкриває картку клієнта з повною історією його замовлень і середнім чеком.
+
+---
+
+## 8. Розсилка повідомлень у Telegram
+
+Розділ **«Розсилка»** (лише «Адміністратор»). Введіть текст повідомлення в поле і натисніть кнопку відправки — повідомлення піде всім клієнтам, які коли-небудь писали боту. Зверху видно, скільки всього отримувачів. Після відправки покаже, скільки надіслано успішно і скільки не вдалося.
+
+Використовуйте обережно — розсилка йде одразу всім, скасувати вже відправлене повідомлення неможливо.
+
+---
+
+## 9. Статистика
+
+Розділ **«Статистика»**. Оберіть період (Сьогодні / Вчора / Тиждень / Місяць / Довільний період з конкретними датами). Показує: кількість замовлень, виручку, середній чек, розподіл за типами доставки, скільки оплачено карткою/готівкою, кількість унікальних клієнтів і скільки з них — повторні, топ-10 товарів за кількістю продажів, графік виручки по днях. Скасовані замовлення в цю статистику не входять.
+
+---
+
+## 10. Склад (облік сировини)
+
+Розділ зʼявляється в меню лише якщо в Налаштуваннях увімкнено **«📦 Увімкнути облік сировини»** (розділ 13). Коли увімкнено — кожне замовлення автоматично списує потрібну кількість інгредієнтів за рецептурою страви; скасування замовлення повертає списане назад.
+
+### 10.1. Додати/налаштувати інгредієнт
+
+Розділ **«Склад»**:
+
+1. Внизу сторінки, у блоці **«➕ Додати новий інгредієнт»**: вкажіть назву, одиницю виміру (г/кг/мл/л/шт), початковий залишок, мінімальний залишок (нижче цього система сама сформує заявку на поповнення), «до скількох поповнювати» (орієнтир, скільки закуповувати), за бажанням — вартість за одиницю й основного постачальника. **«Додати інгредієнт»**.
+2. Клік по інгредієнту в таблиці відкриває його картку, де є блок **«⚙️ Налаштування»** для редагування тих самих полів, прапорець «Активний» (чи враховувати в рецептах і списанні) і кнопка **«🗑 Видалити інгредієнт»** (видаляє повністю, з усіх рецептів і історії).
+
+### 10.2. Прив'язати інгредієнт до постачальника
+
+На картці інгредієнта (Склад → клік по назві) у блоці **«⚙️ Налаштування»** є поле **«Основний постачальник»** — оберіть зі списку і натисніть **«Зберегти зміни»**. Це визначає, до чиєї відомості потраплятимуть поставки цього інгредієнта, і хто зазначений як «Постачальник» на сторінці інгредієнта.
+
+### 10.3. Коригування залишків (списання/поповнення)
+
+На картці інгредієнта, блок **«➕➖ Прихід / списання»**:
+
+1. Оберіть **«Тип операції»**:
+   - **«🚚 Поставка від «Постачальник»»** (з'являється, якщо у інгредієнта вже вказано постачальника) — реальна поставка: вкажіть кількість, ціну за одиницю (необов'язково), № накладної, скільки оплачено. Ця операція одразу і поповнює склад, і додає запис у відомість постачальника (так само, якби ви внесли поставку з картки постачальника).
+   - **«⚖️ Ручне коригування (+/-)»** — для інвентаризації (виявили розбіжність факту з обліком).
+   - **«🗑 Списання (втрати/псування)»** — зіпсувався товар, розбили тощо.
+2. Для «Ручного коригування»/«Списання» оберіть **напрямок** (⬆️ Поповнення / ⬇️ Списання) і кількість, за бажанням додайте примітку.
+3. Натисніть **«Застосувати»**.
+
+Уся історія цих операцій зберігається нижче на картці інгредієнта, у блоці **«📜 Історія рухів»**, із зазначенням дати, зміни кількості, причини та хто це зробив.
+
+### 10.4. Рецептура страв
+
+Розділ **«Склад» → «🧾 Рецептура страв (що з чого готується)»** (або кнопка на сторінці редагування товару). Оберіть страву зі списку, вкажіть, які інгредієнти й у якій кількості йдуть на одну порцію, **«Склад страви збережено»**. Це і є основа автоматичного списання складу при кожному продажу цієї страви.
+
+### 10.5. Заявки на поповнення (коли щось закінчується)
+
+Коли залишок інгредієнта опускається нижче встановленого мінімуму, система сама формує заявку — про це буде видно жовтим попередженням на сторінці «Склад» і лічильником біля пункту меню «Склад». Розділ **«🛒 Заявки на поповнення»**:
+
+1. Заявка показує потрібні інгредієнти, згруповані за постачальником (щоб було зрозуміло, кому телефонувати).
+2. Коли товар привезли — впишіть у полі **«Отримано»** реальну отриману кількість (за замовчуванням підставлена потрібна кількість) і натисніть **«Зарахувати поставку»**. Залишки на складі й сама заявка оновляться автоматично; якщо якийсь інгредієнт задоволено не повністю — заявка залишиться відкритою для нього.
+3. Внизу — історія вже закритих заявок.
+
+### 10.6. Звіти по складу (Excel/PDF)
+
+На сторінці **«Склад»**:
+
+- **«📥 Поточний стан складу»** — знімок залишків, мінімумів і вартості складу на зараз. Кнопки **«📊 Excel»** / **«📄 PDF»**.
+- **«📥 Історія руху складу»** — рухи (поповнення/списання) за обраний період (поля «З дати» / «По дату», можна не заповнювати — тоді за весь час). Кнопки **«📊 Excel»** / **«📄 PDF»**.
+
+На картці окремого інгредієнта є аналогічний блок **«📥 Скачати історію»** — та сама історія рухів, але тільки по цьому інгредієнту.
+
+---
+
+## 11. Постачальники
+
+Розділ **«Постачальники»** видно адміністраторам завжди; менеджерам — тільки якщо в Налаштуваннях увімкнено доступ (розділ 13, там же й видно борги — тому обмежено за замовчуванням).
+
+### 11.1. Додати постачальника
+
+**«Постачальники» → «Додати постачальника»** (форма нового постачальника): назва, ЄДРПОУ/ІПН, телефон, контактна особа, примітка. Зберегти.
+
+### 11.2. Внести поставку (одну чи кілька позицій одразу)
+
+На картці постачальника, блок **«Додати поставку вручну»**:
+
+1. Заповніть спільні поля: № накладної/рахунку (необов'язково), дата поставки, скільки оплачено всього (розподілиться між товарами нижче пропорційно їхній сумі), дата й спосіб оплати (Готівка/Безготівково).
+2. У блоці **«Товари»** для кожної позиції вкажіть назву товару, артикул (необов'язково), одиницю виміру, кількість, ціну за одиницю **або** одразу суму (система порахує друге сама). За бажанням прив'яжіть позицію до конкретного інгредієнта складу («Прив'язати до інгредієнта складу»).
+3. Кнопка **«+ Додати ще товар»** додає ще один рядок — так одна накладна з кількома позиціями вноситься за один раз.
+4. Якщо ввімкнено облік сировини, зʼявиться прапорець **«📦 Для товарів з прив'язкою до інгредієнта — одразу зарахувати кількість на склад»** — позначте, якщо хочете, щоб склад поповнився цією поставкою одразу.
+5. **«Додати поставку»**.
+
+Записи поставок відображаються в таблиці на тій же сторінці; кожен можна відредагувати (олівець ✏️) або видалити (✕) — видалення запису **не** повертає раніше зарахований на склад товар автоматично.
+
+### 11.3. Імпорт поставок з Excel/CSV
+
+З картки постачальника (**«📊 Імпорт з Excel»**) або з окремого пункту імпорту:
+
+1. Завантажте файл (.xlsx, .xls, .csv) кнопкою **«Завантажити й перевірити»**.
+2. Оберіть лист файлу (якщо їх кілька) і рядок, де знаходяться заголовки колонок; система покаже попередній перегляд.
+3. Для кожного поля (назва товару, кількість, ціна, сума тощо) оберіть, яка колонка файлу йому відповідає.
+4. За бажанням увімкніть **«📦 ... одразу зарахувати на склад»** для товарів, назви яких точно збігаються з назвою інгредієнта.
+5. **«Імпортувати»**. Система сама пропускає порожні/підсумкові рядки та вже раніше імпортовані накладні (щоб не задублювати той самий файл двічі).
+
+### 11.4. Скільки винні постачальнику (відомість, Excel/PDF)
+
+На картці постачальника вгорі видно три цифри: **«Поставлено всього»**, **«Оплачено»**, **«Борг»**. Блок **«📥 Скачати відомість»**: за бажанням вкажіть діапазон дат («З дати» / «По дату»), натисніть **«📊 Excel»** або **«📄 PDF»** — завантажиться файл з детальною відомістю по цьому постачальнику.
+
+Для зведеного звіту по **всіх** постачальниках одразу (борги перед кожним) — на сторінці списку **«Постачальники»** є аналогічна форма зведеного звіту з тими самими кнопками Excel/PDF.
+
+### 11.5. Активація / деактивація / видалення постачальника
+
+На картці постачальника, блок **«Небезпечна зона»** (адміністратор і, для деактивації, менеджер із доступом): **«✅ Активувати» / «🚫 Деактивувати»** — ховає неактивного постачальника зі звичайного списку, але лишає всю історію поставок і боргів. **«🗑 Видалити повністю»** (лише «Адміністратор») — стирає постачальника й усю історію його поставок назавжди, без можливості відновити.
+
+---
+
+## 12. Telegram-чати для сповіщень про замовлення
+
+Розділ **«Telegram-чати»**. Тут видно для кожного типу замовлень (Доставка / Самовивіз / У закладі): чи підключено чат, який Chat ID, скільки замовлень туди вже надіслано. Кнопка **«🔄 Перевірити підключення»** біля кожного типу перевіряє, чи бот справді має доступ до вказаного чату.
+
+Сам Chat ID змінюється не тут, а в **«Налаштування»** (поля «Chat ID — Доставка/Самовивіз/У закладі», розділ 13). Щоб дізнатись Chat ID групи — перешліть будь-яке повідомлення з потрібного чату боту-помічнику (наприклад @userinfobot), і не забудьте додати основного бота закладу в цю групу як адміністратора. Якщо чат «У закладі» не вказано — сповіщення про такі замовлення йдуть власнику напряму.
+
+---
+
+## 13. Налаштування закладу
+
+Розділ **«Налаштування»** (лише «Адміністратор»). Все зберігається однією кнопкою **«Зберегти»** внизу форми.
+
+**Заклад:**
+- Логотип (завантаження файлу зображення), назва, телефон, адреса.
+- Графік роботи «з» / «до» і прапорець «Приймати замовлення поза графіком».
+- **«🚧 Тимчасово закрито»** — на відміну від звичайного графіку (де клієнт все ще бачить меню поза годинами), цей перемикач одразу показує клієнту в Mini App повноекранну заглушку замість меню й кошика — для екстрених випадків (аварія, немає персоналу тощо). Можна додати пояснювальний текст для клієнтів. **Не забудьте вимкнути після відновлення роботи.**
+- **«📢 Показати оголошення клієнтам»** — спливаюче вікно з текстом у Mini App (не блокує застосунок, клієнт може закрити).
+- Посилання на Instagram і Google Maps.
+
+**Вигляд:** колір адмін-панелі й колір застосунку для клієнтів (Mini App) — обирається одним кольором, відтінки підбираються самі.
+
+**Доставка та самовивіз:** вартість доставки, поріг безкоштовної доставки, мінімальна сума замовлення на доставку, відсоток знижки на самовивіз.
+
+**Telegram-чати для замовлень:** Chat ID для Доставки / Самовивозу / У закладі (див. розділ 12).
+
+**Сповіщення клієнтів:** автоматично повідомляти клієнта в Telegram при зміні статусу замовлення; запитувати оцінку (1-5) після статусу «Виконано».
+
+**Облік сировини:** прапорець **«📦 Увімкнути облік сировини»** — вмикає розділ «Склад» (розділ 10). Вимкнення не видаляє вже накопичені дані складу — просто зупиняє автосписання.
+
+**🚚 Постачальники:** прапорець **«Дозволити менеджерам доступ до розділу «Постачальники»»** — там видно суми поставок і борги, тому за замовчуванням лише адміністратор. Видалення постачальника завжди лишається тільки для адміністратора незалежно від цього перемикача.
+
+**Оплата карткою (Monobank):** тестовий режим (платежі не списуються — не забудьте вимкнути перед стартом реальних продажів, система нагадує про це червоним попередженням, поки тестовий режим увімкнено), бойовий і тестовий токени еквайрингу (з кнопкою **«Перевірити»** біля кожного), опис платежу, показаний клієнту, і прапорець «Показувати список товарів на сторінці оплати».
+
+**🧾 Фіскалізація (ПРРО Checkbox):** увімкнення автоматичної фіскалізації, логін/пароль касира й ліцензійний ключ (видаються в кабінеті Checkbox), надсилати чек клієнту в Telegram, автоматичне закриття зміни каси щодня (з обраним часом — за законом зміна ПРРО не може лишатись відкритою довше 24 годин). Кнопки **«🔌 Перевірити підключення»** і **«🔒 Закрити зміну зараз»**.
+
+---
+
+## 14. Якщо оплата карткою «зависла»
+
+Якщо клієнт каже, що оплатив карткою, а замовлення в адмін-панелі досі показує «Не оплачено» (або оплата явно не пройшла):
+
+1. Відкрийте замовлення й перевірте поле **«Оплата»** на сторінці замовлення — можливо, платіж уже зарахувався і просто не встиг оновитись, оновіть сторінку.
+2. Якщо клієнт підтвердив, що гроші з картки списались (є SMS/виписка з банку), а замовлення все ще не оплачене — зайдіть в **«✏️ Редагувати замовлення»** (лише роль «Адміністратор») і вручну переставте **«Оплата»** на **«Оплачено»**, збережіть.
+3. Якщо клієнт каже, що оплата не пройшла і гроші не списались — просто залиште замовлення «Не оплачено» і домовтесь про оплату готівкою при отриманні, або скасуйте замовлення кнопкою «Скасувати» з причиною (наприклад «оплата не пройшла»).
+4. Якщо таке трапляється регулярно (не поодинокий випадок) — перевірте в **Налаштуваннях**, чи не увімкнено випадково «Тестовий режим оплати» (тоді платежі системно не списуються — це не помилка, а очікувана поведінка тестового режиму), і скористайтесь кнопкою **«Перевірити»** біля бойового токена Monobank.
+5. Якщо токен «Перевірити» показує помилку, або проблема не зникає після цих кроків — це вже питання до розробника чи безпосередньо до підтримки Monobank (можливо, проблема на стороні банку або токен застарів).
+
+---
+
+## 15. Адміністратори (доступи персоналу)
+
+Розділ **«Адміністратори»** (лише «Адміністратор»).
+
+1. **«Додати адміністратора»**: вкажіть логін, пароль і роль — **«Адміністратор — повний доступ»** або **«Менеджер — замовлення, клієнти, оплати, Telegram»**. **«Додати»**.
+2. **«Скинути пароль»** — генерує новий випадковий пароль і показує його один раз на екрані (запишіть одразу, повторно побачити не можна).
+3. **«Видалити»** — видаляє обліковий запис співробітника (не можна видалити самого себе, і в системі завжди має лишатись хоча б один адміністратор).
+
+Пояснення обмежень ролі «Менеджер» наведено прямо на цій сторінці внизу.
+
+---
+
+## 16. Резервні копії бази даних
+
+Розділ **«Резервні копії»** (лише «Адміністратор»). Доступно, якщо база даних — SQLite (типове налаштування для невеликого закладу); для PostgreSQL автоматичне копіювання з цієї сторінки не працює — зверніться до розробника щодо резервного копіювання на сервері.
+
+1. **«☁️ Створити резервну копію зараз»** — робить миттєвий знімок бази прямо зараз.
+2. Кожен запис у списку копій має кнопки: **«Завантажити»** (зберегти файл собі на компʼютер), **«Відновити»** (повернути базу до стану цієї копії — запитає ввести слово **ВІДНОВИТИ** для підтвердження; перед відновленням автоматично створюється копія поточного стану на випадок помилки), **«Видалити»** (видалити файл копії, незворотньо).
+3. **Автоматичні резервні копії в Google Drive** — окремий блок нижче: увімкніть прапорець, вставте ключ сервісного акаунта Google (JSON) і ID папки Google Drive, вкажіть, як часто робити копії і скільки зберігати. Покрокова інструкція, як отримати цей ключ, розгорнута прямо на сторінці («Як налаштувати (крок за кроком)»). Кнопки **«🔌 Перевірити підключення»** і **«☁️ Backup зараз»**.
+
+**Порада:** робіть резервну копію (кнопку «Створити резервну копію зараз» або через Google Drive) перед будь-якими масовими змінами — імпортом великого файлу постачальника, очищенням бази тощо.
+
+---
+
+## 17. Журнал дій
+
+Розділ **«Журнал дій»** (лише «Адміністратор», лише перегляд). Показує останні 300 дій персоналу в адмінці: хто, що і коли зробив (створення замовлень, зміни статусів, редагування меню, зміни налаштувань, дії з постачальниками тощо). Корисно, щоб розібратись, хто і коли щось змінив.
+
+---
+
+## 18. Статус системи та технічні проблеми
+
+Розділ **«Статус системи»** (лише «Адміністратор»).
+
+- Перелік перевірок («База даних», «Telegram Bot Token», «Web App URL», «monobank», Telegram-чати) — зелений кружечок означає, що все працює.
+- Інформація про систему: версія, тип бази даних, її розмір, кількість замовлень і товарів.
+- Останні рядки журналів помилок (якщо доступні на сервері) — сюди можна заглянути перед тим, як писати розробнику, щоб описати проблему точніше.
+- **«⚠️ Небезпечна зона» → «🗑 Очистити базу даних»** — видаляє **всі замовлення, кошики та клієнтів** (товари, категорії, налаштування й адміністраторів не чіпає). Перед видаленням автоматично створюється резервна копія. Вимагає ввести слово **ОЧИСТИТИ** для підтвердження. Використовуйте лише свідомо (наприклад, щоб почати з чистого аркуша перед реальним стартом продажів після тестування) — дію не можна скасувати без відновлення з резервної копії.
+
+---
+
+## 19. Коли звертатись до розробника, а не діяти самому
+
+Ці ситуації виходять за межі того, що можна безпечно виправити з адмін-панелі — краще одразу написати розробнику:
+
+- «Помилка 500», білий екран, сайт адмінки взагалі не відкривається.
+- Потрібно змінити домен, SSL-сертифікат, або перенести систему на інший сервер.
+- Потрібно змінити BOT_TOKEN бота, підключити нового бота, чи щось у файлі налаштувань сервера (`.env`).
+- База даних — не SQLite, а PostgreSQL, і потрібне регулярне резервне копіювання (`pg_dump`) — це налаштовується розробником на сервері, а не через кнопку «Резервні копії».
+- Помилка при спробі відновити базу з резервної копії («Відновити») не зникає, або після відновлення дані не оновились навіть після повідомлення про необхідність перезапуску сервісу.
+- Токен Monobank чи Checkbox не проходить перевірку, попри правильно введені дані — і клієнти скаржаться на оплату регулярно (а не поодиноко).
+- Потрібно змінити саму структуру меню/сайту (не текст чи товари, а зовнішній вигляд, нові розділи, нову функціональність).
+- Журнал помилок (розділ «Статус системи») показує технічні повідомлення, незрозумілі персоналу.
+- Будь-яка підозра, що дані було втрачено або пошкоджено не через власну дію (наприклад, після оновлення системи розробником).
+
+Для всіх інших щоденних завдань — замовлення, меню, склад, постачальники, промокоди, персонал, базові налаштування закладу — цей посібник охоплює все, що реально є в адмін-панелі.