smart-bot-factory 0.2.0__tar.gz → 0.2.1__tar.gz

smart_bot_factory-0.2.1/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(awk:*)",
+      "Bash(python:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

smart_bot_factory-0.2.1/.env.example

@@ -0,0 +1,40 @@
+# Telegram
+TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here
+
+# Supabase
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_KEY=your_supabase_anon_key
+
+# OpenAI
+OPENAI_API_KEY=sk-your-openai-api-key
+OPENAI_MODEL=gpt-5-mini
+OPENAI_MAX_TOKENS=1500
+OPENAI_TEMPERATURE=0.7
+
+# Промпты (каталог)
+PROMT_FILES_DIR=prompts
+
+# Файл после приветствия с подписью (если он есть - грузим его в папку welcome_file, если нет - ничего не делаем)
+WELCOME_FILE_URL=welcome_file/
+WELCOME_FILE_MSG=welcome_file_msg.txt
+
+# 🆕 Администраторы (через запятую)
+# Укажите Telegram ID админов
+ADMIN_TELEGRAM_IDS=123456789,987654321
+ADMIN_SESSION_TIMEOUT_MINUTES=30
+
+# 🆕 Режим отладки (показывать JSON пользователям)
+DEBUG_MODE=false
+
+# Дополнительные настройки
+MAX_CONTEXT_MESSAGES=50
+LOG_LEVEL=INFO
+MESSAGE_PARSE_MODE=Markdown
+
+# Настройки продаж
+LEAD_QUALIFICATION_THRESHOLD=7
+SESSION_TIMEOUT_HOURS=24
+
+# ⚠️ ВАЖНО: BOT_ID теперь НЕ нужен в .env!
+# Bot ID автоматически определяется из имени файла запускалки
+# Например: python growthmed-october-24.py → BOT_ID = growthmed-october-24

{smart_bot_factory-0.2.0 → smart_bot_factory-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: smart-bot-factory
-Version: 0.2.0
+Version: 0.2.1
 Summary: Библиотека для создания умных чат-ботов
 Author-email: Kopatych <kopatych@example.com>
 License: MIT

{smart_bot_factory-0.2.0 → smart_bot_factory-0.2.1}/best-valera.py

@@ -18,15 +18,43 @@ telegram_router_2 = TelegramRouter("best-valera_telegram_2")
 
 supabase_client = SupabaseClient("best-valera")
 
+# =============================================================================
+# ИНИЦИАЛИЗАЦИЯ BOT BUILDER (нужен для декоратора on_start)
+# =============================================================================
+
+bot_builder = BotBuilder("best-valera")
+
 # =============================================================================
 # TELEGRAM ОБРАБОТЧИКИ (используем прямой aiogram API)
 # =============================================================================
 
 from aiogram import F
 from aiogram.filters import Command
-from aiogram.types import Message, CallbackQuery
+from aiogram.types import Message, CallbackQuery, InlineKeyboardMarkup, InlineKeyboardButton
 from aiogram.fsm.context import FSMContext
 
+# =============================================================================
+# ОБРАБОТЧИК on_start (вызывается после стандартного /start)
+# =============================================================================
+
+@bot_builder.on_start
+async def custom_start_handler(user_id: int, session_id: str, message: Message, state: FSMContext):
+    """
+    Вызывается после стандартной логики /start
+    Здесь можно отправить дополнительные сообщения, кнопки и т.д.
+    """
+    # Пример: отправляем сообщение с кнопками
+    keyboard = InlineKeyboardMarkup(inline_keyboard=[
+        [InlineKeyboardButton(text="📖 Каталог", callback_data="catalog")],
+        [InlineKeyboardButton(text="💰 Цены", callback_data="prices")],
+        [InlineKeyboardButton(text="📞 Связаться", callback_data="contact")]
+    ])
+    
+    await message.answer(
+        "🎯 Что вас интересует?",
+        reply_markup=keyboard
+    )
+
 @telegram_router_1.router.message(Command("price", "цена"))
 async def handle_price_command(message: Message, state: FSMContext):
     """Обработчик команды /price"""
@@ -42,6 +70,25 @@ async def handle_price_question(message: Message, state: FSMContext):
     """Обработчик вопросов о цене"""
     await message.answer("💡 Напишите /price чтобы увидеть актуальные цены")
 
+# Обработчики callback'ов от кнопок в on_start
+@telegram_router_1.router.callback_query(F.data == "catalog")
+async def handle_catalog(callback: CallbackQuery, state: FSMContext):
+    """Обработка кнопки Каталог"""
+    await callback.answer()
+    await callback.message.answer("📖 Вот наш каталог товаров:\n\n1. Товар 1\n2. Товар 2\n3. Товар 3")
+
+@telegram_router_1.router.callback_query(F.data == "prices")
+async def handle_prices(callback: CallbackQuery, state: FSMContext):
+    """Обработка кнопки Цены"""
+    await callback.answer()
+    await callback.message.answer("💰 Наши цены:\n\n📦 Базовый - 1000₽\n📦 Премиум - 5000₽")
+
+@telegram_router_1.router.callback_query(F.data == "contact")
+async def handle_contact(callback: CallbackQuery, state: FSMContext):
+    """Обработка кнопки Связаться"""
+    await callback.answer()
+    await callback.message.answer("📞 Свяжитесь с нами:\n\nТелефон: +7 (999) 123-45-67\nEmail: info@example.com")
+
 # =============================================================================
 # ОБРАБОТЧИКИ СОБЫТИЙ (бизнес-логика)
 # =============================================================================
@@ -97,8 +144,7 @@ async def send_global_announcement(announcement_text: str):
 async def main():
     """Основная функция запуска бота"""
     try:
-        # Создаем и собираем бота
-        bot_builder = BotBuilder("best-valera")
+        # bot_builder уже создан выше (для декоратора @bot_builder.on_start)
         
         # Регистрируем роутеры ПЕРЕД сборкой (можно по одному или несколько сразу)
         bot_builder.register_routers(event_router)  # Роутеры событий

{smart_bot_factory-0.2.0 → smart_bot_factory-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "smart-bot-factory"
-version = "0.2.0"
+version = "0.2.1"
 description = "Библиотека для создания умных чат-ботов"
 authors = [
     {name = "Kopatych", email = "kopatych@example.com"}

{smart_bot_factory-0.2.0 → smart_bot_factory-0.2.1}/smart_bot_factory/creation/bot_builder.py

@@ -46,6 +46,7 @@ class BotBuilder:
         self.prompt_loader: Optional[PromptLoader] = None
         self.router_manager: Optional[RouterManager] = None
         self._telegram_routers: List = []  # Список Telegram роутеров
+        self._start_handlers: List = []  # Список обработчиков on_start
         
         # Флаги инициализации
         self._initialized = False
@@ -326,6 +327,37 @@ class BotBuilder:
         
         logger.info(f"✅ Зарегистрировано {len(telegram_routers)} Telegram роутеров")
     
+    def on_start(self, handler):
+        """
+        Регистрирует обработчик, который вызывается после стандартной логики /start
+        
+        Обработчик получает доступ к:
+        - user_id: int - ID пользователя Telegram
+        - session_id: str - ID созданной сессии
+        - message: Message - Объект сообщения от aiogram
+        - state: FSMContext - Контекст состояния
+        
+        Args:
+            handler: Async функция с сигнатурой:
+                     async def handler(user_id: int, session_id: str, message: Message, state: FSMContext)
+        
+        Example:
+            @bot_builder.on_start
+            async def my_start_handler(user_id, session_id, message, state):
+                keyboard = InlineKeyboardMarkup(...)
+                await message.answer("Выберите действие:", reply_markup=keyboard)
+        """
+        if not callable(handler):
+            raise TypeError(f"Обработчик должен быть callable, получен {type(handler)}")
+        
+        self._start_handlers.append(handler)
+        logger.info(f"✅ Зарегистрирован обработчик on_start: {handler.__name__}")
+        return handler  # Возвращаем handler для использования как декоратор
+    
+    def get_start_handlers(self) -> List:
+        """Получает список обработчиков on_start"""
+        return self._start_handlers.copy()
+    
     def get_router_manager(self) -> RouterManager:
         """Получает менеджер роутеров событий"""
         return self.router_manager
@@ -374,6 +406,7 @@ class BotBuilder:
                 handlers_module.admin_manager = self.admin_manager
                 handlers_module.analytics_manager = self.analytics_manager
                 handlers_module.conversation_manager = self.conversation_manager
+                handlers_module.start_handlers = self._start_handlers  # Передаем обработчики on_start
                 logger.info("✅ Глобальные переменные установлены в handlers")
             except Exception as e:
                 logger.warning(f"⚠️ Не удалось установить глобальные переменные в handlers: {e}")

{smart_bot_factory-0.2.0 → smart_bot_factory-0.2.1}/smart_bot_factory/handlers/handlers.py

@@ -277,6 +277,23 @@ async def user_start_handler(message: Message, state: FSMContext):
         
         logging.info(f"✅ Приветственное сообщение успешно сохранено в БД для сессии {session_id}")
         
+        # ВЫЗЫВАЕМ ПОЛЬЗОВАТЕЛЬСКИЕ ОБРАБОТЧИКИ on_start
+        start_handlers = get_global_var('start_handlers')
+        if start_handlers:
+            logger.info(f"🔔 Вызов {len(start_handlers)} пользовательских обработчиков on_start")
+            for handler in start_handlers:
+                try:
+                    await handler(
+                        user_id=message.from_user.id,
+                        session_id=session_id,
+                        message=message,
+                        state=state
+                    )
+                    logger.info(f"✅ Обработчик on_start '{handler.__name__}' выполнен успешно")
+                except Exception as handler_error:
+                    logger.error(f"❌ Ошибка в обработчике on_start '{handler.__name__}': {handler_error}")
+                    # Продолжаем выполнение остальных обработчиков
+        
     except Exception as e:
         logger.error(f"Ошибка при обработке user /start: {e}")
         await send_message(message, "Произошла ошибка при инициализации. Попробуйте позже.")

{smart_bot_factory-0.2.0 → smart_bot_factory-0.2.1}/uv.lock

@@ -1259,7 +1259,7 @@ wheels = [
 
 [[package]]
 name = "smart-bot-factory"
-version = "0.1.9"
+version = "0.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "aiofiles" },