Третья часть: сделаны обработчики команд

BotCode/routers/commands/user_cmd/__init__.py

@@ -0,0 +1,19 @@
+# BotCode/routers/commands/user_cmd/__init__.py
+# Инициализация модуля user_cmd, для пользовательских команд бота
+
+# Экспортирование модулей во внешние слои проекта
+from aiogram import Router
+from .start_cmd import start_cmd
+from .help_cmd import help_cmd
+
+# Объявление роутера и настройка экспорта модулей
+__all__ = ("router",)
+router = Router(name="user_cmd_router")
+
+
+# Список подключаемых роутеров сверху-вниз
+router.include_routers(
+    help_cmd.router,
+)
+
+router.include_routers(start_cmd.router)

BotCode/routers/commands/user_cmd/help_cmd.py

@@ -0,0 +1,12 @@
+# BotCode/routers/commands/user_cmd/help_cmd.py
+# Работа с командой /help, для вывода помощи пользователю
+
+from .user_cmd_class import CommandHandler
+
+# Создание команды /help с нужными параметрами
+help_cmd = CommandHandler(
+    name="help",
+    description="Получить помощь",
+    keywords=["help", "info", "помощь", "инфо", "информация", "рудз", "штащ", "byaj", "gjvjom", "byajhvfwbz"],
+    text_msg="Привет! Это команда помощи. Тут ты можешь узнать, как пользоваться ботом.",
+)

BotCode/routers/commands/user_cmd/start_cmd.py

@@ -0,0 +1,13 @@
+# BotCode/routers/commands/user_cmd/start_cmd.py
+# # Работа с командой /start, для запуска бота
+
+from .user_cmd_class import CommandHandler
+
+# Создание команды /start с нужными параметрами
+start_cmd = CommandHandler(
+    name="start",
+    description="Запустить бота",
+    keywords=["start", "старт", "запуск", "пуск", "on", "вкл", "с", "s", "ы",
+              "ыефке", "cnfhn", "pfgecr", "gecr", "щт", "drk", "restart", "куыефке"],
+    text_msg="Старт!",
+)

BotCode/routers/commands/user_cmd/user_cmd_class.py

@@ -0,0 +1,51 @@
+# BotCode/routers/commands/user_cmd_class.py
+# Класс-шаблон для создания новых команд
+
+from aiogram import Router, types
+from aiogram.filters import Command
+from BotLibrary import *
+
+# Класс-шаблон для команд
+class CommandHandler:
+    def __init__(self, name: str, description: str,
+                 keywords: list, text_msg: str,
+                 keyboard=None, prefix = BotVar.prefix,
+                 ignore_case = True,
+                 ):
+        """
+        Универсальный обработчик команд для бота.
+
+        :param name: Имя команды (например, "help").
+        :param description: Описание команды.
+        :param keywords: Список ключевых слов, которые активируют команду.
+        :param text_msg: Текст сообщения, который отправляется пользователю.
+        :param keyboard: Клавиатура, если требуется.
+        """
+        self.router = Router(name=f"{name}_router")
+        self.name = name
+        self.log_type = name.capitalize()
+        self.description = description
+        self.keywords = keywords
+        self.text_msg = text_msg
+        self.keyboard = keyboard
+
+        # Привязываем хэндлер к роутеру
+        self.router.message(
+            Command(*keywords, prefix=prefix, ignore_case=ignore_case)
+        )(self.handler)
+        self.router.message(F.text.lower().in_(keywords))(self.handler)
+
+
+    async def handler(self, message: types.Message):
+        """Основной хэндлер команды."""
+        user = f"@{message.from_user.username or message.from_user.id}"
+        try:
+            logger.bind(log_type=self.name.capitalize(), user=user).info(f"использовал(а) команду /{self.name}")
+            await message.reply(
+                text=self.text_msg,
+                reply_markup=self.keyboard() if self.keyboard else None,
+            )
+
+        # Проверка на ошибку
+        except Exception as e:
+            logger.bind(log_type=self.name.capitalize(), user=user).error(f"Ошибка команды: {e}")