smart-bot-factory 0.1.8__py3-none-any.whl → 0.2.0__py3-none-any.whl

smart_bot_factory/core/decorators.py

@@ -1153,7 +1153,7 @@ async def background_event_processor():
                         logger.error(f"❌ Ошибка обработки события {event['id']}: {e}")
                         await update_event_result(event['id'], 'failed', None, str(e))
             
-            await asyncio.sleep(30)
+            await asyncio.sleep(60)
             
         except Exception as e:
             logger.error(f"❌ Ошибка в фоновом процессоре: {e}")

smart_bot_factory/core/router.py

@@ -1,5 +1,5 @@
 """
-Роутер для Smart Bot Factory - аналог aiogram Router
+EventRouter для Smart Bot Factory - роутер для событий, задач и глобальных обработчиков
 """
 
 from typing import Dict, Any, Callable, Union
@@ -7,7 +7,7 @@ import logging
 
 logger = logging.getLogger(__name__)
 
-class Router:
+class EventRouter:
     """
     Роутер для организации обработчиков событий, задач и глобальных обработчиков
     """
@@ -19,7 +19,7 @@ class Router:
         Args:
             name: Имя роутера для логирования
         """
-        self.name = name or f"Router_{id(self)}"
+        self.name = name or f"EventRouter_{id(self)}"
         self._event_handlers: Dict[str, Dict[str, Any]] = {}
         self._scheduled_tasks: Dict[str, Dict[str, Any]] = {}
         self._global_handlers: Dict[str, Dict[str, Any]] = {}
@@ -183,12 +183,12 @@ class Router:
         all_handlers.update(self._global_handlers)
         return all_handlers
     
-    def include_router(self, router: 'Router'):
+    def include_router(self, router: 'EventRouter'):
         """
         Включает другой роутер в текущий
         
         Args:
-            router: Роутер для включения
+            router: EventRouter для включения
         """
         # Добавляем обработчики событий
         for event_type, handler_info in router.get_event_handlers().items():
@@ -211,4 +211,4 @@ class Router:
         logger.info(f"🔗 Роутер {self.name}: включен роутер {router.name}")
     
     def __repr__(self):
-        return f"Router(name='{self.name}', events={len(self._event_handlers)}, tasks={len(self._scheduled_tasks)}, globals={len(self._global_handlers)})"
+        return f"EventRouter(name='{self.name}', events={len(self._event_handlers)}, tasks={len(self._scheduled_tasks)}, globals={len(self._global_handlers)})"

smart_bot_factory/core/router_manager.py

@@ -4,17 +4,17 @@
 
 from typing import Dict, List, Any, Optional
 import logging
-from .router import Router
+from .router import EventRouter
 
 logger = logging.getLogger(__name__)
 
 class RouterManager:
     """
-    Менеджер для управления роутерами и их обработчиками
+    Менеджер для управления роутерами событий и их обработчиками
     """
     
     def __init__(self):
-        self._routers: List[Router] = []
+        self._routers: List[EventRouter] = []
         self._combined_handlers: Dict[str, Dict[str, Any]] = {
             'event_handlers': {},
             'scheduled_tasks': {},
@@ -23,12 +23,12 @@ class RouterManager:
         
         logger.info("🔄 Создан менеджер роутеров")
     
-    def register_router(self, router: Router):
+    def register_router(self, router: EventRouter):
         """
-        Регистрирует роутер в менеджере
+        Регистрирует роутер событий в менеджере
         
         Args:
-            router: Роутер для регистрации
+            router: EventRouter для регистрации
         """
         if router not in self._routers:
             self._routers.append(router)
@@ -37,12 +37,12 @@ class RouterManager:
         else:
             logger.warning(f"⚠️ Роутер {router.name} уже зарегистрирован")
     
-    def unregister_router(self, router: Router):
+    def unregister_router(self, router: EventRouter):
         """
-        Отменяет регистрацию роутера
+        Отменяет регистрацию роутера событий
         
         Args:
-            router: Роутер для отмены регистрации
+            router: EventRouter для отмены регистрации
         """
         if router in self._routers:
             self._routers.remove(router)
@@ -150,8 +150,8 @@ class RouterManager:
         
         return "\n".join(prompt_parts)
     
-    def get_router_by_name(self, name: str) -> Optional[Router]:
-        """Получает роутер по имени"""
+    def get_router_by_name(self, name: str) -> Optional[EventRouter]:
+        """Получает роутер событий по имени"""
         for router in self._routers:
             if router.name == name:
                 return router

smart_bot_factory/core/telegram_router.py

@@ -0,0 +1,58 @@
+"""
+TelegramRouter - обертка над aiogram Router для обработки Telegram сообщений
+"""
+
+from typing import Any
+import logging
+from aiogram import Router as AiogramRouter
+
+logger = logging.getLogger(__name__)
+
+
+class TelegramRouter:
+    """
+    Обертка над aiogram Router для единообразного API библиотеки
+    Позволяет регистрировать обработчики команд, сообщений и callback'ов
+    """
+    
+    def __init__(self, name: str = None):
+        """
+        Инициализация Telegram роутера
+        
+        Args:
+            name: Имя роутера для логирования
+        """
+        self.name = name or f"TelegramRouter_{id(self)}"
+        self._router = AiogramRouter(name=self.name)
+        
+        logger.info(f"📱 Создан TelegramRouter: {self.name}")
+    
+    @property
+    def router(self) -> AiogramRouter:
+        """
+        Возвращает внутренний aiogram Router
+        
+        Используйте этот роутер для прямой работы с aiogram API:
+        
+        Example:
+            telegram_router = TelegramRouter("my_router")
+            
+            # Регистрация команды
+            @telegram_router.router.message(Command("start"))
+            async def start_handler(message: Message):
+                await message.answer("Hello!")
+            
+            # Регистрация callback
+            @telegram_router.router.callback_query(F.data.startswith("buy_"))
+            async def buy_handler(callback: CallbackQuery):
+                await callback.answer("Покупка...")
+        """
+        return self._router
+    
+    def get_aiogram_router(self) -> AiogramRouter:
+        """Получает внутренний aiogram Router (алиас для .router)"""
+        return self._router
+    
+    def __repr__(self):
+        return f"TelegramRouter(name='{self.name}')"
+

smart_bot_factory/creation/bot_builder.py

@@ -5,7 +5,7 @@
 import os
 import logging
 from pathlib import Path
-from typing import Optional, Dict, Any
+from typing import Optional, Dict, Any, List
 
 from ..config import Config
 from ..integrations.openai_client import OpenAIClient
@@ -45,6 +45,7 @@ class BotBuilder:
         self.analytics_manager: Optional[AnalyticsManager] = None
         self.prompt_loader: Optional[PromptLoader] = None
         self.router_manager: Optional[RouterManager] = None
+        self._telegram_routers: List = []  # Список Telegram роутеров
         
         # Флаги инициализации
         self._initialized = False
@@ -258,10 +259,10 @@ class BotBuilder:
     
     def register_router(self, router):
         """
