Учёт личных финансов часто ломается не из-за сложности, а из-за неудобства. Чтобы записать расход или доход, нужно открыть приложение, выбрать счёт и категорию, ввести сумму и дату.

Этот проект вырос из практической задачи: вести личные финансы при работе с разными валютами быстро и без постоянного переключения между приложениями. В результате был сделан финансовый Telegram-бот, где ввод происходит прямо в чате, а данные автоматически приводятся в структурированный вид.

Контекст и задача

Задача проекта — упростить учёт личных финансов без потери структуры и контроля над данными.

Важно было:

быстро добавлять записи
не зависеть от жёсткого формата ввода
автоматически определять дату, категорию и тип операции
работать с разными валютами
иметь наглядную сводку по данным

Проект изначально делался для личного использования, поэтому упор был на практичность и устойчивую работу.

Как устроено решение

Система состоит из двух частей:

Telegram-бот — для ввода данных
веб-интерфейс — для просмотра и анализа

Записи добавляются через Telegram, в интерфейсе данные просматриваются и сравниваются.

Ввод через Telegram

Telegram используется как основной интерфейс. Записи можно добавлять:

текстовыми сообщениями
голосовыми сообщениями
фотографиями (например, чеков)

AI-агент разбирает сообщение и определяет:

сумму
валюту
категорию
дату и время операции
тип операции (доход или расход)

После этого данные сохраняются в структурированном виде. Пользователю не нужно подстраиваться под формат или заполнять формы.

Обработка и логика

Вся логика обработки вынесена в автоматизированный процесс. Система:

обрабатывает входящие сообщения
работает с пользовательскими категориями
корректно учитывает дату операции
сохраняет и обновляет записи

AI используется как инструмент разбора ввода и нормализации данных, а не как финансовый советник или источник решений.

Аналитика и интерфейс

Для просмотра данных используется веб-интерфейс в формате Telegram Mini App. В интерфейсе доступны:

доходы и расходы за выбранный период
текущий баланс
распределение расходов по категориям
динамика по месяцам

Доступны фильтры:

по периоду
по валюте
по типу операций

Интерфейс рассчитан на мобильное использование и быстрый просмотр без лишних действий.

Безопасность и доступ

Доступ осуществляется через Telegram. Каждый запрос привязан к конкретному пользователю. Данные изолированы и недоступны другим. Отдельная регистрация не требуется.

Техническая основа и логика работы

Telegram — интерфейс ввода
n8n — оркестрация логики и обработка данных
AI — разбор сообщений и нормализация ввода
Next.js — веб-интерфейс и API для Telegram Mini App
React + TypeScript — клиентская часть интерфейса
Recharts — визуализация финансовых данных
PostgreSQL (Supabase) — хранение транзакций и пользовательских данных

Архитектура рассчитана на постоянное использование и расширение без переписывания логики.

Что в итоге

записи добавляются за несколько секунд
меньше ручных действий и ошибок
данные сразу готовы для просмотра
всё находится в одном месте — в Telegram
поддерживается учёт в нескольких валютах

AI здесь используется как инструмент упрощения ввода и обработки данных, а не как самостоятельный финансовый помощник.

Финансовый Telegram-бот