v1.8.3: добавлены docstrings и комментарии по AGENTS.md ко всем ключевым файлам

max_bot/app/handlers/handoff.py

@@ -1,3 +1,8 @@
+"""
+Обработчик callback-кнопок и шаринга контактов.
+
+Маршрутизирует callback-и по типу (consent_* и др.).
+"""
 import datetime
 import logging
 from sqlalchemy import select
@@ -10,6 +15,7 @@ logger = logging.getLogger(__name__)
 
 
 async def handle_callback(user_id: int, callback_id: str, callback_data: dict) -> None:
+    """Маршрутизация callback-кнопок (consent_* → consent handler)."""
     async with async_session() as db:
         result = await db.execute(
             select(BotConversation)
@@ -40,6 +46,7 @@ async def handle_contact_share(
     vcf_data: dict = None,
     contact_hash: str = "",
 ) -> None:
+    """Обработка шаринга контакта из мессенджера: парсинг VCF, сохранение в BotUser."""
     if vcf_data is None:
         vcf_data = {}
     async with async_session() as db: