Шаблон Telegram-бота на Aiogram 3

📚 Описание

Это полнофункциональный шаблон Telegram-бота на aiogram 3.x (текущая версия в requirements — 3.24.0). Включает админ‑панель, интеграцию оплаты, поддержку БД и модульную архитектуру для масштабируемой разработки.

🚀 Возможности

• Админ‑панель: управление пользователями, рассылками и админ‑задачами.
• Оплата: поддержка YooKassa (опционально).
• Напоминания: планирование и отправка напоминаний.
• Профили пользователей: хранение данных в базе.
• FSM‑состояния: удобное управление состояниями диалога.
• Конфигурация окружения: хранение секретов в .env.

🛠️ Установка

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

   git clone https://github.com/mlt-melt/aiogram3BotTemplate.git
   cd aiogram3BotTemplate

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

   pip install -r storage/requirements.txt

3. Создайте файл .env в storage/ и добавьте токены бота и (опционально) YooKassa.

4. Заполните storage/config.py: укажите URL бота и список ID администраторов.

5. Запустите бота:

   python bot.py

📄 Конфигурация

Настройки находятся в .env и storage/config.py.

Пример .env:

BOT_TOKEN=tg_bot_token
YOOKASSA_SHOP_ID=your_shop_id
YOOKASSA_SECRET_TOKEN=your_secret_token

💻 Использование

• Запуск: python bot.py
• Команды админ‑панели: /admin
• Обработчики и команды находятся в handlers/

🧠 Технологии

• Python
• Aiogram 3.x
• SQLite
• YooKassa API

📊 База данных

• Используется SQLite база db.db для данных пользователей и сессий.

👤 Автор

Melt
GitHub Profile

📜 Лицензия

Проект распространяется по лицензии MIT.