smart-bot-factory 0.3.5__py3-none-any.whl → 0.3.7__py3-none-any.whl

smart_bot_factory/core/bot_utils.py

@@ -255,6 +255,10 @@ async def process_events(session_id: str, events: list, user_id: int) -> bool:
                         # if session_id:
                         #     check_query = check_query.eq('session_id', session_id)
                         
+                        # 🆕 Фильтруем по bot_id если указан
+                        if supabase_client.bot_id:
+                            check_query = check_query.eq('bot_id', supabase_client.bot_id)
+                        
                         existing = check_query.execute()
                         
                         logger.info(f"   🔍 Проверка БД: найдено {len(existing.data) if existing.data else 0} выполненных событий '{event_type}' для user_id={user_id}")
@@ -271,6 +275,13 @@ async def process_events(session_id: str, events: list, user_id: int) -> bool:
                         # Выполняем событие
                         result = await execute_event_handler(event_type, user_id, event_info)
                         
+                        # Проверяем наличие поля 'info' для дашборда
+                        import json
+                        info_dashboard_json = None
+                        if isinstance(result, dict) and 'info' in result:
+                            info_dashboard_json = json.dumps(result['info'], ensure_ascii=False)
+                            logger.info(f"   📊 Дашборд данные добавлены: {result['info'].get('title', 'N/A')}")
+                        
                         # Сохраняем в БД УЖЕ со статусом completed (избегаем дублирования)
                         event_record = {
                             'event_type': event_type,
@@ -281,8 +292,14 @@ async def process_events(session_id: str, events: list, user_id: int) -> bool:
                             'status': 'completed',  # Сразу completed!
                             'session_id': session_id,
                             'executed_at': __import__('datetime').datetime.now(__import__('datetime').timezone.utc).isoformat(),
-                            'result_data': __import__('json').dumps(result, ensure_ascii=False) if result else None
+                            'result_data': __import__('json').dumps(result, ensure_ascii=False) if result else None,
+                            'info_dashboard': info_dashboard_json  # Добавится только если есть поле 'info'
                         }
+                        
+                        # 🆕 Добавляем bot_id если указан
+                        if supabase_client.bot_id:
+                            event_record['bot_id'] = supabase_client.bot_id
+                        
                         response = supabase_client.client.table('scheduled_events').insert(event_record).execute()
                         event_id = response.data[0]['id']
                         
@@ -303,6 +320,11 @@ async def process_events(session_id: str, events: list, user_id: int) -> bool:
                             'session_id': session_id,
                             'last_error': str(e)
                         }
+                        
+                        # 🆕 Добавляем bot_id если указан
+                        if supabase_client.bot_id:
+                            event_record['bot_id'] = supabase_client.bot_id
+                        
                         supabase_client.client.table('scheduled_events').insert(event_record).execute()
                         raise
                 

smart_bot_factory/core/decorators.py

@@ -1135,6 +1135,10 @@ async def save_immediate_event(
         'session_id': session_id
     }
     
+    # 🆕 Добавляем bot_id если указан
+    if supabase_client.bot_id:
+        event_record['bot_id'] = supabase_client.bot_id
+    
     try:
         response = supabase_client.client.table('scheduled_events').insert(event_record).execute()
         event_id = response.data[0]['id']
@@ -1187,6 +1191,10 @@ async def save_scheduled_task(
         'session_id': session_id
     }
     
+    # 🆕 Добавляем bot_id если указан
+    if supabase_client.bot_id:
+        event_record['bot_id'] = supabase_client.bot_id
+    
     try:
         response = supabase_client.client.table('scheduled_events').insert(event_record).execute()
         event_id = response.data[0]['id']
@@ -1241,6 +1249,10 @@ async def save_global_event(
         'status': status
     }
     
+    # 🆕 Добавляем bot_id если указан (глобальные события тоже привязаны к боту)
+    if supabase_client.bot_id:
+        event_record['bot_id'] = supabase_client.bot_id
+    
     try:
         response = supabase_client.client.table('scheduled_events').insert(event_record).execute()
         event_id = response.data[0]['id']