-        Регистрирует роутер в менеджере роутеров
+        Регистрирует роутер событий в менеджере роутеров
         
         Args:
-            router: Роутер для регистрации
+            router: EventRouter для регистрации
         """
         # Если RouterManager еще не инициализирован, создаем его
         if not self.router_manager:
@@ -270,10 +271,63 @@ class BotBuilder:
             logger.info(f"✅ Router Manager создан для регистрации роутера '{router.name}'")
         
         self.router_manager.register_router(router)
-        logger.info(f"✅ Роутер '{router.name}' зарегистрирован в боте {self.bot_id}")
+        logger.info(f"✅ Роутер событий '{router.name}' зарегистрирован в боте {self.bot_id}")
+    
+    def register_routers(self, *event_routers):
+        """
+        Регистрирует несколько роутеров событий одновременно
+        
+        Args:
+            *event_routers: Произвольное количество EventRouter
+            
+        Example:
+            bot_builder.register_routers(event_router1, event_router2, event_router3)
+        """
+        if not event_routers:
+            logger.warning("⚠️ register_routers вызван без аргументов")
+            return
+        
+        for router in event_routers:
+            self.register_router(router)
+        
+        logger.info(f"✅ Зарегистрировано {len(event_routers)} роутеров событий")
+    
+    def register_telegram_router(self, telegram_router):
+        """
+        Регистрирует Telegram роутер для обработки команд и сообщений
+        
+        Args:
+            telegram_router: TelegramRouter для регистрации
+        """
+        from ..core.telegram_router import TelegramRouter
+        
+        if not isinstance(telegram_router, TelegramRouter):
+            raise TypeError(f"Ожидается TelegramRouter, получен {type(telegram_router)}")
+        
+        self._telegram_routers.append(telegram_router)
+        logger.info(f"✅ Telegram роутер '{telegram_router.name}' зарегистрирован в боте {self.bot_id}")
+    
+    def register_telegram_routers(self, *telegram_routers):
+        """
+        Регистрирует несколько Telegram роутеров одновременно
+        
+        Args:
+            *telegram_routers: Произвольное количество TelegramRouter
+            
+        Example:
+            bot_builder.register_telegram_routers(telegram_router1, telegram_router2)
+        """
+        if not telegram_routers:
+            logger.warning("⚠️ register_telegram_routers вызван без аргументов")
+            return
+        
+        for router in telegram_routers:
+            self.register_telegram_router(router)
+        
+        logger.info(f"✅ Зарегистрировано {len(telegram_routers)} Telegram роутеров")
     
     def get_router_manager(self) -> RouterManager:
-        """Получает менеджер роутеров"""
+        """Получает менеджер роутеров событий"""
         return self.router_manager
     
     async def start(self):
@@ -375,7 +429,14 @@ class BotBuilder:
             from ..admin.admin_logic import setup_admin_handlers
             from ..core.bot_utils import setup_utils_handlers
             
-            # Настраиваем обработчики запросов
+            # Подключаем пользовательские Telegram роутеры ПЕРВЫМИ (высший приоритет)
+            if self._telegram_routers:
+                logger.info(f"🔗 Подключаем {len(self._telegram_routers)} пользовательских Telegram роутеров")
+                for telegram_router in self._telegram_routers:
+                    dp.include_router(telegram_router.get_aiogram_router())
+                    logger.info(f"✅ Подключен Telegram роутер: {telegram_router.name}")
+            
+            # Настраиваем стандартные обработчики (меньший приоритет)
             setup_utils_handlers(dp)    # Утилитарные команды (/status, /help)
             setup_admin_handlers(dp)    # Админские команды (/админ, /стат, /чат)
             setup_handlers(dp)          # Основные пользовательские обработчики

smart_bot_factory/integrations/supabase_client.py

@@ -805,31 +805,21 @@ class SupabaseClient:
             return {}
 
     async def get_user_last_message_info(self, user_id: int) -> Optional[Dict[str, Any]]:
-        """Получает информацию о последнем сообщении пользователя"""
+        """Получает информацию о последней активности пользователя из сессии"""
         try:
-            # Получаем последнее сообщение пользователя
-            response = self.client.table('sales_messages').select(
-                'id', 'created_at', 'session_id', 'sender_type'
-            ).eq('sender_telegram_id', user_id).order('created_at', desc=True).limit(1).execute()
+            # Получаем последнюю сессию пользователя
+            response = self.client.table('sales_chat_sessions').select(
+                'id', 'current_stage', 'created_at', 'updated_at'
+            ).eq('user_id', user_id).order('updated_at', desc=True).limit(1).execute()
             
             if not response.data:
                 return None
             
-            last_message = response.data[0]
-            
-            # Получаем информацию о сессии
-            session_response = self.client.table('sales_chat_sessions').select(
-                'id', 'current_stage', 'updated_at'
-            ).eq('id', last_message['session_id']).execute()
-            
-            if not session_response.data:
-                return None
-            
-            session = session_response.data[0]
+            session = response.data[0]
             
             return {
-                'last_message_at': last_message['created_at'],
-                'session_id': last_message['session_id'],
+                'last_message_at': session['updated_at'],
+                'session_id': session['id'],
                 'current_stage': session['current_stage'],
                 'session_updated_at': session['updated_at']
             }

smart_bot_factory/router/__init__.py

@@ -2,8 +2,10 @@
 Router модули smart_bot_factory
 """
 
-from ..core.router import Router
+from ..core.router import EventRouter
+from ..core.telegram_router import TelegramRouter
 
 __all__ = [
-    'Router'
+    'EventRouter',  # Роутер для событий
+    'TelegramRouter',  # Роутер для Telegram
 ]

smart_bot_factory-0.2.0.dist-info/METADATA

@@ -0,0 +1,789 @@
+Metadata-Version: 2.4
+Name: smart-bot-factory
+Version: 0.2.0
+Summary: Библиотека для создания умных чат-ботов
+Author-email: Kopatych <kopatych@example.com>
+License: MIT
+License-File: LICENSE
+Keywords: chatbot,cli,openai,supabase,telegram
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: aiofiles>=23.0.0
+Requires-Dist: aiogram>=3.4.1
+Requires-Dist: click>=8.0.0
+Requires-Dist: openai>=1.12.0
+Requires-Dist: project-root-finder>=1.9
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: pytz>=2023.3
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: supabase>=2.3.4
+Description-Content-Type: text/markdown
+
+# Smart Bot Factory
+
+Современная библиотека для создания умных чат-ботов на Python с использованием OpenAI, Telegram и Supabase.
+
+## 🚀 Возможности
+
+- **🤖 AI Integration** - Полная интеграция с OpenAI GPT для умных диалогов
+- **📱 Telegram Bot API** - Поддержка через aiogram 3.x
+- **💾 Supabase Backend** - Хранение данных, сессий и аналитики
+- **🎯 Router System** - Модульная система обработчиков событий
+- **⏰ Smart Scheduler** - Умное планирование задач с проверкой активности пользователей
+- **🌍 Global Handlers** - Массовые рассылки и глобальные события
+- **🧪 Testing Suite** - Встроенная система тестирования ботов
+- **🛠️ CLI Tools** - Удобный интерфейс командной строки
+- **👥 Admin Panel** - Система администрирования через Telegram
+- **📊 Analytics** - Встроенная аналитика и отчеты
+
+## 📦 Установка
+
+### Системные требования
+
+Перед установкой убедитесь, что у вас установлено:
+
+- **Python 3.9+** (рекомендуется 3.11+)
+- **pip** или **uv** для управления пакетами
+- Доступ к интернету для установки зависимостей
+
+### Из PyPI (рекомендуется)
+
+```bash
+pip install smart_bot_factory
+```
+
+### С помощью uv (современный менеджер пакетов)
+
+```bash
+uv add smart_bot_factory
+```
+
+### Из исходников (для разработки)
+
+```bash
+# Клонируйте репозиторий
+git clone https://github.com/yourusername/chat-bots.git
+cd chat-bots
+
+# Установите зависимости через uv
+uv sync
+
+# Или через pip
+pip install -e .
+```
+
+### Установка определенной версии
+
+```bash
+pip install smart_bot_factory==0.1.8
+```
+
+### Проверка установки
+
+После установки проверьте доступность CLI:
+
+```bash
+sbf --help
+```
+
+Вы должны увидеть список доступных команд.
+
+### Настройка внешних сервисов
+
+Для работы бота вам понадобятся:
+
+1. **Telegram Bot Token**
+   - Создайте бота через [@BotFather](https://t.me/botfather)
+   - Получите токен вида `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`
+
+2. **OpenAI API Key**
+   - Зарегистрируйтесь на [platform.openai.com](https://platform.openai.com)
+   - Создайте API ключ в разделе API Keys
+   - Ключ имеет вид `sk-...`
+
+3. **Supabase Project**
+   - Создайте проект на [supabase.com](https://supabase.com)
+   - Получите URL проекта и `anon` ключ в Project Settings → API
+   - Импортируйте SQL схему из `smart_bot_factory/database/schema.sql`
+
+## ⚡ Быстрый старт
+
+### 1. Создайте нового бота
+
+```bash
+sbf create my-bot
+```
+
+Это создаст:
+- 📁 `bots/my-bot/` - папка с конфигурацией бота
+- 📄 `my-bot.py` - основной файл запуска
+- ⚙️ `bots/my-bot/.env` - конфигурация окружения
+- 📝 `bots/my-bot/prompts/` - промпты для AI
+- 🧪 `bots/my-bot/tests/` - тестовые сценарии
+
+### 2. Настройте переменные окружения
+
+Отредактируйте `bots/my-bot/.env`:
+
+```env
+# Telegram
+TELEGRAM_BOT_TOKEN=your_bot_token
+
+# Supabase
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_KEY=your_supabase_key
+
+# OpenAI
+OPENAI_API_KEY=sk-your-openai-key
+OPENAI_MODEL=gpt-4o-mini
+
+# Администраторы
+ADMIN_TELEGRAM_IDS=123456789,987654321
+```
+
+### 3. Запустите бота
+
+```bash
+sbf run my-bot
+```
+
+## 📚 Архитектура
+
+### Router System
+
+Smart Bot Factory использует **два типа роутеров** для организации обработчиков:
+
+1. **EventRouter** - для бизнес-логики (события, задачи, глобальные обработчики)
+2. **TelegramRouter** - для Telegram команд, сообщений и callback'ов
+
+```python
+from smart_bot_factory.router import EventRouter, TelegramRouter
+from smart_bot_factory.message import send_message_by_human
+from smart_bot_factory.creation import BotBuilder
+from aiogram import F
+from aiogram.filters import Command
+from aiogram.types import Message
+from aiogram.fsm.context import FSMContext
+
+# EventRouter - для бизнес-логики
+event_router = EventRouter("my_bot_events")
+
+@event_router.event_handler("appointment_booking", notify=True)
+async def handle_booking(user_id: int, event_data: str):
+    """Обработчик записи на прием"""
+    await send_message_by_human(
+        user_id=user_id,
+        message_text=f"✅ Запись подтверждена! {event_data}"
+    )
+    return {"status": "success"}
+
+# TelegramRouter - для Telegram команд и сообщений
+telegram_router = TelegramRouter("my_bot_telegram")
+
+@telegram_router.router.message(Command("price", "цена"))
+async def handle_price(message: Message, state: FSMContext):
+    """Обработчик команды /price"""
+    await message.answer("💰 Наши цены...")
+
+@telegram_router.router.message(F.text.contains("помощь"))
+async def handle_help(message: Message, state: FSMContext):
+    """Обработчик запросов помощи"""
+    await message.answer("📖 Чем могу помочь?")
+
+# Запуск бота
+async def main():
+    bot = BotBuilder("my-bot")
+    
+    # Регистрируем роутеры (можно по одному или несколько сразу)
+    bot.register_routers(event_router)  # EventRouter
+    bot.register_telegram_routers(telegram_router)  # TelegramRouter
+    
+    await bot.build()
+    await bot.start()
+```
+
+### TelegramRouter - Обработчики Telegram
+
+**TelegramRouter** позволяет добавлять пользовательские команды и обработчики сообщений в Telegram бота, используя стандартный aiogram API:
+
+#### Команды
+
+```python
+from smart_bot_factory.router import TelegramRouter
+from aiogram.filters import Command
+from aiogram.types import Message
+from aiogram.fsm.context import FSMContext
+
+telegram_router = TelegramRouter("my_commands")
+
+@telegram_router.router.message(Command("start", "старт"))
+async def cmd_start(message: Message, state: FSMContext):
+    """Обработчик команды /start"""
+    await message.answer("👋 Привет!")
+
+@telegram_router.router.message(Command("price"))
+async def cmd_price(message: Message, state: FSMContext):
+    """Обработчик команды /price"""
+    await message.answer("💰 Цены:\n1. Базовый - 1000₽\n2. Премиум - 5000₽")
+```
+
+#### Фильтры по тексту
+
+```python
+from aiogram import F
+
+@telegram_router.router.message(F.text.lower().contains("цена"))
+async def handle_price_question(message: Message, state: FSMContext):
+    """Когда пользователь спрашивает о цене"""
+    await message.answer("💡 Используйте /price для просмотра цен")
+
+@telegram_router.router.message(F.text.startswith("!"))
+async def handle_commands(message: Message, state: FSMContext):
+    """Обработка кастомных команд с !"""
+    command = message.text[1:]
+    await message.answer(f"Выполняю команду: {command}")
+```
+
+#### Callback Query
+
+```python
+from aiogram.types import CallbackQuery, InlineKeyboardMarkup, InlineKeyboardButton
+
+@telegram_router.router.callback_query(F.data.startswith("buy_"))
+async def handle_buy(callback: CallbackQuery, state: FSMContext):
+    """Обработка покупки"""
+    product_id = callback.data.split("_")[1]
+    await callback.answer("Оформляем...")
+    await callback.message.answer(f"✅ Товар {product_id} добавлен в корзину")
+
+@telegram_router.router.message(Command("catalog"))
+async def show_catalog(message: Message, state: FSMContext):
+    """Показывает каталог с кнопками"""
+    keyboard = InlineKeyboardMarkup(inline_keyboard=[
+        [InlineKeyboardButton(text="Купить товар 1", callback_data="buy_1")],
+        [InlineKeyboardButton(text="Купить товар 2", callback_data="buy_2")]
+    ])
+    await message.answer("🛍️ Каталог товаров:", reply_markup=keyboard)
+```
+
+#### Регистрация нескольких роутеров
+
+```python
+# Создаем несколько TelegramRouter для разных модулей
+commands_router = TelegramRouter("commands")
+admin_router = TelegramRouter("admin_commands")
+callbacks_router = TelegramRouter("callbacks")
+
+# Регистрируем все сразу
+bot_builder.register_telegram_routers(
+    commands_router,
+    admin_router,
+    callbacks_router
+)
+```
+
+**Важно:** TelegramRouter - это обертка над aiogram Router, предоставляющая доступ к полному функционалу aiogram через свойство `.router`.
+
+### EventRouter - Типы обработчиков событий
+
+#### 1. Event Handlers - Обработчики событий
+
+Немедленная обработка событий от AI:
+
+```python
+@router.event_handler("phone_collected", notify=True, once_only=True)
+async def handle_phone(user_id: int, event_data: str):
+    """Вызывается когда AI собирает номер телефона"""
+    # event_data содержит данные от AI
+    phone = parse_phone(event_data)
+    
+    # Сохраняем в CRM
+    await save_to_crm(user_id, phone)
+    
+    return {"status": "saved", "phone": phone}
+```
+
+**Параметры:**
+- `notify` - уведомлять админов (default: False)
+- `once_only` - выполнить только один раз (default: True)
+
+#### 2. Scheduled Tasks - Запланированные задачи
+
+Задачи с отложенным выполнением для конкретного пользователя:
+
+```python
+@router.schedule_task("send_reminder", delay="2h", smart_check=True)
+async def send_reminder(user_id: int, reminder_text: str):
+    """Отправит напоминание через 2 часа"""
+    await send_message_by_human(
+        user_id=user_id,
+        message_text=f"🔔 {reminder_text}"
+    )
+    return {"status": "sent"}
+```
+
+**Параметры:**
+- `delay` - задержка (обязательно): `"1h"`, `"30m"`, `"2h 15m"`, `3600`
+- `smart_check` - умная проверка активности (default: True)
+- `once_only` - выполнить только один раз (default: True)
+- `event_type` - привязка к событию для напоминаний
+
+**Smart Check:**
+- Отменяет задачу если пользователь перешел на другой этап
+- Переносит выполнение если пользователь был активен недавно
+- Сохраняет session_id для точного отслеживания
+
+#### 3. Global Handlers - Глобальные обработчики
+
+Массовые действия для всех пользователей:
+
+```python
+@router.global_handler("mass_notification", delay="1h", notify=True)
+async def send_announcement(announcement_text: str):
+    """Отправит анонс всем пользователям через 1 час"""
+    from smart_bot_factory.message import send_message_to_users_by_stage
+    
+    await send_message_to_users_by_stage(
+        stage="introduction",
+        message_text=announcement_text,
+        bot_id="my-bot"
+    )
+    
+    return {"status": "completed"}
+```
+
+**Параметры:**
+- `delay` - задержка (обязательно)
+- `notify` - уведомлять админов (default: False)
+- `once_only` - выполнить только один раз (default: True)
+
+### Event-Based Reminders
+
+Напоминания о событиях за определенное время:
+
+```python
+# Сначала создаем обработчик события
+@router.event_handler("appointment_booking")
+async def handle_booking(user_id: int, event_data: str):
+    """Сохраняет запись: имя, телефон, дата, время"""
+    return {"status": "saved", "data": event_data}
+
+# Затем создаем напоминание
+@router.schedule_task(
+    "appointment_reminder",
+    delay="2h",
+    event_type="appointment_booking"  # Привязка к событию
+)
+async def remind_about_appointment(user_id: int, reminder_text: str):
+    """Отправит напоминание за 2 часа до записи"""
+    await send_message_by_human(
+        user_id=user_id,
+        message_text=f"⏰ Напоминание о записи через 2 часа!"
+    )
+    return {"status": "sent"}
+```
+
+Система автоматически:
+1. Извлечет дату/время из события `appointment_booking`
+2. Вычислит время напоминания (за 2 часа до записи)
+3. Запланирует отправку в правильное время
+
+## 🛠️ CLI Команды
+
+```bash
+# Создание и управление ботами
+sbf create <bot-id>              # Создать нового бота
+sbf create <bot-id> <template>   # Создать из шаблона
+sbf copy <source> <new-id>       # Копировать существующего бота
+sbf list                         # Показать всех ботов
+sbf rm <bot-id>                  # Удалить бота
+
+# Запуск
+sbf run <bot-id>                 # Запустить бота
+
+# Тестирование
+sbf test <bot-id>                # Запустить все тесты
+sbf test <bot-id> --file quick_scenarios.yaml
+sbf test <bot-id> -v             # Подробный вывод
+sbf test <bot-id> --max-concurrent 10
+
+# Промпты
+sbf prompts <bot-id>             # Список промптов
+sbf prompts <bot-id> --edit welcome_message
+sbf prompts <bot-id> --add new_prompt
+
+# Конфигурация
+sbf config <bot-id>              # Редактировать .env
+sbf path                         # Показать путь к проекту
+sbf link                         # Генератор UTM-ссылок
+```
+
+## 📝 Система промптов
+
+Промпты хранятся в `bots/<bot-id>/prompts/`:
+
+- `welcome_message.txt` - Приветственное сообщение
+- `help_message.txt` - Справка для пользователя
+- `1sales_context.txt` - Контекст продаж
+- `2product_info.txt` - Информация о продукте
+- `3objection_handling.txt` - Работа с возражениями
+- `final_instructions.txt` - Финальные инструкции для AI
+
+AI автоматически получает доступ к зарегистрированным обработчикам через промпт.
+
+## 🧪 Тестирование
+
+Создайте тестовые сценарии в YAML:
+
+```yaml
+# bots/my-bot/tests/scenarios.yaml
+scenarios:
+  - name: "Запись на прием"
+    steps:
+      - user: "Привет!"
+        expect_stage: "introduction"
+      
+      - user: "Хочу записаться на прием"
+        expect_stage: "qualification"
+        expect_events:
+          - type: "appointment_request"
+      
+      - user: "Меня зовут Иван, +79991234567, завтра в 15:00"
+        expect_events:
+          - type: "appointment_booking"
+          - type: "appointment_reminder"  # Должно запланироваться
+        expect_quality: ">= 8"
+```
+
+Запуск:
+```bash
+sbf test my-bot --file scenarios.yaml -v
+```
+
+## 💬 Отправка сообщений
+
+### Отправка пользователю
+
+```python
+from smart_bot_factory.message import send_message_by_human
+
+await send_message_by_human(
+    user_id=123456789,
+    message_text="Привет! Это сообщение от системы",
+    session_id="optional-session-id"
+)
+```
+
+### Массовая рассылка по этапу
+
+```python
+from smart_bot_factory.message import send_message_to_users_by_stage
+
+await send_message_to_users_by_stage(
+    stage="introduction",
+    message_text="📢 Важное объявление!",
+    bot_id="my-bot"
+)
+```
+
+## 🗄️ База данных
+
+Smart Bot Factory использует Supabase со следующими таблицами:
+
+- `sales_users` - Пользователи
+- `sales_chat_sessions` - Сессии диалогов
+- `sales_chat_messages` - История сообщений
+- `scheduled_events` - Запланированные события и задачи
+- `admin_sessions` - Сессии администраторов
+
+SQL схема доступна в `smart_bot_factory/database/`.
+
+## 👥 Система администрирования
+
+Добавьте ID администраторов в `.env`:
+
+```env
+ADMIN_TELEGRAM_IDS=123456789,987654321
+ADMIN_SESSION_TIMEOUT_MINUTES=30
+```
+
+Админы получают:
+- 📊 Статистику и аналитику
+- 🔔 Уведомления о важных событиях (если `notify=True`)
+- 🛠️ Доступ к специальным командам
+
+## 🔧 Продвинутое использование
+
+### Множественные роутеры
+
+#### Регистрация нескольких EventRouter
+
+```python
+# handlers/main.py
+main_router = EventRouter("main")
+
+# handlers/admin.py
+admin_router = EventRouter("admin")
+
+# handlers/payments.py
+payments_router = EventRouter("payments")
+
+# app.py
+bot = BotBuilder("my-bot")
+
+# Можно по одному
+bot.register_router(main_router)
+bot.register_router(admin_router)
+
+# Или все сразу
+bot.register_routers(main_router, admin_router, payments_router)
+```
+
+#### Регистрация нескольких TelegramRouter
+
+```python
+# telegram/commands.py
+commands_router = TelegramRouter("commands")
+
+@commands_router.router.message(Command("start"))
+async def start(message: Message, state: FSMContext):
+    await message.answer("Привет!")
+
+# telegram/callbacks.py
+callbacks_router = TelegramRouter("callbacks")
+
+@callbacks_router.router.callback_query(F.data.startswith("action_"))
+async def handle_action(callback: CallbackQuery, state: FSMContext):
+    await callback.answer("Выполнено!")
+
+# app.py
+bot = BotBuilder("my-bot")
+
+# Регистрируем несколько Telegram роутеров сразу
+bot.register_telegram_routers(commands_router, callbacks_router)
+```
+
+#### Комбинирование EventRouter и TelegramRouter
+
+```python
+# Создаем роутеры для разных целей
+event_router = EventRouter("events")
+telegram_router = TelegramRouter("telegram_handlers")
+
+# EventRouter - бизнес-логика
+@event_router.event_handler("payment_success")
+async def handle_payment(user_id: int, event_data: str):
+    await send_message_by_human(user_id, "✅ Оплата получена!")
+    return {"status": "success"}
+
+# TelegramRouter - пользовательские команды
+@telegram_router.router.message(Command("balance"))
+async def check_balance(message: Message, state: FSMContext):
+    await message.answer("💰 Ваш баланс: 1000₽")
+
+# Регистрируем оба типа роутеров
+bot_builder.register_routers(event_router)
+bot_builder.register_telegram_routers(telegram_router)
+```
+
+### Вложенные роутеры (EventRouter)
+
+```python
+main_router = EventRouter("main")
+payments_router = EventRouter("payments")
+
+# Включаем роутер платежей в основной
+main_router.include_router(payments_router)
+
+bot.register_router(main_router)
+```
+
+### Работа с клиентами
+
+```python
+from smart_bot_factory.supabase import SupabaseClient
+
+# Создаем клиент для вашего бота
+supabase = SupabaseClient("my-bot")
+
+# Используем напрямую
+users = supabase.client.table('sales_users').select('*').eq('bot_id', 'my-bot').execute()
+```
+
+## 📊 Структура проекта
+
+```
+my-project/
+├── bots/                      # Папка с ботами
+│   ├── my-bot/
+│   │   ├── .env              # Конфигурация
+│   │   ├── prompts/          # AI промпты
+│   │   ├── tests/            # Тестовые сценарии
+│   │   ├── files/            # Файлы бота
+│   │   ├── welcome_files/    # Приветственные файлы
+│   │   └── reports/          # Отчеты тестов
+│   └── another-bot/
+│       └── ...
+├── my-bot.py                 # Основной файл запуска
+├── another-bot.py
+└── .env                      # Глобальная конфигурация (опционально)
+```
+
+## 🔄 Примеры
+
+### Полный пример бота
+
+```python
+import asyncio
+
+from smart_bot_factory.router import EventRouter, TelegramRouter
+from smart_bot_factory.message import send_message_by_human, send_message_to_users_by_stage
+from smart_bot_factory.supabase import SupabaseClient
+from smart_bot_factory.creation import BotBuilder
+from aiogram import F
+from aiogram.filters import Command
+from aiogram.types import Message
+from aiogram.fsm.context import FSMContext
+
+# Инициализация
+event_router = EventRouter("medical_bot_events")
+telegram_router = TelegramRouter("medical_bot_telegram")
+supabase_client = SupabaseClient("medical-bot")
+
+# Пользовательские команды (TelegramRouter)
+@telegram_router.router.message(Command("appointment", "запись"))
+async def cmd_appointment(message: Message, state: FSMContext):
+    """Команда для записи на прием"""
+    await message.answer(
+        "📅 Для записи на прием укажите:\n"
+        "- Ваше имя\n"
+        "- Телефон\n"
+        "- Желаемая дата и время"
+    )
+
+@telegram_router.router.message(F.text.lower().contains("цена"))
+async def handle_price_question(message: Message, state: FSMContext):
+    """Вопросы о ценах"""
+    await message.answer("💰 Используйте /appointment для записи и уточнения стоимости")
+
+# Обработчик записи на прием (EventRouter)
+@event_router.event_handler("appointment_booking", notify=True)
+async def handle_appointment(user_id: int, event_data: str):
+    """Обрабатывает запись на прием к врачу"""
+    # event_data: "имя: Иван, телефон: +79991234567, дата: 2025-10-15, время: 14:00"
+    
+    await send_message_by_human(
+        user_id=user_id,
+        message_text="✅ Запись подтверждена! Ждем вас."
+    )
+    
+    return {"status": "success", "data": event_data}
+
+# Напоминание за 2 часа до приема (EventRouter)
+@event_router.schedule_task(
+    "appointment_reminder",
+    delay="2h",
+    event_type="appointment_booking"
+)
+async def remind_before_appointment(user_id: int, reminder_text: str):
+    """Напоминание о записи"""
+    await send_message_by_human(
+        user_id=user_id,
+        message_text="⏰ Напоминаем о вашей записи через 2 часа!"
+    )
+    return {"status": "sent"}
+
+# Ночной дайджест для всех (EventRouter)
+@event_router.global_handler("daily_digest", delay="24h")
+async def send_daily_digest(digest_text: str):
+    """Отправляет ежедневный дайджест всем активным пользователям"""
+    await send_message_to_users_by_stage(
+        stage="active",
+        message_text=f"📊 Дайджест дня:\n\n{digest_text}",
+        bot_id="medical-bot"
+    )
+
+# Запуск
+async def main():
+    bot = BotBuilder("medical-bot")
+    
+    # Регистрируем роутеры
+    bot.register_routers(event_router)  # EventRouter
+    bot.register_telegram_routers(telegram_router)  # TelegramRouter
+    
+    await bot.build()
+    await bot.start()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## 🐛 Отладка
+
+Включите режим отладки в `.env`:
+
+```env
+DEBUG_MODE=true
+LOG_LEVEL=DEBUG
+```
+
+Это покажет:
+- JSON ответы от AI
+- Детальные логи обработки
+- Информацию о роутерах и обработчиках
+
+## 📋 Требования
+
+### Системные
+- Python 3.9+ (рекомендуется 3.11+)
+- pip или uv для управления пакетами
+
+### Основные зависимости
+- aiogram 3.4.1+ - Telegram Bot API
+- supabase 2.3.4+ - База данных
+- openai 1.12.0+ - AI модель
+- click 8.0.0+ - CLI интерфейс
+- python-dotenv 1.0.1+ - Управление переменными окружения
+
+Все зависимости устанавливаются автоматически при установке библиотеки.
+
+### Внешние сервисы
+- Telegram Bot Token ([@BotFather](https://t.me/botfather))
+- OpenAI API Key ([platform.openai.com](https://platform.openai.com))
+- Supabase Project ([supabase.com](https://supabase.com))
+
+Подробнее см. раздел [Установка](#-установка).
+
+## 🤝 Вклад в проект
+
+Мы приветствуем вклад в развитие проекта! 
+
+## 📄 Лицензия
+
+MIT License - см. [LICENSE](LICENSE)
+
+## 🔗 Полезные ссылки
+
+- [Документация Supabase](https://supabase.com/docs)
+- [Документация OpenAI](https://platform.openai.com/docs)
+- [Документация aiogram](https://docs.aiogram.dev/)
+
+## 💡 Поддержка
+
+Если у вас возникли вопросы или проблемы, создайте issue в репозитории.
+
+---
+
+Сделано с ❤️ для создания умных ботов

{smart_bot_factory-0.1.8.dist-info → smart_bot_factory-0.2.0.dist-info}/RECORD

@@ -26,29 +26,30 @@ smart_bot_factory/configs/growthmed-october-24/welcome_file/welcome_file_msg.txt
 smart_bot_factory/configs/growthmed-october-24/welcome_file/Чек лист по 152ФЗ и 323ФЗ для медицины.pdf,sha256=BiAiQHNnQXJPMsks9AeL6s0beEjRFkRMJLMlAn4WorA,5284954
 smart_bot_factory/core/bot_utils.py,sha256=XmwQ31LOpE_Wudx4OO4tlnVwse3YagakwpgN2cZC5SQ,41085
 smart_bot_factory/core/conversation_manager.py,sha256=eoHL7MCEz68DRvTVwRwZgf2PWwGv4T6J9D-I-thETi8,28289
-smart_bot_factory/core/decorators.py,sha256=BuG5nyDXnz7Gp0W7eQOEXxkdpkqgGwdu-7QVgBJXRYs,68647
+smart_bot_factory/core/decorators.py,sha256=xQCtr5SOLqqmEzaxrDf_sfxWQouIG7riI6Sa_jqGlcg,68647
 smart_bot_factory/core/message_sender.py,sha256=7uZlMw7bdLb_2eokANUxyP4HomVQV7T2mrl4SBTfqNM,19134
-smart_bot_factory/core/router.py,sha256=Ly2Kj6T9stu2UmE__3CvMvN8Rl1Ipo-SrsbTsiPSssA,11469
-smart_bot_factory/core/router_manager.py,sha256=qncd57qhqXBV42FBEQ8Wl7aar8S7WZnfSC4EQ1BIr0w,9617
+smart_bot_factory/core/router.py,sha256=o-AzLarBgYbXq7OeeXQEfa6XFqcAtLKqf5-3Do79Boo,11555
+smart_bot_factory/core/router_manager.py,sha256=dUwesog-oHk1U2EDdS8p0e4MTSkwtx5_qXn6nrJ9l9I,9700
 smart_bot_factory/core/states.py,sha256=AOc19_yAsDW_8md-2oiowjBhuW3bwcsmMxszCXWZZTQ,355
+smart_bot_factory/core/telegram_router.py,sha256=LcPLOd87Y4Y4YN6TBXVAtmpSp8gAK2otgMI4YS5f5tk,2091
 smart_bot_factory/creation/__init__.py,sha256=IgDk8GDS3pg7Pw_Et41J33ZmeZIU5dRwQdTmYKXfJfE,128
-smart_bot_factory/creation/bot_builder.py,sha256=c3maqY9qJBsRJO3kI4iko2oKf0JrjECUV_XRrImlgQQ,22169
+smart_bot_factory/creation/bot_builder.py,sha256=xWgWRe4DV3PngiLoQlzm6AdhNvPqn3wOCwcgsIoh-QA,25220
 smart_bot_factory/creation/bot_testing.py,sha256=JDWXyJfZmbgo-DLdAPk8Sd9FiehtHHa4sLD17lBrTOc,55669
 smart_bot_factory/database/database_structure.sql,sha256=26gFtMC2jdQGQF7Zb_F4Br56rMd4hUDTk9FkNZYneLo,2789
 smart_bot_factory/database/schema.sql,sha256=-6kOmA9QnSkUtmGI2iQRbTvbdiqOhEOQcuz1lJn79mU,28059
 smart_bot_factory/event/__init__.py,sha256=hPL449RULIOB-OXv1ZbGNiHctAYaOMUqhSWGPrDHYBM,212
 smart_bot_factory/handlers/handlers.py,sha256=YH8xG0tDcb7uxZXI4socXURzc-y57_FEQ6GqTgYcM5Q,37603
 smart_bot_factory/integrations/openai_client.py,sha256=aMcDrKO0GEx3ZSVEOGDeDtFCDWSXs6biUfgrbRK8yTU,23180
-smart_bot_factory/integrations/supabase_client.py,sha256=FLYD4gOSBAAukzExImFB4NLlNmBJPgI3d24Vht0A_uQ,45074
+smart_bot_factory/integrations/supabase_client.py,sha256=AfALLZdDYeMWHLJw6POTGiBd-sH3i03oT6tT7m9C28I,44644
 smart_bot_factory/message/__init__.py,sha256=6QvjdfF99venyDB9udZv9WDNjIHJLNuaVhYdTK3a44A,282
-smart_bot_factory/router/__init__.py,sha256=fLXSXfa-MaI9ickXoqha3PqpjxunsNLyVNlHIoIbr1c,115
+smart_bot_factory/router/__init__.py,sha256=QrfO5u8H2uVzWGMtBvNKunsJAv7UrKtvt2f_D5xSFWE,270
 smart_bot_factory/supabase/__init__.py,sha256=XmZP6yM9ffERM5ddAWyJnrNzEhCYtMu3AcjVCi1rOf8,179
 smart_bot_factory/supabase/client.py,sha256=8_-I3kxZQlKQElI4cTUjNGYcqlyIyEkSrUZaP0nfNNU,26044
 smart_bot_factory/utils/__init__.py,sha256=5zNjw491bj5VkOhoEAwh2hjmv8nldyDOTrG7pbGpz6A,285
 smart_bot_factory/utils/debug_routing.py,sha256=BOoDhKBg7UXe5uHQxRk3TSfPfLPOFqt0N7lAo6kjCOo,4719
 smart_bot_factory/utils/prompt_loader.py,sha256=JSn7CsWnToSbHYtURdeuZn7ectyDqQGrPGHN2ixIGkw,19930
-smart_bot_factory-0.1.8.dist-info/METADATA,sha256=6JJ-TmhTcre_FFDNiHfqGOvQnG90UXZm1UZB172mjIQ,3528
-smart_bot_factory-0.1.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-smart_bot_factory-0.1.8.dist-info/entry_points.txt,sha256=ybKEAI0WSb7WoRiey7QE-HHfn88UGV7nxLDxXq7b7SU,50
-smart_bot_factory-0.1.8.dist-info/licenses/LICENSE,sha256=OrK3cwdUTzNzIhJvSPtJaVMoYIyC_sSx5EFE_FDMvGs,1092
-smart_bot_factory-0.1.8.dist-info/RECORD,,
+smart_bot_factory-0.2.0.dist-info/METADATA,sha256=WEC38O2La8OlQpfCZWkXjhMU70VigduV0wIrferi2w0,28224
+smart_bot_factory-0.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+smart_bot_factory-0.2.0.dist-info/entry_points.txt,sha256=ybKEAI0WSb7WoRiey7QE-HHfn88UGV7nxLDxXq7b7SU,50
+smart_bot_factory-0.2.0.dist-info/licenses/LICENSE,sha256=OrK3cwdUTzNzIhJvSPtJaVMoYIyC_sSx5EFE_FDMvGs,1092
+smart_bot_factory-0.2.0.dist-info/RECORD,,

smart_bot_factory-0.1.8.dist-info/METADATA

@@ -1,126 +0,0 @@
-Metadata-Version: 2.4
-Name: smart-bot-factory
-Version: 0.1.8
-Summary: Библиотека для создания умных чат-ботов
-Author-email: Kopatych <kopatych@example.com>
-License: MIT
-License-File: LICENSE
-Keywords: chatbot,cli,openai,supabase,telegram
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Framework :: AsyncIO
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Communications :: Chat
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.9
-Requires-Dist: aiofiles>=23.0.0
-Requires-Dist: aiogram>=3.4.1
-Requires-Dist: click>=8.0.0
-Requires-Dist: openai>=1.12.0
-Requires-Dist: project-root-finder>=1.9
-Requires-Dist: python-dotenv>=1.0.1
-Requires-Dist: pytz>=2023.3
-Requires-Dist: pyyaml>=6.0.2
-Requires-Dist: supabase>=2.3.4
-Description-Content-Type: text/markdown
-
-# Smart Bot Factory
-
-Библиотека для создания умных чат-ботов с использованием OpenAI, Telegram и Supabase.
-
-## Установка
-
-```bash
-pip install smart-bot-factory
-```
-
-## Быстрый старт
-
-1. Создайте нового бота:
-```bash
-sbf create my-bot
-```
-
-2. Настройте конфигурацию в `bots/my-bot/.env`
-
-3. Запустите бота:
-```bash
-sbf run my-bot
-```
-
-## Возможности
-
-- 🤖 Интеграция с OpenAI GPT для умных ответов
-- 📱 Поддержка Telegram Bot API через aiogram
-- 💾 Хранение данных в Supabase
-- 🔄 Система событий и обработчиков
-- ⏰ Планировщик задач
-- 🧪 Встроенная система тестирования
-- 📝 Управление промптами
-- 🛠️ Удобный CLI интерфейс
-
-## CLI команды
-
-```bash
-# Создать нового бота
-sbf create my-bot
-
-# Запустить бота
-sbf run my-bot
-
-# Показать список ботов
-sbf list
-
-# Управление промптами
-sbf prompts my-bot --list
-sbf prompts my-bot --edit welcome_message
-sbf prompts my-bot --add new_prompt
-
-# Запустить тесты
-sbf test my-bot
-```
-
-## Пример использования
-
-```python
-from smart_bot_factory import BotBuilder, event_handler, schedule_task
-
-# Обработчик события
-@event_handler("book_appointment", "Запись на прием")
-async def handle_booking(user_id: int, event_data: dict):
-    # Логика обработки записи на прием
-    return {"status": "success"}
-
-# Запланированная задача
-@schedule_task("send_reminder", "Отправка напоминания")
-async def send_reminder(user_id: int, message: str):
-    # Логика отправки напоминания
-    return {"status": "sent"}
-
-# Запуск бота
-async def main():
-    bot = BotBuilder("my-bot")
-    await bot.build()
-    await bot.start()
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## Требования
-
-- Python 3.9+
-- OpenAI API ключ
-- Telegram Bot Token
-- Supabase проект
-
-## Лицензия
-
-MIT