tg_bot_finance

       

Telegram Finance Tracker — бот для учёта личных финансов в Telegram. Он помогает добавлять доходы, расходы и переводы между кошельками, а данные сохраняются через Notion API.

Table of Contents

• About
• How it works
• Installation
• Tech Stack
• Project structure
• Authors

About

Проект сделан как Telegram-бот для удобного ведения личных финансов без отдельного приложения.

Пользователь подключает свой шаблон в Notion, после чего может:

• посмотреть баланс по кошелькам;
• добавить запись расхода;
• добавить запись дохода;
• добавить перевод между кошельками;
• обновить данные для подключения.

Бот ведёт пошаговые сценарии через FSM, а для хранения пользовательских данных использует PostgreSQL.

How it works

1. Подключение шаблона

Сначала бот помогает пользователю подключить шаблон в Notion и добавить данные для доступа.

2. Работа с финансами

После подключения можно:

• узнать баланс одного кошелька или всех сразу;
• записать расход с категорией и суммой;
• записать доход;
• записать перевод между счетами.

3. Сохранение данных

Сами финансовые записи создаются в Notion, а служебные данные пользователя хранятся в PostgreSQL.

Installation

Клонируйте репозиторий:

git clone https://github.com/Jlychee/tg_bot_finance.git
cd tg_bot_finance

Установите зависимости:

pip install -r requirements.txt

Подготовьте данные для запуска:

• добавьте Telegram Bot Token в конфиг;
• настройте подключение к PostgreSQL;
• убедитесь, что у вас есть шаблон в Notion для работы с ботом.

Запуск:

python run.py

Tech Stack

• Python
• aiogram
• Notion API
• PostgreSQL
• psycopg2
• FSM в aiogram

Project structure

• run.py — точка входа и запуск бота
• app/handlers.py — базовые команды и основные действия
• app/expense_FSM.py — сценарий добавления расходов
• app/income_FSM.py — сценарий добавления доходов
• app/transfer_FSM.py — сценарий переводов
• app/create_FSM.py — добавление данных пользователя
• app/update_FSM.py — обновление данных пользователя
• app/keyboards.py — inline-клавиатуры
• additional_features/notion_integration.py — работа с Notion API
• additional_features/db_working.py — работа с PostgreSQL
• img/ — изображения для инструкций

Authors

• Jlychee