Как пользоваться 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; для сообщений в чате он должен хотя бы один раз открыть бота.
• Если ввод в боте прервался после его перезапуска, начните операцию заново — уже сохранённые данные не потеряются.