Refactor project structure and enhance Docker support

- Removed unnecessary `__init__.py` and `Dockerfile` to streamline project organization.
- Updated `.dockerignore` and `.gitignore` to improve exclusion patterns for build artifacts and environment files.
- Enhanced `Makefile` with new commands for managing Docker containers and added help documentation.
- Introduced `pyproject.toml` for better project metadata management and dependency tracking.
- Updated `requirements.txt` to reflect changes in dependencies for metrics and monitoring.
- Refactored various handler files to improve code organization and maintainability.

helper_bot/utils/helper_func.py

@@ -3,6 +3,7 @@ import os
 import random
 from datetime import datetime, timedelta
 from time import sleep
+from typing import List, Dict, Any, Optional
 
 try:
     import emoji as _emoji_lib
@@ -14,6 +15,14 @@ from aiogram.types import InputMediaPhoto, FSInputFile, InputMediaVideo, InputMe
 from helper_bot.utils.base_dependency_factory import BaseDependencyFactory, get_global_instance
 from logs.custom_logger import logger
 
+# Local imports - metrics
+from .metrics import (
+    metrics, 
+    track_time, 
+    track_errors, 
+    db_query_time
+)
+
 bdf = get_global_instance()
 BotDB = bdf.get_db()
 GROUP_FOR_LOGS = bdf.settings['Telegram']['group_for_logs']
@@ -43,6 +52,8 @@ def safe_html_escape(text: str) -> str:
     return html.escape(str(text))
 
 
+@track_time("get_first_name", "helper_func")
+@track_errors("helper_func", "get_first_name")
 def get_first_name(message: types.Message) -> str:
     """
     Безопасно получает и экранирует имя пользователя для использования в HTML разметке.
@@ -234,7 +245,7 @@ async def add_in_db_media(sent_message, bot_db):
 
 
 async def send_media_group_message_to_private_chat(chat_id: int, message: types.Message,
-                                                   media_group: list[InputMediaPhoto], bot_db):
+                                                   media_group: List, bot_db):
     sent_message = await message.bot.send_media_group(
         chat_id=chat_id,
         media=media_group,
@@ -245,7 +256,7 @@ async def send_media_group_message_to_private_chat(chat_id: int, message: types.
     return message_id
 
 
-async def send_media_group_to_channel(bot, chat_id: int, post_content: list[tuple[str]], post_text: str):
+async def send_media_group_to_channel(bot, chat_id: int, post_content: List, post_text: str):
     """
     Отправляет медиа-группу с подписью к последнему файлу.
 
@@ -458,6 +469,9 @@ def delete_user_blacklist(user_id: int, bot_db):
     return bot_db.delete_user_blacklist(user_id=user_id)
 
 
+@track_time("check_username_and_full_name", "helper_func")
+@track_errors("helper_func", "check_username_and_full_name")
+@db_query_time("get_username_and_full_name", "users", "select")
 def check_username_and_full_name(user_id: int, username: str, full_name: str, bot_db):
     username_db, full_name_db = bot_db.get_username_and_full_name(user_id=user_id)
     return username != username_db or full_name != full_name_db
@@ -479,6 +493,8 @@ def unban_notifier(self):
     self.bot.send_message(self.GROUP_FOR_MESSAGE, message)
 
 
+@track_time("update_user_info", "helper_func")
+@track_errors("helper_func", "update_user_info")
 async def update_user_info(source: str, message: types.Message):
     # Собираем данные
     full_name = message.from_user.full_name
@@ -495,10 +511,12 @@ async def update_user_info(source: str, message: types.Message):
     if not BotDB.user_exists(user_id):
         BotDB.add_new_user_in_db(user_id, first_name, full_name, username, is_bot, language_code, user_emoji, date,
                                  date)
+        metrics.record_db_query("add_new_user_in_db", 0.0, "users", "insert")
     else:
         is_need_update = check_username_and_full_name(user_id, username, full_name, BotDB)
         if is_need_update:
             BotDB.update_username_and_full_name(user_id, username, full_name)
+            metrics.record_db_query("update_username_and_full_name", 0.0, "users", "update")
             if source != 'voice':
                 await message.answer(
                     f"Давно не виделись! Вижу что ты изменился;) Теперь буду звать тебя: {full_name}")
@@ -506,17 +524,25 @@ async def update_user_info(source: str, message: types.Message):
                                            text=f'Для пользователя: {user_id} обновлены данные в БД.\nНовое имя: {full_name}\nНовый ник:{username}. Новый эмодзи:{user_emoji}')
         sleep(1)
     BotDB.update_date_for_user(date, user_id)
+    metrics.record_db_query("update_date_for_user", 0.0, "users", "update")
 
 
+@track_time("check_user_emoji", "helper_func")
+@track_errors("helper_func", "check_user_emoji")
+@db_query_time("check_emoji_for_user", "users", "select")
 def check_user_emoji(message: types.Message):
     user_id = message.from_user.id
     user_emoji = BotDB.check_emoji_for_user(user_id=user_id)
     if user_emoji is None or user_emoji in ("Смайл еще не определен", "Эмоджи не определен", ""):
         user_emoji = get_random_emoji()
         BotDB.update_emoji_for_user(user_id=user_id, emoji=user_emoji)
+        metrics.record_db_query("update_emoji_for_user", 0.0, "users", "update")
     return user_emoji
 
 
+@track_time("get_random_emoji", "helper_func")
+@track_errors("helper_func", "get_random_emoji")
+@db_query_time("check_emoji", "users", "select")
 def get_random_emoji():
     attempts = 0
     while attempts < 100: