Як користуватися Simkassa

1. Перший запуск

Відкрийте @simkassa_bot у приватному чаті, натисніть Start або надішліть /start. Окремо реєструватися й створювати пароль не потрібно: Simkassa перевіряє ваш профіль через Telegram.

Під час першого входу створюється особиста сім’я. Її назву, початковий баланс, мову та тему можна змінити в Mini App.

• Кнопка «Відкрити бюджет» запускає Mini App.
• Кнопка «Інструкція» або команда /help відкриває цю сторінку до початку роботи.
• Підтримуються українська, російська та англійська мови, світла й темна теми.

2. Що можна робити в кнопковому боті

Бот підходить для швидкого внесення даних без відкриття Mini App. Кнопками «Додати витрату» та «Додати дохід» виберіть збережену або запропоновану категорію, введіть суму та перевірте операцію перед збереженням.

• Створюйте власну категорію повідомленням, наприклад «🍕 Кафе».
• Надішліть голосове повідомлення на кшталт «Витратив 50 гривень на каву»: бот розпізнає тип, суму й категорію та попросить підтвердження.
• Керуйте щоденними нагадуваннями кнопкою або командою /reminders — доступно до п’яти часів у часовому поясі Europe/Kyiv.
• Переглядайте сімейні ліміти командою /limits; власник може створювати й видаляти їх.
• Змінюйте мову командою /language, скасовуйте незавершене введення командою /cancel.

3. Огляд і операції в Mini App

На екрані «Огляд» показано загальний баланс, доходи, витрати, останні операції, активні ліміти та корисні розділи. Баланс дорівнює початковому балансу плюс доходи мінус витрати.

Через «Додати операцію» можна вибрати дохід або витрату, дату, категорію, суму та коментар. Учасник змінює й видаляє власні операції, а власник сім’ї може керувати всіма операціями своєї сім’ї.

• Стандартна підказка стає сімейною категорією після першого збереження.
• Власні категорії мають назву та значок і доступні всій сім’ї.
• Перед остаточним видаленням операції Mini App показує підтвердження.

4. Додавання витрати з QR-коду чека

У формі нової витрати натисніть «Сканувати QR» або виберіть фото чи скриншот. Підтримуваний український фіскальний QR автоматично заповнює суму й дату; вам залишається вибрати категорію та зберегти операцію.

Зображення розпізнається на пристрої й не надсилається на сервер. Повний QR не зберігається; для захисту від дубля використовується лише його цифровий відбиток усередині сім’ї.

5. Історія та статистика

У «Історії» доступні всі операції сім’ї з фільтрами за датами, типом і учасником. Після фільтрації окремо перераховуються доходи та витрати.

У «Статистиці» можна аналізувати всю сім’ю або одного учасника за останні 7 днів, 6 тижнів чи 6 місяців. Стовпчики порівнюють доходи й витрати, а лінія показує зміну балансу або накопичений внесок обраного учасника.

6. Сім’я, учасники та запрошення

Кнопка 👥 відкриває учасників сім’ї. Власник може запросити людину за Telegram username, якщо вона вже відкривала Mini App, або створити універсальне посилання для будь-якого Telegram-чату. Адресне запрошення з’являється у вхідних за кнопкою ✉️; якщо адресат раніше відкривав чат із ботом, бот також надсилає повідомлення.

Запрошення діє 7 днів. Кожен користувач може належати лише до однієї сім’ї.

• Якщо звичайний учасник переходить в іншу сім’ю, його старі операції залишаються у попередній сім’ї без прив’язки до нього.
• Якщо власник переходить і в сім’ї є інші учасники, спочатку потрібно вибрати нового власника.
• Якщо власник єдиний у сім’ї, перед переходом буде попередження: стара сім’я, її баланс, категорії та операції видаляються після явного підтвердження.
• Власник може видалити учасника; видаленому користувачеві створюється нова особиста сім’я.

7. Ліміти витрат і нагадування

Ліміт задається для категорії на суму й період від 1 до 365 днів. Він спільний для сім’ї та враховує витрати всіх учасників. Якщо нова або змінена витрата перевищує активний ліміт, Simkassa не збереже її та покаже витрачену суму, залишок і дату завершення.

Нагадування належать конкретному користувачеві. У вибраний час бот надсилає кнопки швидкого додавання доходу, витрати та відкриття Mini App. Кожне нагадування надсилається не більше одного разу на день.

8. Налаштування, звернення та безпека

Шестерня ⚙️ відкриває назву сім’ї, початковий баланс, мову та тему. Назву й баланс змінює лише власник. Розділ «Скарги та пропозиції» надсилає повідомлення команді Simkassa разом із вашим Telegram-профілем і поточною сім’єю.

Simkassa не є банком, не підключається до банківських рахунків, не зберігає реквізити карток і не виконує платежі. Користувач отримує доступ лише до даних своєї поточної сім’ї.

• Якщо кнопки не оновилися, повністю закрийте Mini App і відкрийте його з нового меню бота.
• Якщо бот не може надіслати адресне запрошення, адресат усе одно побачить його в Mini App; для повідомлень у чаті він має хоча б раз відкрити бота.
• Якщо введення в боті перервалося після його перезапуску, почніть операцію заново — вже збережені дані не втрачаються.