@@ -1271,6 +1283,11 @@ async def update_event_result(
     if result_data:
         import json
         update_data['result_data'] = json.dumps(result_data, ensure_ascii=False)
+        
+        # Проверяем наличие поля 'info' для дашборда
+        if isinstance(result_data, dict) and 'info' in result_data:
+            update_data['info_dashboard'] = json.dumps(result_data['info'], ensure_ascii=False)
+            logger.info(f"📊 Дашборд данные добавлены в событие {event_id}")
     
     if error_message:
         update_data['last_error'] = error_message
@@ -1298,13 +1315,18 @@ async def get_pending_events(limit: int = 50) -> list:
     try:
         now = datetime.now(timezone.utc).isoformat()
         
-        response = supabase_client.client.table('scheduled_events')\
+        query = supabase_client.client.table('scheduled_events')\
             .select('*')\
             .in_('status', ['pending', 'immediate'])\
             .or_(f'scheduled_at.is.null,scheduled_at.lte.{now}')\
             .order('created_at')\
-            .limit(limit)\
-            .execute()
+            .limit(limit)
+        
+        # 🆕 Фильтруем по bot_id если указан
+        if supabase_client.bot_id:
+            query = query.eq('bot_id', supabase_client.bot_id)
+        
+        response = query.execute()
         
         return response.data
     except Exception as e:
@@ -1323,13 +1345,18 @@ async def get_pending_events_in_next_minute(limit: int = 100) -> list:
         now = datetime.now(timezone.utc)
         next_minute = now + timedelta(seconds=60)
         
-        response = supabase_client.client.table('scheduled_events')\
+        query = supabase_client.client.table('scheduled_events')\
             .select('*')\
             .in_('status', ['pending', 'immediate'])\
             .or_(f'scheduled_at.is.null,scheduled_at.lte.{next_minute.isoformat()}')\
             .order('created_at')\
-            .limit(limit)\
-            .execute()
+            .limit(limit)
+        
+        # 🆕 Фильтруем по bot_id если указан
+        if supabase_client.bot_id:
+            query = query.eq('bot_id', supabase_client.bot_id)
+        
+        response = query.execute()
         
         return response.data
     except Exception as e:
@@ -1471,8 +1498,16 @@ async def background_event_processor():
                                     continue
                         
                         # Выполняем событие
-                        await process_scheduled_event(event)
-                        await update_event_result(event['id'], 'completed', {"processed": True})
+                        result = await process_scheduled_event(event)
+                        
+                        # Проверяем наличие поля 'info' для дашборда
+                        result_data = {"processed": True}
+                        if isinstance(result, dict):
+                            result_data.update(result)
+                            if 'info' in result:
+                                logger.info(f"   📊 Дашборд данные для задачи: {result['info'].get('title', 'N/A')}")
+                        
+                        await update_event_result(event['id'], 'completed', result_data)
                         logger.info(f"✅ Событие {event['id']} выполнено")
                         
                     except Exception as e:
@@ -1486,7 +1521,7 @@ async def background_event_processor():
             await asyncio.sleep(60)
 
 async def process_scheduled_event(event: Dict):
-    """Обрабатывает одно событие из БД"""
+    """Обрабатывает одно событие из БД и возвращает результат"""
     
     event_type = event['event_type']
     event_category = event['event_category']
@@ -1495,14 +1530,17 @@ async def process_scheduled_event(event: Dict):
     
     logger.info(f"🔄 Обработка события {event['id']}: {event_category}/{event_type}")
     
+    result = None
     if event_category == 'scheduled_task':
-        await execute_scheduled_task(event_type, user_id, event_data)
+        result = await execute_scheduled_task(event_type, user_id, event_data)
     elif event_category == 'global_handler':
-        await execute_global_handler(event_type, event_data)
+        result = await execute_global_handler(event_type, event_data)
     elif event_category == 'user_event':
-        await execute_event_handler(event_type, user_id, event_data)
+        result = await execute_event_handler(event_type, user_id, event_data)
     else:
         logger.warning(f"⚠️ Неизвестная категория события: {event_category}")
+    
+    return result
 
 # =============================================================================
 # ОБНОВЛЕННЫЕ ФУНКЦИИ С СОХРАНЕНИЕМ В БД
@@ -1689,6 +1727,10 @@ async def check_event_already_processed(event_type: str, user_id: int = None, se
         if session_id:
             query = query.eq('session_id', session_id)
         
+        # 🆕 Фильтруем по bot_id если указан
+        if supabase_client.bot_id:
+            query = query.eq('bot_id', supabase_client.bot_id)
+        
         response = query.execute()
         
         if response.data:
@@ -1884,3 +1926,69 @@ async def process_admin_event(event: Dict):
         shutil.rmtree(temp_after_msg, ignore_errors=True)
         logger.error(f"❌ Критическая ошибка обработки события: {e}")
         raise
+
+# =============================================================================
+# ФУНКЦИЯ ДЛЯ ПОДГОТОВКИ ДАННЫХ ДАШБОРДА
+# =============================================================================
+
+async def prepare_dashboard_info(
+    description_template: str,
+    title: str,
+    user_id: int
+) -> Dict[str, Any]:
+    """
+    Подготавливает данные для дашборда (БЕЗ записи в БД)
+    
+    Возвращаемый dict нужно поместить в поле 'info' результата обработчика.
+    bot_utils.py автоматически запишет его в столбец info_dashboard таблицы.
+    
+    Args:
+        description_template: Строка с {username}, например "{username} купил подписку"
+        title: Заголовок для дашборда
+        user_id: Telegram ID
+    
+    Returns:
+        Dict с данными для дашборда
+        
+    Example:
+        @event_router.event_handler("collect_phone", notify=True)
+        async def handle_phone_collection(user_id: int, phone_number: str):
+            # ... бизнес-логика ...
+            
+            return {
+                "status": "success",
+                "phone": phone_number,
+                "info": await prepare_dashboard_info(
+                    description_template="{username} оставил телефон",
+                    title="Новый контакт",
+                    user_id=user_id
+                )
+            }
+    """
+    supabase_client = get_supabase_client()
+    
+    # Получаем username из sales_users
+    username = f"user_{user_id}"  # fallback
+    if supabase_client:
+        try:
+            query = supabase_client.client.table('sales_users').select('username').eq('telegram_id', user_id)
+            if supabase_client.bot_id:
+                query = query.eq('bot_id', supabase_client.bot_id)
+            response = query.execute()
+            if response.data:
+                username = response.data[0].get('username') or username
+        except Exception as e:
+            logger.warning(f"⚠️ Не удалось получить username для дашборда: {e}")
+    
+    # Форматируем строку
+    description = description_template.format(username=username)
+    
+    # Московское время (UTC+3)
+    moscow_tz = timezone(timedelta(hours=3))
+    moscow_time = datetime.now(moscow_tz)
+    
+    return {
+        'title': title,
+        'description': description,
+        'created_at': moscow_time.isoformat()
+    }

smart_bot_factory/dashboard/__init__.py

@@ -0,0 +1,5 @@
+from ..core.decorators import prepare_dashboard_info
+
+__all__ = [
+    'prepare_dashboard_info'
+]

smart_bot_factory/handlers/handlers.py

@@ -77,14 +77,26 @@ async def timeup_handler(message: Message, state: FSMContext):
         
         # Получаем события для этого пользователя И глобальные события (user_id = null)
         # 1. События пользователя
-        user_events = supabase_client.client.table('scheduled_events').select(
+        user_events_query = supabase_client.client.table('scheduled_events').select(
             '*'
-        ).eq('user_id', message.from_user.id).in_('status', ['pending', 'immediate']).execute()
+        ).eq('user_id', message.from_user.id).in_('status', ['pending', 'immediate'])
+        
+        # 🆕 Фильтруем по bot_id если указан
+        if supabase_client.bot_id:
+            user_events_query = user_events_query.eq('bot_id', supabase_client.bot_id)
+        
+        user_events = user_events_query.execute()
         
         # 2. Глобальные события (без user_id)
-        global_events = supabase_client.client.table('scheduled_events').select(
+        global_events_query = supabase_client.client.table('scheduled_events').select(
             '*'
-        ).is_('user_id', 'null').in_('status', ['pending', 'immediate']).execute()
+        ).is_('user_id', 'null').in_('status', ['pending', 'immediate'])
+        
+        # 🆕 Фильтруем по bot_id если указан
+        if supabase_client.bot_id:
+            global_events_query = global_events_query.eq('bot_id', supabase_client.bot_id)
+        
+        global_events = global_events_query.execute()
         
         # Объединяем события
         all_events = (user_events.data or []) + (global_events.data or [])

smart_bot_factory/integrations/supabase_client.py

@@ -398,8 +398,8 @@ class SupabaseClient:
         try:
             # Проверяем существует ли админ
             response = self.client.table('sales_admins').select('telegram_id').eq(
-                'telegram_id', admin_data['telegram_id']
-            ).execute()
+                'telegram_id', admin_data['telegram_id'],
+            ).eq('bot_id', self.bot_id).execute()
             
             if response.data:
                 # Обновляем существующего
@@ -408,13 +408,14 @@ class SupabaseClient:
                     'first_name': admin_data.get('first_name'),
                     'last_name': admin_data.get('last_name'),
                     'is_active': True
-                }).eq('telegram_id', admin_data['telegram_id']).execute()
+                }).eq('telegram_id', admin_data['telegram_id']).eq('bot_id', self.bot_id).execute()
                 
                 logger.debug(f"Обновлен админ {admin_data['telegram_id']}")
             else:
                 # Создаем нового
                 self.client.table('sales_admins').insert({
                     'telegram_id': admin_data['telegram_id'],
+                    'bot_id': self.bot_id,
                     'username': admin_data.get('username'),
                     'first_name': admin_data.get('first_name'),
                     'last_name': admin_data.get('last_name'),

{smart_bot_factory-0.3.5.dist-info → smart_bot_factory-0.3.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: smart-bot-factory
-Version: 0.3.5
+Version: 0.3.7
 Summary: Библиотека для создания умных чат-ботов
 Author-email: Kopatych <eserov73@gmail.com>
 License: MIT
@@ -44,6 +44,7 @@ Description-Content-Type: text/markdown
   - [event_handler](#event_handler---обработчики-событий)
   - [schedule_task](#schedule_task---запланированные-задачи)
   - [global_handler](#global_handler---глобальные-обработчики)
+- [Dashboard Info](#-dashboard-info---отправка-данных-в-дашборд)
 - [Хуки для кастомизации](#-хуки-для-кастомизации)
 - [Telegram роутеры](#-telegram-роутеры)
 - [Расширенные возможности](#-расширенные-возможности)
@@ -187,9 +188,10 @@ sbf link
 
 ```python
 @event_router.event_handler(
-    event_type: str,      # Тип события
-    notify: bool = False, # Уведомлять админов
-    once_only: bool = True # Выполнять только 1 раз
+    event_type: str,                # Тип события
+    notify: bool = False,           # Уведомлять админов
+    once_only: bool = True,         # Выполнять только 1 раз
+    send_ai_response: bool = True   # Отправлять ответ от ИИ
 )
 async def handler(user_id: int, event_data: str):
     # Ваш код
@@ -201,6 +203,7 @@ async def handler(user_id: int, event_data: str):
 - **`event_type`** (обязательный) - Уникальное имя события
 - **`notify`** (по умолчанию `False`) - Отправлять уведомление админам после выполнения
 - **`once_only`** (по умолчанию `True`) - Если `True`, событие выполнится только 1 раз для пользователя
+- **`send_ai_response`** (по умолчанию `True`) - Если `False`, ИИ НЕ отправит сообщение после выполнения обработчика
 
 **Как работает:**
 
@@ -235,6 +238,16 @@ async def handle_question(user_id: int, question: str):
     """Обрабатывает вопросы (может быть много)"""
     # Логика обработки
     return {"status": "answered"}
+
+# БЕЗ отправки ответа от ИИ
+@event_router.event_handler("silent_event", send_ai_response=False)
+async def handle_silent(user_id: int, event_data: str):
+    """
+    Выполняет логику БЕЗ отправки сообщения от ИИ
+    Используйте когда хотите только собрать данные без ответа пользователю
+    """
+    await send_message_by_human(user_id, "✅ Данные сохранены")
+    return {"status": "saved"}
 ```
 
 ---
@@ -247,12 +260,13 @@ async def handle_question(user_id: int, question: str):
 
 ```python
 @event_router.schedule_task(
-    task_name: str,              # Название задачи
-    delay: Union[str, int],      # Задержка: "1h 30m" или секунды
-    notify: bool = False,        # Уведомлять админов
-    smart_check: bool = True,    # Умная проверка активности
-    once_only: bool = True,      # Выполнять только 1 раз
-    event_type: Union[str, Callable] = None  # Источник времени события
+    task_name: str,                     # Название задачи
+    delay: Union[str, int],             # Задержка: "1h 30m" или секунды
+    notify: bool = False,               # Уведомлять админов
+    smart_check: bool = True,           # Умная проверка активности
+    once_only: bool = True,             # Выполнять только 1 раз
+    event_type: Union[str, Callable] = None,  # Источник времени события
+    send_ai_response: bool = True       # Отправлять ответ от ИИ
 )
 async def handler(user_id: int, user_data: str):
     # Ваш код
@@ -273,6 +287,7 @@ async def handler(user_id: int, user_data: str):
 - **`event_type`** (опционально) - Источник времени события:
   - **Строка**: `"appointment_booking"` - ищет событие в БД и вычисляет время
   - **Функция**: `async def(user_id, user_data) -> datetime` - кастомная логика
+- **`send_ai_response`** (по умолчанию `True`) - Если `False`, ИИ НЕ отправит сообщение после выполнения задачи
 
 **Формула времени с `event_type`:**
 
@@ -362,11 +377,12 @@ async def important_reminder(user_id: int, text: str):
 
 ```python
 @event_router.global_handler(
-    handler_type: str,           # Тип обработчика
-    delay: Union[str, int],      # Задержка
-    notify: bool = False,        # Уведомлять админов
-    once_only: bool = True,      # Выполнять только 1 раз
-    event_type: Union[str, Callable] = None  # Источник времени
+    handler_type: str,                  # Тип обработчика
+    delay: Union[str, int],             # Задержка
+    notify: bool = False,               # Уведомлять админов
+    once_only: bool = True,             # Выполнять только 1 раз
+    event_type: Union[str, Callable] = None,  # Источник времени
+    send_ai_response: bool = True       # Отправлять ответ от ИИ
 )
 async def handler(handler_data: str):
     # Ваш код
@@ -420,6 +436,173 @@ async def notify_promo_ending(handler_data: str):
 
 ---
 
+## 📊 Dashboard Info - Отправка данных в дашборд
+
+**Назначение:** Позволяет отправлять информацию о событиях в дашборд (таблица `scheduled_events`, столбец `info_dashboard`) для аналитики и мониторинга.
+
+### Как работает
+
+1. Обработчик события возвращает результат с полем `'info'`
+2. Система автоматически извлекает это поле и записывает в `info_dashboard` таблицы
+3. Функция `prepare_dashboard_info` автоматически:
+   - Получает `username` из таблицы `sales_users`
+   - Форматирует строку с подстановкой данных
+   - Добавляет московское время (UTC+3)
+
+### Сигнатура
+
+```python
+from smart_bot_factory.dashboard import prepare_dashboard_info
+
+dashboard_data = await prepare_dashboard_info(
+    description_template: str,  # Строка с {username}, например "{username} купил подписку"
+    title: str,                 # Заголовок для дашборда
+    user_id: int                # Telegram ID пользователя
+)
+```
+
+**Возвращает:**
+
+```python
+{
+    'title': 'Заголовок',
+    'description': '@username123 купил подписку',  # С подстановкой реального username
+    'created_at': '2025-10-18T15:30:45.123456+03:00'  # Московское время
+}
+```
+
+### Примеры использования
+
+#### С event_handler
+
+```python
+from smart_bot_factory.dashboard import prepare_dashboard_info
+
+@event_router.event_handler("collect_phone", notify=True, once_only=True)
+async def handle_phone_collection(user_id: int, phone_number: str):
+    """Сохраняет телефон клиента"""
+    
+    # Ваша бизнес-логика
+    session = await supabase_client.get_active_session(user_id)
+    if session:
+        metadata = session.get('metadata', {})
+        metadata['phone'] = phone_number
+        await supabase_client.update_session_metadata(session['id'], metadata)
+    
+    await send_message_by_human(
+        user_id=user_id,
+        message_text=f"✅ Спасибо! Ваш номер {phone_number} сохранен"
+    )
+    
+    # 📊 Возвращаем результат С данными для дашборда
+    return {
+        "status": "success",
+        "phone": phone_number,
+        "info": await prepare_dashboard_info(
+            description_template="{username} оставил номер телефона",
+            title="Новый контакт",
+            user_id=user_id
+        )
+    }
+```
+
+#### С schedule_task
+
+```python
+@event_router.schedule_task("follow_up", delay="24h", smart_check=True)
+async def send_follow_up(user_id: int, reminder_text: str):
+    """Напоминание через 24 часа"""
+    
+    await send_message_by_human(
+        user_id=user_id,
+        message_text=f"👋 {reminder_text}"
+    )
+    
+    # 📊 Работает и для задач!
+    return {
+        "status": "sent",
+        "type": "follow_up",
+        "info": await prepare_dashboard_info(
+            description_template="{username} получил напоминание",
+            title="Напоминание отправлено",
+            user_id=user_id
+        )
+    }
+```
+
+#### БЕЗ дашборда
+
+Если не нужно отправлять данные в дашборд - просто не добавляйте поле `'info'`:
+
+```python
+@event_router.event_handler("collect_name", once_only=False)
+async def handle_name_collection(user_id: int, client_name: str):
+    """БЕЗ дашборда - просто сохраняем имя"""
+    
+    await send_message_by_human(
+        user_id=user_id,
+        message_text=f"✅ Спасибо! Ваше имя {client_name} сохранено"
+    )
+    
+    # Возвращаем БЕЗ поля 'info' - дашборд останется пустым
+    return {"status": "success"}
+```
+
+### Что попадает в БД
+
+**События С дашбордом:**
+
+```sql
+SELECT * FROM scheduled_events WHERE id = '123';
+
+id: 123
+event_type: collect_phone
+event_category: user_event
+user_id: 12345
+status: completed
+result_data: {"status": "success", "phone": "+79001234567", "info": {...}}
+info_dashboard: {
+  "title": "Новый контакт",
+  "description": "@username123 оставил номер телефона",
+  "created_at": "2025-10-18T15:30:45+03:00"
+}
+```
+
+**События БЕЗ дашборда:**
+
+```sql
+SELECT * FROM scheduled_events WHERE id = '124';
+
+id: 124
+event_type: collect_name
+event_category: user_event
+user_id: 12345
+status: completed
+result_data: {"status": "success"}
+info_dashboard: NULL  ← Остается пустым
+```
+
+### Форматирование строк
+
+Функция `prepare_dashboard_info` поддерживает подстановку `{username}`:
+
+```python
+# Примеры шаблонов:
+"{username} купил подписку на 1 год"
+"{username} оставил контакт"
+"{username} записался на консультацию"
+"{username} задал вопрос о продукте"
+"{username} завершил оплату"
+
+# После подстановки:
+"@user123 купил подписку на 1 год"
+"@ivan_petrov оставил контакт"
+```
+
+Если пользователь не найден в `sales_users` - будет использован fallback: `user_12345`
+
+---
+
 ## 🎣 Хуки для кастомизации
 
 Хуки позволяют внедрять свою логику в стандартную обработку сообщений без переписывания всей функции.
@@ -813,16 +996,46 @@ DEBUG_MODE=false
 
 ## 🎯 Сравнение декораторов
 
-| Декоратор | Когда выполняется | Для кого | Параметры |
-|-----------|-------------------|----------|-----------|
-| `@event_handler` | Немедленно | 1 пользователь | `event_type`, `notify`, `once_only` |
-| `@schedule_task` | Через время | 1 пользователь | `task_name`, `delay`, `event_type`, `smart_check`, `once_only`, `notify` |
-| `@global_handler` | Через время | Все пользователи | `handler_type`, `delay`, `event_type`, `once_only`, `notify` |
+| Декоратор | Когда выполняется | Для кого | Ключевые параметры |
+|-----------|-------------------|----------|--------------------|
+| `@event_handler` | Немедленно | 1 пользователь | `event_type`, `notify`, `once_only`, `send_ai_response` |
+| `@schedule_task` | Через время | 1 пользователь | `task_name`, `delay`, `event_type`, `smart_check`, `once_only`, `notify`, `send_ai_response` |
+| `@global_handler` | Через время | Все пользователи | `handler_type`, `delay`, `event_type`, `once_only`, `notify`, `send_ai_response` |
 
 ---
 
 ## 🔑 Ключевые концепции
 
+### `send_ai_response=True`
+
+Контролирует отправку сообщения от ИИ после выполнения обработчика:
+
+- **`True`** (по умолчанию) - ИИ отправит сообщение пользователю после выполнения обработчика
+- **`False`** - ИИ НЕ отправит сообщение (используйте когда нужна только фоновая обработка или когда отправляете сообщение вручную)
+
+**Когда использовать `send_ai_response=False`:**
+
+- Когда нужно только собрать данные без ответа пользователю
+- Когда вы сами отправляете сообщение через `send_message_by_human()`
+- Для фоновых задач без взаимодействия с пользователем
+
+```python
+# ИИ отправит сообщение (по умолчанию)
+@event_router.event_handler("collect_phone")
+async def save_phone(user_id: int, phone: str):
+    # Сохраняем телефон
+    # ИИ автоматически отправит сообщение после выполнения
+    return {"status": "success"}
+
+# ИИ НЕ отправит сообщение
+@event_router.event_handler("collect_name", send_ai_response=False)
+async def save_name(user_id: int, name: str):
+    # Сохраняем имя
+    await send_message_by_human(user_id, f"✅ Имя {name} сохранено")
+    # ИИ не будет отправлять свое сообщение
+    return {"status": "success"}
+```
+
 ### `once_only=True`
 
 Гарантирует выполнение события только 1 раз для пользователя:

{smart_bot_factory-0.3.5.dist-info → smart_bot_factory-0.3.7.dist-info}/RECORD

@@ -7,7 +7,6 @@ smart_bot_factory/admin/__init__.py,sha256=vdsMTpt_LiXkY-awFu_X9e2Zt7CV50PwmsWkF
 smart_bot_factory/admin/admin_events.py,sha256=QCosyTbJgrU8daWSK_bQgf8UZoJSIrV6xyO0R3XV2j0,43289
 smart_bot_factory/admin/admin_logic.py,sha256=vPkNk86bdPsjNUNlZ3qfKtbRr9UuJy2oG54cYUGGNmg,23107
 smart_bot_factory/admin/admin_manager.py,sha256=xlyG9mIjPmtUhS4E9lp36T7o5Kfp5PZpJ-r1QjnSn5g,6394
-smart_bot_factory/admin/admin_migration.sql,sha256=kleMPJBSe2Z7ZZz7rNyOX_yoh4GZivGesqAX90U5PGs,5667
 smart_bot_factory/admin/admin_tester.py,sha256=PGFpf7fmD5Wxea31xR2ZM_A_QpvrB73gsbxvUrHQBkg,6463
 smart_bot_factory/admin/timeout_checker.py,sha256=TzA2FGrxwE8fuhKerGnGrt4qYMEZdIR8x3SQAnIW5YQ,24490
 smart_bot_factory/aiogram_calendar/__init__.py,sha256=_IzB_HJIZuMs__7xBBsYVG20GbRNFw2VowvhOEyiGGc,349
@@ -30,9 +29,9 @@ smart_bot_factory/configs/growthmed-october-24/tests/realistic_scenarios.yaml,sh
 smart_bot_factory/configs/growthmed-october-24/tests/scenario_examples.yaml,sha256=bzDulOU4a2LyWlcHzlQU8GYhOky2WTfyizGfjX4ioMY,2436
 smart_bot_factory/configs/growthmed-october-24/welcome_file/welcome_file_msg.txt,sha256=Db21Mm0r8SBWFdX9EeIF2FZtLQ2cvuwVlSRJd2KEYCg,922
 smart_bot_factory/configs/growthmed-october-24/welcome_file/Чек лист по 152ФЗ и 323ФЗ для медицины.pdf,sha256=BiAiQHNnQXJPMsks9AeL6s0beEjRFkRMJLMlAn4WorA,5284954
-smart_bot_factory/core/bot_utils.py,sha256=4c98tVPThXW4ET6XJ0FYMePrx4gYrw_HNhx3YLep9hY,46976
+smart_bot_factory/core/bot_utils.py,sha256=vblk94k8cXvc-3iS3UOZvnU2NtXXKYgt3vzkioca-ac,48395
 smart_bot_factory/core/conversation_manager.py,sha256=eoHL7MCEz68DRvTVwRwZgf2PWwGv4T6J9D-I-thETi8,28289
-smart_bot_factory/core/decorators.py,sha256=0fDgYNaXU3ZLhFJBxAognLWfy_Fz1F63wdUNaVziDQU,95141
+smart_bot_factory/core/decorators.py,sha256=mYWiN9B0lrgV3uRAaFVkJTCKWZyTpVNM_AneuQcqifA,99872
 smart_bot_factory/core/message_sender.py,sha256=0-SQcK4W1x__VgvyaeVRuFlXcxV56TsR_nNK07Nr4b4,32763
 smart_bot_factory/core/router.py,sha256=ji7rzpuKaO8yKaxFW58WhlgG5ExXlbCgqCTONxAyqL4,15022
 smart_bot_factory/core/router_manager.py,sha256=dUwesog-oHk1U2EDdS8p0e4MTSkwtx5_qXn6nrJ9l9I,9700
@@ -40,10 +39,11 @@ smart_bot_factory/core/states.py,sha256=L8qp1UmYFuxTN5U9tY076rDuKgxtFbpSGqBpva2e
 smart_bot_factory/creation/__init__.py,sha256=IgDk8GDS3pg7Pw_Et41J33ZmeZIU5dRwQdTmYKXfJfE,128
 smart_bot_factory/creation/bot_builder.py,sha256=yGRmOPD7qCMbhcBiltHWISoKxWx8eqjDSnZXpwhqnUs,43115
 smart_bot_factory/creation/bot_testing.py,sha256=JDWXyJfZmbgo-DLdAPk8Sd9FiehtHHa4sLD17lBrTOc,55669
+smart_bot_factory/dashboard/__init__.py,sha256=bDBOWQbcAL1Bmz4KVFouAKg8FN-c6EsC_-YthTt_mP4,100
 smart_bot_factory/event/__init__.py,sha256=hPL449RULIOB-OXv1ZbGNiHctAYaOMUqhSWGPrDHYBM,212
-smart_bot_factory/handlers/handlers.py,sha256=v3ubszkN7ML-CXChveTdp68EdMjHl02NTJ3hMT2zXKA,61893
+smart_bot_factory/handlers/handlers.py,sha256=haxyVvFuyMWvfGCOiAvXPrez96bchoHnwQEEURMqiMI,62409
 smart_bot_factory/integrations/openai_client.py,sha256=fwaJpwojFdLBWChcFWpFGOHK9upG-nCIwDochkCRRlY,24291
-smart_bot_factory/integrations/supabase_client.py,sha256=Rv0sZHXGSfm3UWodmaR1N-X5-2JbmynPWJKY0a0k_Tk,63557
+smart_bot_factory/integrations/supabase_client.py,sha256=XV1_caDAADnXLwCM7CkUdGfUNBNHBHYz-HBPSYmdGv4,63653
 smart_bot_factory/message/__init__.py,sha256=-ehDZweUc3uKgmLLxFVsD-KWrDtnHpHms7pCrDelWo0,1950
 smart_bot_factory/router/__init__.py,sha256=5gEbpG3eylOyow5NmidzGUy0K-AZq7RhYLVu9OaUT6c,270
 smart_bot_factory/supabase/__init__.py,sha256=XmZP6yM9ffERM5ddAWyJnrNzEhCYtMu3AcjVCi1rOf8,179
@@ -52,8 +52,8 @@ smart_bot_factory/utils/__init__.py,sha256=UhsJXEHfrIK8h1AHsroHSwAriijk-LvnqLyvg
 smart_bot_factory/utils/debug_routing.py,sha256=BOoDhKBg7UXe5uHQxRk3TSfPfLPOFqt0N7lAo6kjCOo,4719
 smart_bot_factory/utils/prompt_loader.py,sha256=HS_6Vf-qvRBkhvyzu-HNVS1swFgmqWOKNNv0F6We_AQ,20060
 smart_bot_factory/utils/user_prompt_loader.py,sha256=dk6P0X_3UcNqxjRtuIvb0LcPrp03zIIsstZwdmeCPaE,2519
-smart_bot_factory-0.3.5.dist-info/METADATA,sha256=xOG5tl-e-w8yfvxuZfiyVRnQGdEvUxYLMPbKVGTcbmY,31905
-smart_bot_factory-0.3.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-smart_bot_factory-0.3.5.dist-info/entry_points.txt,sha256=ybKEAI0WSb7WoRiey7QE-HHfn88UGV7nxLDxXq7b7SU,50
-smart_bot_factory-0.3.5.dist-info/licenses/LICENSE,sha256=OrK3cwdUTzNzIhJvSPtJaVMoYIyC_sSx5EFE_FDMvGs,1092
-smart_bot_factory-0.3.5.dist-info/RECORD,,
+smart_bot_factory-0.3.7.dist-info/METADATA,sha256=cfOUXXewYMK7EomidcIP78W_yjjCnWHtmQ7efPx8FMA,40662
+smart_bot_factory-0.3.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+smart_bot_factory-0.3.7.dist-info/entry_points.txt,sha256=ybKEAI0WSb7WoRiey7QE-HHfn88UGV7nxLDxXq7b7SU,50
+smart_bot_factory-0.3.7.dist-info/licenses/LICENSE,sha256=OrK3cwdUTzNzIhJvSPtJaVMoYIyC_sSx5EFE_FDMvGs,1092
+smart_bot_factory-0.3.7.dist-info/RECORD,,

smart_bot_factory/admin/admin_migration.sql

@@ -1,136 +0,0 @@
--- ФИНАЛЬНАЯ МИГРАЦИЯ АДМИНСКОЙ СИСТЕМЫ
--- Выполните ПОСЛЕ исправления уникальности telegram_id
-
--- 1. Расширяем существующие таблицы
-ALTER TABLE sales_chat_sessions 
-ADD COLUMN IF NOT EXISTS current_stage TEXT,
-ADD COLUMN IF NOT EXISTS lead_quality_score INTEGER;
-
-ALTER TABLE sales_messages 
-ADD COLUMN IF NOT EXISTS ai_metadata JSONB DEFAULT '{}'::jsonb;
-
--- 2. Создаем функцию обновления updated_at
-CREATE OR REPLACE FUNCTION update_updated_at_column()
-RETURNS TRIGGER AS $$
-BEGIN
-    NEW.updated_at = NOW();
-    RETURN NEW;
-END;
-$$ LANGUAGE plpgsql;
-
--- 3. Таблица администраторов
-CREATE TABLE IF NOT EXISTS sales_admins (
-    id BIGSERIAL PRIMARY KEY,
-    telegram_id BIGINT UNIQUE NOT NULL,
-    username TEXT,
-    first_name TEXT,
-    last_name TEXT,
-    role TEXT DEFAULT 'admin',
-    is_active BOOLEAN DEFAULT TRUE,
-    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
-    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
-);
-
--- 4. Диалоги админов с пользователями
-CREATE TABLE IF NOT EXISTS admin_user_conversations (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    admin_id BIGINT REFERENCES sales_admins(telegram_id) ON DELETE CASCADE,
-    user_id BIGINT REFERENCES sales_users(telegram_id) ON DELETE CASCADE,
-    session_id UUID REFERENCES sales_chat_sessions(id) ON DELETE CASCADE,
-    status TEXT DEFAULT 'active' CHECK (status IN ('active', 'completed')),
-    started_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
-    ended_at TIMESTAMP WITH TIME ZONE,
-    auto_end_at TIMESTAMP WITH TIME ZONE DEFAULT NOW() + INTERVAL '30 minutes'
-);
-
--- 5. События из ответов ИИ
-CREATE TABLE IF NOT EXISTS session_events (
-    id BIGSERIAL PRIMARY KEY,
-    session_id UUID REFERENCES sales_chat_sessions(id) ON DELETE CASCADE,
-    event_type TEXT NOT NULL,
-    event_info TEXT,
-    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
-    notified_admins BIGINT[] DEFAULT '{}'
-);
-
--- 6. Индексы
-CREATE INDEX IF NOT EXISTS idx_sales_admins_telegram_id ON sales_admins(telegram_id);
-CREATE INDEX IF NOT EXISTS idx_admin_conversations_status ON admin_user_conversations(status);
-CREATE INDEX IF NOT EXISTS idx_admin_conversations_admin ON admin_user_conversations(admin_id);
-CREATE INDEX IF NOT EXISTS idx_admin_conversations_user ON admin_user_conversations(user_id);
-CREATE INDEX IF NOT EXISTS idx_session_events_type ON session_events(event_type);
-CREATE INDEX IF NOT EXISTS idx_session_events_session ON session_events(session_id);
-CREATE INDEX IF NOT EXISTS idx_sales_chat_sessions_stage ON sales_chat_sessions(current_stage);
-CREATE INDEX IF NOT EXISTS idx_sales_messages_metadata ON sales_messages USING gin(ai_metadata);
-
--- 7. Триггер для sales_admins
-DROP TRIGGER IF EXISTS update_sales_admins_updated_at ON sales_admins;
-CREATE TRIGGER update_sales_admins_updated_at 
-    BEFORE UPDATE ON sales_admins
-    FOR EACH ROW EXECUTE FUNCTION update_updated_at_column();
-
--- 8. Функция завершения просроченных диалогов
-CREATE OR REPLACE FUNCTION end_expired_admin_conversations()
-RETURNS INTEGER AS $$
-DECLARE
-    ended_count INTEGER;
-BEGIN
-    UPDATE admin_user_conversations 
-    SET status = 'completed', ended_at = NOW()
-    WHERE status = 'active' AND auto_end_at < NOW();
-    
-    GET DIAGNOSTICS ended_count = ROW_COUNT;
-    RETURN ended_count;
-END;
-$$ LANGUAGE plpgsql;
-
--- 9. Представления для аналитики
-CREATE OR REPLACE VIEW funnel_stats AS
-SELECT 
-    current_stage,
-    COUNT(*) as count,
-    AVG(lead_quality_score) as avg_quality,
-    ROUND(COUNT(*) * 100.0 / NULLIF(SUM(COUNT(*)) OVER(), 0), 1) as percentage
-FROM sales_chat_sessions 
-WHERE created_at > NOW() - INTERVAL '7 days'
-AND current_stage IS NOT NULL
-GROUP BY current_stage;
-
-CREATE OR REPLACE VIEW daily_events AS
-SELECT 
-    DATE(created_at) as event_date,
-    event_type,
-    COUNT(*) as count
-FROM session_events 
-WHERE created_at > NOW() - INTERVAL '30 days'
-GROUP BY DATE(created_at), event_type
-ORDER BY event_date DESC, event_type;
-
--- 10. RLS политики
-ALTER TABLE sales_admins ENABLE ROW LEVEL SECURITY;
-ALTER TABLE admin_user_conversations ENABLE ROW LEVEL SECURITY;
-ALTER TABLE session_events ENABLE ROW LEVEL SECURITY;
-
-DROP POLICY IF EXISTS "Service role can manage all admins" ON sales_admins;
-DROP POLICY IF EXISTS "Service role can manage all conversations" ON admin_user_conversations;
-DROP POLICY IF EXISTS "Service role can manage all events" ON session_events;
-
-CREATE POLICY "Service role can manage all admins" ON sales_admins
-    FOR ALL USING (current_setting('role') = 'service_role');
-
-CREATE POLICY "Service role can manage all conversations" ON admin_user_conversations
-    FOR ALL USING (current_setting('role') = 'service_role');
-
-CREATE POLICY "Service role can manage all events" ON session_events
-    FOR ALL USING (current_setting('role') = 'service_role');
-
--- 11. Комментарии
-COMMENT ON TABLE sales_admins IS 'Администраторы бота';
-COMMENT ON TABLE admin_user_conversations IS 'Активные диалоги админов с пользователями';
-COMMENT ON TABLE session_events IS 'События из ответов ИИ для уведомлений';
-
--- Финальная проверка
-SELECT 
-    'АДМИНСКАЯ СИСТЕМА СОЗДАНА!' AS status,
-    (SELECT COUNT(*) FROM information_schema.tables 
-     WHERE table_name IN ('sales_admins', 'admin_user_conversations', 'session_events')) AS tables_created;