Aiogram 3.x Starter Project

Чистая заготовка бота на Aiogram 3.x.
Конфиги и .env лежат в settings/.

Быстрый старт

1. Создать виртуальное окружение и установить зависимости:

   python -m venv .venv
   source .venv/bin/activate  # Windows: .venv\Scripts\activate
   pip install -r requirements.txt

2. Переименовать в папке settings файл .env.example в .env и указать токен:

   cp settings/.env.example settings/.env

3. Запустить бота командой:

   python main.py

---

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

settings/

Хранит конфигурацию проекта и .env с секретными данными.

• config.py — загрузка переменных окружения и объект settings.
• .env — рабочие настройки (токен, база и т.д.).
• .env.example — пример файла .env.

bot/

Основной код бота.

• routers.py — собирает все роутеры из пакета handlers и подключает их к Dispatcher.

bot/handlers/

Здесь лежат обработчики сообщений.

• start.py — команда /start.
• help.py — команда /help.
• echo.py — базовый echo-хэндлер (для теста).

bot/keyboards/

Заготовки клавиатур (reply/inline).

• common.py — пример «Да/Нет».

bot/middlewares/

Мидлвары (промежуточная логика).

• throttling.py — простейший антиспам (ограничение частоты сообщений).

bot/filters/

Кастомные фильтры для сообщений и апдейтов.

• is_admin.py — фильтр, проверяющий, что сообщение пришло от администратора.

bot/services/

Сервисы, не завязанные на Telegram напрямую.

• db.py — подключение к PostgreSQL через asyncpg (пул соединений).
• scheduler.py — планировщик задач (APScheduler).

bot/utils/

Вспомогательные утилиты.

• logging.py — настройка логирования.

---