Руководство пользователя Telegram-бота "ТратаБот"

1. Введение

Приветствуем в "ТратаБот"! Этот Telegram-бот разработан, чтобы стать вашим надежным и удобным помощником в управлении личными финансами. Его основная задача — сделать учет расходов максимально простым и быстрым, помогая вам видеть полную картину ваших трат и эффективно планировать бюджет.

Назначение бота: Помочь вам легко записывать каждую трату, анализировать, куда уходят ваши деньги, и контролировать свой бюджет, чтобы достигать финансовых целей.
Для кого предназначен: Бот идеально подходит для всех пользователей Telegram, кто хочет взять под контроль свои личные или семейные финансы, от новичков в учете до тех, кто ищет удобный мобильный инструмент без установки лишних приложений.

2. Начало работы

Начать пользоваться ботом очень просто:

Откройте Telegram.
В строке поиска введите @ТратаБот (@TrataBot_bot)
Выберите бота из результатов поиска.
Нажмите кнопку "Запустить" или отправьте команду /start.

Бот поприветствует вас и, скорее всего, покажет главное меню с доступными функциями.

3. Основные функции и команды

"ТратаБот" предлагает ряд команд и функций, доступных как через ввод команд, так и через удобные кнопки в интерфейсе Telegram.

3.1. Добавление расхода

Самая частая операция. Бот проведет вас через простой диалог для фиксации траты.

Команда: /add
Как использовать: Отправьте команду /add или нажмите кнопку "➕ Добавить расход" в меню. Бот начнет диалог:

Сначала он попросит ввести сумму расхода (например, 550.75 или 1200).
Затем предложит выбрать категорию из списка ваших категорий с помощью кнопок.
Наконец, спросит, хотите ли вы добавить описание (комментарий) к этой трате. Вы можете ввести текст или отказаться.

Примеры:

Вызвать /add, ввести 350, выбрать "Транспорт", отказаться от описания.
Вызвать /add, ввести 1500.50, выбрать "Продукты", ввести описание "Поход в супермаркет".

Важность: Регулярное и точное внесение суммы и категории — основа качественного учета. Описание поможет вспомнить детали траты позже.

3.2. Просмотр истории расходов

Быстрый способ увидеть последние внесенные траты.

Команда: /history
Как использовать: Отправьте команду /history или нажмите кнопку "📖 История расходов".
Результат: Бот покажет список ваших последних 10 расходов с указанием даты, времени, категории, суммы и описания (если есть).

3.3. Получение статистики трат

Анализируйте свои расходы за разные периоды.

Команда: /stats
Как использовать: Отправьте команду /stats или нажмите кнопку "📊 Статистика".
Результат: Бот предоставит суммарную статистику расходов по категориям за:

Сегодня
Текущую неделю (с понедельника)
Текущий месяц (с 1-го числа) Вы увидите, сколько было потрачено по каждой категории в выбранном периоде, и общую сумму за этот период.

3.4. Управление категориями расходов

Настройте категории так, как удобно вам.

Команда: /categories
Как использовать: Отправьте команду /categories или нажмите кнопку "📁 Управление категориями".
Результат: Бот покажет список ваших категорий. Системные категории (например, "👑") и пользовательские (например, "👤") могут быть помечены по-разному.

Просмотр: Вы видите все свои категории.
Добавление новой: Нажмите кнопку "✨ Добавить категорию". Бот попросит ввести название для новой категории. Оно должно быть уникальным среди ваших категорий.
Удаление категории: Рядом с каждой пользовательской категорией (не системной) есть кнопка "🗑️ Удалить". Нажмите ее, и бот попросит подтвердить удаление.Важно: При удалении категории безвозвратно удаляются все связанные с ней расходы и установленные бюджетные лимиты для этой категории.

3.5. Установка и изменение месячных лимитов

Контролируйте траты по отдельным категориям в течение месяца.

Доступ: Через кнопку "💰 Управление бюджетом" в главном меню (или меню /categories).
Как использовать: Нажмите кнопку "💰 Управление бюджетом". Бот покажет список установленных лимитов на текущий месяц.

Нажмите "➕ Установить/Изменить бюджет".
Бот попросит выбрать категорию, для которой хотите установить или изменить лимит.
Затем введите сумму месячного лимита для этой категории.

Изменение лимита: Если вы установите лимит для категории, у которой он уже был, новый лимит заменит старый.
Снятие лимита: Установка лимита 0 (нуль) для категории снимает месячный лимит.

3.6. Редактирование расходов

Исправляйте ошибки или уточняйте детали прошлых трат.

Команда: /edit
Как использовать: Отправьте команду /edit или нажмите кнопку "✏️ Редактировать/Удалить".
Результат: Бот покажет список ваших последних 15 расходов. Каждый расход будет иметь кнопки.

