Архитектура

app/
├── bot.py              # Настройка бота, диспетчер, middleware
├── config.py           # Settings (pydantic-settings), загрузка из .env
├── handlers/           # Обработчики сообщений/callback
│   ├── admin/          # Админ-панель (30+ модулей)
│   ├── balance.py      # Обработчики пополнения баланса
│   ├── subscription/   # Покупка и управление подписками
│   └── ...
├── services/           # Бизнес-логика
│   └── payment/        # Адаптеры платёжных систем
├── external/           # Клиенты внешних API
├── database/
│   ├── models.py       # SQLAlchemy модели
│   ├── crud/           # CRUD операции
│   └── database.py     # Управление сессиями
├── webapi/             # FastAPI REST API (админка)
│   ├── routes/         # API эндпоинты
│   └── schemas/        # Pydantic схемы
├── middlewares/        # aiogram middleware
└── utils/              # Утилиты

from aiogram import Router

def register_handlers(router: Router):
    router.callback_query.register(handler_func, SomeFilter())

async with get_session() as session:
    result = await session.execute(select(User).where(...))

from app.config import settings

if settings.YOOKASSA_ENABLED:
    # ...