Цей темплейт використовується для розробки Telegram ботів з використанням бібліотеки aiogram v3.0+.

SQLAlchemy + Alembic

В коді є приклади таблички User з використанням SQLAlchemy 2.0, та скрипти для алембіку (ініціалізація алембік, створення та застосування міграцій).

Але, якщо ви з цими інструментами ніколи не працювали, то зверніться до документації і дізнайтесь про ці інструменти. Також, в мене є англомовний курс по цим інструментам на Udemy.

Для того, щоб почати використовувати:

1. Скопіюйте .env.dist в .env і заповніть необхідні дані.
2. Створіть нові хендлери.
3. Docker:
   1. Можете одразу запускати проєкт із Docker, а якщо в вас його немає, то завантажте, та встановіть.
   2. Запустіть проєкт з команди docker-compose up
4. Без Docker:
   1. Створіть venv
   2. Встановить залежності із requirements.txt: pip install -r requirements.txt --pre
   3. Запустіть проєкт з команди python3 bot.py

Як робити та реєструвати хендлери:

Створюєте модуль you_name.py у папці handlers.

Створюєте роутер у you_name.py.

from aiogram import Router
user_router = Router()

Можна робити декілька роутерів в одному модулі, та на кожний з них навішувати хендлери. Можна реєструвати хендлери декораторами:

@user_router.message(commands=["start"])
async def user_start(message):
    await message.reply("Вітаю, звичайний користувач!")

Заходимо у файл bot.py і додаємо всі роутери в нього:

from tgbot.handlers.admin import admin_router
from tgbot.handlers.echo import echo_router
from tgbot.handlers.user import user_router

...

async def main():
   
   ...

    for router in [
        admin_router,
        user_router,
        ...,
        echo_router,

    ]:
        dp.include_router(router)

Туторіали з aiogram v3

Відосів поки що немає, але @Groosha вже почав робити свій підручник.