Бот для учета расходов

Telegram бот для отслеживания личных расходов с категоризацией и аналитикой.

Структура проекта

├── main.py                 # Точка входа (для обратной совместимости)
├── core/                   # Основная логика бота
│   ├── __init__.py
│   └── bot.py             # Инициализация и запуск бота
├── models/                # Модели данных
│   ├── __init__.py
│   └── expense.py         # Модель расхода
├── services/              # Бизнес-логика
│   ├── __init__.py
│   └── expense_service.py # Сервисы для работы с расходами
├── handlers/              # Обработчики сообщений
│   ├── __init__.py
│   └── message.py         # Основные обработчики команд
├── config/                # Конфигурация
│   ├── __init__.py
│   └── bot_config.py      # Команды и категории бота
├── utils/                 # Вспомогательные утилиты
│   └── utils.py           # Утилитарные функции
├── db/                    # База данных
│   ├── __init__.py
└── scripts/               # Скрипты для развертывания

Архитектурные принципы

Разделение ответственности:

• models/ - только модели данных (ORM)
• services/ - бизнес-логика и операции с данными
• handlers/ - обработка пользовательского ввода
• config/ - настройки, команды, категории
• core/ - основная логика и координация компонентов

Запуск

python scripts/run.py
# или
python core/bot.py

Команды бота

• /start - Запуск бота
• /help - Помощь
• /add <категория> <сумма> <описание> - Добавить расход
• /dell<id> - Удалить расход
• /categories - Показать категории
• /today - Расходы за сегодня
• /month - Расходы за месяц
• /all - Все расходы
• /smonth - Сумма расходов за месяц
• /stoday - Сумма расходов за день

Категории

еда, личные, транспорт, здоровье, дом, подарки

Требования

• Python 3.8+
• aiogram
• tortoise-orm
• python-dotenv