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

max_bot/app/handlers/inquiry.py

@@ -1,3 +1,9 @@
+"""
+Обработчик заявок (inquiry).
+
+Создаёт BotTicket с контактными данными пользователя,
+отправляет уведомление на email, подтверждает пользователю.
+"""
 import datetime
 import logging
 from sqlalchemy import select
@@ -12,10 +18,12 @@ logger = logging.getLogger(__name__)
 MOSCOW_TZ = datetime.timezone(datetime.timedelta(hours=3))
 
 def moscow_now():
+    """Возвращает текущее время в UTC+3 (Москва) без tzinfo."""
     return datetime.datetime.now(MOSCOW_TZ).replace(tzinfo=None)
 
 
 async def handle_inquiry(user_id: int, conv_id: int, text: str) -> None:
+    """Обработка заявки: создаёт.ticket, отправляет email, подтверждает пользователю."""
     async with async_session() as db:
         result = await db.execute(
             select(BotConversation).where(BotConversation.id == conv_id)