📚 Інструкція з роботи з ботом PizzaDay Переоблік

Цей бот — ваш помічник для легкого обліку товарів та контролю термінів придатності на торговій точці. Він допоможе вам працювати швидше та уникнути помилок.

🚀 Як розпочати роботу (для Адміністратора)

Ці кроки потрібно виконати лише один раз для кожної торговельної точки.

1. Додайте бота до чату вашої торговельної точки:
   • Знайдіть бота за його іменем у Telegram.
   • Додайте його як учасника до групового чату, який ви використовуєте для роботи вашої торговельної точки.
   • Важливо: Оберіть саме той чат, де ви хочете отримувати звіти та сповіщення.
2. Надайте боту права адміністратора:
   • У налаштуваннях групи (натисніть на назву чату, потім "Керування групою" або "Адміністратори") знайдіть бота.
   • Надайте йому права адміністратора.
   • Обов'язково переконайтеся, що він має право на "Видалення повідомлень". Це дуже важливо, щоб бот міг прибирати службові повідомлення та не засмічувати чат.
3. Зареєструйте торговельну точку:
   • У цьому ж груповому чаті (куди ви додали бота) надішліть команду: /register_location
   • Бот попросить вас ввести назву точки. Напишіть її, наприклад: Піцерія на Центральній
   • Після цього бот підтвердить реєстрацію. Ваша торговельна точка готова до роботи!

📱 Щоденне використання (для Співробітників)

1. Відкрийте додаток бота:
   • Внизу екрана Telegram, поруч із полем введення повідомлення, ви побачите головну кнопку "Меню". Натисніть на неї.
   • З'явиться кнопка "Відкрити додаток". Натисніть її, щоб запустити веб-додаток бота.
   • Якщо у вас кілька точок, додаток запропонує обрати потрібну зі списку.
2. Розділи додатку:

   У додатку є 5 основних розділів для зручної роботи. Перемикатися між ними можна за допомогою кнопок у нижній частині екрана:

   • 🏠 Головна: Тут ви знайдете:
     • Інформацію про поточний колір губок та ганчірок (щоб знати, коли їх міняти).
     • Кнопки для виклику готових звітів (по кухні та продавцю).
   • 👨‍🍳 Кухар: Використовуйте цей розділ для внесення залишків по продуктах кухні (наприклад, м'ясні вироби, сири, овочі, соуси).
   • 💁‍♂️ Продавець: Використовуйте цей розділ для внесення залишків по бару та упаковці (наприклад, напої, морозиво, коробки, серветки).
   • 🗓️ Терміни: Це ваш калькулятор термінів придатності. Додавайте сюди продукти з датою відкриття, і додаток покаже, коли їх потрібно списати.
   • 🗄️ Архів: Тут ви можете переглянути всі збережені переобліки та, за наявності прав, видалити їх.
3. Як вносити дані (Кухар / Продавець):
   • Оберіть потрібний розділ (Кухар або Продавець).
   • Поруч із кожним продуктом є поле для введення кількості. Введіть поточний залишок.
   • Візуальний зворотний зв'язок:
     • Коли ви вводите кількість, поле із загальним залишком тимчасово підсвічується зеленим.
     • Щоб обнулити кількість продукту, натисніть на хрестик (✖️) поруч із ним. Бот попросить підтвердити дію, щоб уникнути випадкових видалень. При обнуленні поле тимчасово підсвічується червоним.
4. Збереження та очищення переобліку:
   • Після того, як ви внесли всі дані в розділі Кухар або Продавець, натисніть велику синю кнопку внизу: "Зберегти та очистити переоблік...".
   • Бот запитає підтвердження. Після підтвердження дані будуть збережені в архів, а форма очиститься для наступного переобліку.
5. Отримання звіту:
   • Щоб отримати файл із повним звітом, перейдіть на сторінку "🏠 Головна".
   • Натисніть "Звіт кухаря" або "Звіт продавця". Бот надішле готовий HTML-файл у ваш робочий чат.

❓ Вирішення проблем

• "Доступ заборонено" у додатку:

  Це означає, що вас видалили з робочої групи Telegram, або бот не може перевірити ваше членство.

  Рішення: Зверніться до адміністратора точки, щоб він додав вас назад до групи або перевірив права бота.

• Додаток не відкривається або показує помилку:
  • Переконайтеся, що у вас стабільне інтернет-з'єднання.
  • Спробуйте перезапустити додаток Telegram.
  • Якщо проблема зберігається, можливо, бот на сервері не працює. Рішення: Зверніться до адміністратора або розробника бота.
• Бот не відповідає на команди: Переконайтеся, що бот доданий до чату та має необхідні права. Спробуйте перезапустити його (/start).
• Сповіщення про терміни придатності не надходять: Переконайтеся, що бот запущений на сервері та не видає помилок у логах. Перевірте налаштування сповіщень у Telegram.

💬 Зворотний зв'язок

Якщо у вас є пропозиції щодо покращення бота або ви зіткнулися з помилками, використовуйте кнопку "Зворотній зв'язок" на головній сторінці додатка. Ваша думка дуже важлива!