🤖 Бот для учёта доходов и расходов с хранением данных в Google Таблицах. Поддержка кастомных категорий, FSM-сценарии, динамические клавиатуры.
- Добавление трат с выбором даты, категории, подкатегории и суммы
- Автоматическое обновление сумм при повторном выборе категории
- Поддержка дробных чисел (разделитель — точка)
- Добавление приходов с указанием даты и суммы
- Автоматический расчёт дельты
- Создание собственных категорий расходов
- Динамическое обновление reply-клавиатуры
- Расходы за сегодня
- Расходы за текущий месяц
- Форматирование валюты (рубли с группировкой разрядов)
- У каждого пользователя отдельная Google Таблица
- Автоматическая выдача доступа (роль
writer) - Ограничение на количество пользователей
| Компонент | Технология |
|---|---|
| Язык | Python 3.10+ |
| Фреймворк бота | aiogram 3 (FSM) |
| Работа с таблицами | gspread |
| Аутентификация Google | Service Account (JSON) |
| Форматирование | locale (ru_RU.UTF-8) |
| Управление окружением | python-dotenv |
| Клавиатуры | ReplyKeyboardBuilder |
Telegramm_Bot_GoogleSheets/ ├── main.py # Точка входа, запуск бота ├── hendler/ │ └── user_private.py # Все хендлеры и FSM состояния ├── kbds/ │ └── reply.py # Генератор reply-клавиатур ├── table/ │ └── table.py # Работа с Google Sheets (gspread) ├── requirements.txt └── README.md
git clone https://github.com/ваш-логин/finance-bot.git cd finance-bot
python -m venv venv source venv/bin/activate # Linux/macOS venv\Scripts\activate # Windows
pip install -r requirements.txt
cp .env.example .env
python main.py