Нажмите на кнопку с самим расходом, чтобы выбрать его для редактирования. Бот покажет детали этого расхода и предложит выбрать, какое поле изменить: "💰 Сумма", "🏷️ Категория", "📝 Описание".
Выберите поле, и бот попросит ввести новое значение. Следуйте инструкциям бота.
После успешного изменения, бот подтвердит это.

3.7. Удаление расходов

Удаляйте лишние или ошибочные записи.

Доступ: Через процесс редактирования/удаления (/edit).
Как использовать: Вы можете удалить расход двумя способами после вызова команды /edit:

Быстрое удаление: В списке последних 15 расходов рядом с каждым есть кнопка "🗑️". Нажмите ее, и бот попросит подтвердить удаление выбранного расхода.
Удаление после выбора: После того как вы выбрали расход для редактирования, среди опций изменения будет также кнопка "🗑️ Удалить расход". Нажмите ее, и бот также запросит подтверждение.

Результат: После подтверждения расход будет безвозвратно удален из вашей истории.

3.8. Предупреждения о превышении лимитов

Бот следит за вашим бюджетом за вас.

Когда срабатывает: Бот автоматически проверяет бюджет после того, как вы добавили новый расход или отредактировали существующий, изменив его сумму или категорию.
Логика: Если после внесения изменения общая сумма ваших расходов по данной категории за текущий месяц превысила установленный для нее месячный лимит, бот немедленно отправит вам предупреждение.
Сообщение: Вы получите сообщение вида: "⚠️ Внимание! Вы превысили месячный бюджет по категории [Название категории]!", с указанием вашей текущей суммы трат по этой категории за месяц и размера лимита. Это ваш сигнал к действию или пересмотру планов!

4. Советы по эффективному использованию

Чтобы "ТратаБот" принес максимальную пользу:

Вносите расходы сразу: Приучите себя записывать траты сразу после их совершения. Это займет всего несколько секунд через бота, но позволит избежать забытых записей.
Используйте осмысленные категории: Создайте категории, которые отражают вашу реальную структуру расходов. Это поможет получать более точную и полезную статистику.
Регулярно просматривайте статистику: Используйте команду /stats хотя бы раз в неделю, чтобы видеть, куда уходят деньги и отслеживать прогресс по бюджетным лимитам.
Устанавливайте бюджетные лимиты: Начните с самых "проблемных" или крупных категорий. Лимиты — мощный инструмент самоконтроля.
Анализируйте и корректируйте: Используйте статистику не просто для информации, но для принятия решений. Видите, что тратите слишком много на развлечения? Возможно, стоит скорректировать планы на следующий месяц.

5. Обратная связь и поддержка

Если у вас возникли вопросы, предложения по улучшению или вы обнаружили ошибку в работе бота, пожалуйста, свяжитесь с разработчиком. Информация для связи может быть доступна при первом запуске бота (/start) или в его описании в Telegram.

(Дополнительно) Хранение данных и Приватность

Ваши финансовые данные очень чувствительны. "ТратаБот" разработан с учетом этого:

Все ваши записи о расходах, категориях и бюджетах хранятся в локальной базе данных SQLite на сервере, где развернут бот.
Ваши данные не отправляются в сторонние облачные сервисы.

Структура данных в базе выглядит следующим образом:

-- Категории расходов для каждого пользователя
CREATE TABLE IF NOT EXISTS categories (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    chat_id INTEGER NOT NULL, -- Идентификатор пользователя в Telegram
    name TEXT NOT NULL,       -- Название категории
    is_default INTEGER NOT NULL DEFAULT 0, -- 1 для системных, 0 для пользовательских
    UNIQUE (chat_id, name)    -- Названия категорий уникальны для пользователя
);

-- Каждая отдельная запись о расходе
CREATE TABLE IF NOT EXISTS expenses (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    chat_id INTEGER NOT NULL, -- Идентификатор пользователя
    amount REAL NOT NULL,     -- Сумма
    category_id INTEGER NOT NULL, -- Ссылка на категорию
    expense_date TEXT NOT NULL, -- Дата и время траты
    description TEXT NULL,    -- Описание
    FOREIGN KEY (category_id) REFERENCES categories(id) ON DELETE CASCADE -- При удалении категории удаляются связанные расходы
);

-- Установленные бюджетные лимиты по категориям и периодам (месяцам)
CREATE TABLE IF NOT EXISTS budgets (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    chat_id INTEGER NOT NULL, -- Идентификатор пользователя
    category_id INTEGER NOT NULL, -- Ссылка на категорию
    limit_amount REAL NOT NULL, -- Сумма лимита
    period TEXT NOT NULL,     -- Период (например, 'YYYY-MM')
    FOREIGN KEY (category_id) REFERENCES categories(id) ON DELETE CASCADE, -- При удалении категории удаляются связанные бюджеты
    UNIQUE (chat_id, category_id, period) -- Уникальный лимит на категорию в период для пользователя
);

Это обеспечивает целостность и сохранность ваших данных в рамках работы бота.

Надеемся, это руководство поможет вам освоить "ТратаБот" и эффективно управлять своими финансами!