1. 👤 Пользователь создает схему бота в визуальном редакторе
2. 🎨 Frontend отправляет изменения через REST API, предлагает сохранить и перезапустить бота
3. 📡 API Server валидирует данные и сохраняет в PostgreSQL
4. 🤖 Generator преобразует схему в Python код с aiogram
5. ▶️ Запуск — бот запускается как Python-процесс на сервере (Worker Pool)
6. 📱 Telegram получает сообщения через polling (по умолчанию) или webhook
7. 📊 Analytics собирает статистику использования в реальном времени

📦 telegram-bot-builder/
┣ 📂 client/                     # 🎨 React Frontend
┃ ┣ 📂 components/               # UI компоненты
┃ ┃ ┣ 📂 editor/                 # Визуальный редактор
┃ ┃ ┃ ┣ 📂 app-sidebar/          # Навигация по вкладкам
┃ ┃ ┃ ┣ 📂 analytics/            # Панель аналитики
┃ ┃ ┃ ┣ 📂 bot/                  # Управление ботами
┃ ┃ ┃ ┣ 📂 broadcast/            # Рассылки
┃ ┃ ┃ ┣ 📂 canvas/               # Холст редактора (drag & drop)
┃ ┃ ┃ ┣ 📂 code/                 # Вкладка «Код бота»
┃ ┃ ┃ ┣ 📂 dialogs/              # Диалоги с пользователями
┃ ┃ ┃ ┣ 📂 properties/           # Панель свойств блоков
┃ ┃ ┃ ┣ 📂 sidebar/              # Панель компонентов
┃ ┃ ┃ ┗ 📂 users/                # Вкладка «Пользователи»
┃ ┃ ┣ 📂 ui/                     # Базовые UI элементы
┃ ┃ ┗ 📂 media/                  # Медиа компоненты
┃ ┣ 📂 hooks/                    # React хуки
┃ ┣ 📂 pages/                    # Страницы приложения
┃ ┣ 📂 storage/                  # Локальное хранилище
┃ ┣ 📂 types/                    # TypeScript типы
┃ ┣ 📂 utils/                    # Утилиты
┃ ┗ 📄 App.tsx                   # Главный компонент
┣ 📂 server/                     # 🖥️ Express Backend
┃ ┣ 📂 auth/                     # Аутентификация
┃ ┣ 📂 bots/                     # Запуск/остановка ботов
┃ ┣ 📂 database/                 # Работа с PostgreSQL
┃ ┣ 📂 files/                    # Работа с файлами
┃ ┣ 📂 handlers/                 # Обработчики запросов
┃ ┣ 📂 middleware/               # Middleware
┃ ┣ 📂 migrations/               # Миграции БД
┃ ┣ 📂 redis/                    # Redis (события, кэш)
┃ ┣ 📂 routes/                   # API маршруты
┃ ┣ 📂 services/                 # Бизнес-логика
┃ ┣ 📂 storages/                 # Хранилища данных
┃ ┣ 📂 telegram/                 # Telegram API клиент
┃ ┣ 📂 templates/                # Шаблоны генерации
┃ ┣ 📂 terminal/                 # Терминал ботов
┃ ┣ 📂 utils/                    # Утилиты сервера
┃ ┗ 📄 index.ts                  # Точка входа сервера
┣ 📂 shared/                     # 🔗 Общие модули (схемы, типы)
┣ 📂 bots/                       # 🤖 Сгенерированные Python-боты
┣ 📂 docs/                       # 📚 Документация
┃ ┣ 📂 analysis/                 # Анализ архитектуры
┃ ┣ 📂 deployment/               # Инструкции по деплою
┃ ┣ 📂 development/              # Для разработчиков
┃ ┣ 📂 features/                 # Описание фич
┃ ┣ 📂 futures/                  # Планы развития
┃ ┗ 📂 releases/                 # Заметки к релизам
┣ 📂 migrations/                 # 🗄️ Миграции Drizzle ORM
┣ 📂 uploads/                    # 📁 Загруженные медиафайлы
┣ 📂 scripts/                    # 📜 Вспомогательные скрипты
┣ 📄 package.json                # 📦 Зависимости Node.js
┣ 📄 tsconfig.json               # ⚙️ Настройки TypeScript
┣ 📄 vite.config.ts              # ⚡ Конфигурация Vite
┣ 📄 drizzle.config.ts           # 🗄️ Настройки Drizzle ORM
┣ 📄 docker-compose.yml          # 🐳 Docker конфигурация
┗ 📄 .env.example                # 🔐 Пример переменных окружения

Шаг 1: Получите токен для бота

1. Откройте Telegram и найдите @BotFather
2. Напишите /newbot и следуйте инструкциям
3. Вы получите токен вроде: 123456789:ABCdef...

Шаг 2: Откройте редактор

• При первом запуске у вас уже есть проект по умолчанию с узлом "Старт"
• Если нужен новый проект, откройте вкладку "Проекты" (слева) и нажмите кнопку "+ Новый"

Шаг 3: Добавьте токен бота

1. В правой части нажмите кнопку "Бот"
2. Вставьте токен, который вы получили от BotFather
3. Токен сохранится автоматически

Шаг 4: Постройте сценарий бота

1. Перетащите блок "Сообщение" на холст рядом с узлом "Старт"
2. Напишите текст, который бот должен отправить
3. В настройках блока укажите, что будет дальше:
   • Кнопки - для выбора вариантов ответа
   • Автопереход - перейти к другому блоку автоматически
   • Ожидание ввода - дождаться сообщения от пользователя
4. Добавьте еще блоки и настройте переходы между ними

Шаг 5: Запустите бота

1. Откройте вкладку "Бот" (справа внизу)
2. Нажмите кнопку "Запустить"
3. Откройте своего бота в Telegram
4. Тестируйте и улучшайте!

📨 Сообщения и триггеры

⌨️ Клавиатуры

👥 Группы

🔌 Интеграции и логика

📦 Медиафайлы в сообщениях

В свойствах текстового сообщения можно прикрепить:

• 📸 Фотографии — JPG, PNG
• 🎬 Видео — видеоролики
• 🎵 Аудио — музыка и записи
• 📄 Документы — PDF, Word, Excel и другие

🔄 Логика переходов

Настраивается в свойствах каждого блока:

• Кнопки — пользователь выбирает вариант, бот переходит на нужное сообщение
• Ожидание ввода — бот ждёт ответ, затем переходит дальше
• Автопереход — переход к следующему блоку автоматически
• Условные переходы — ветвление по значению переменных

💡 Список блоков постоянно пополняется. Следите за обновлениями!

🎨 Визуальная схема бота

🛠️ Пошаговое создание

💻 Сгенерированный код

# 🤖 Автоматически сгенерированный бот для пиццерии
import asyncio
from aiogram import Bot, Dispatcher, types
from aiogram.filters import Command
from aiogram.types import ReplyKeyboardMarkup, KeyboardButton

# 🔑 Токен бота (замените на свой)
bot = Bot(token="YOUR_BOT_TOKEN")
dp = Dispatcher()

def get_pizza_keyboard():
    """🍕 Клавиатура с выбором пиццы"""
    keyboard = ReplyKeyboardMarkup(
        keyboard=[
            [KeyboardButton(text="🍕 Маргарита")],
            [KeyboardButton(text="🍕 Пепперони")],
            [KeyboardButton(text="🥬 Вегетарианская")]
        ],
        resize_keyboard=True,
        one_time_keyboard=True
    )
    return keyboard

@dp.message(Command("start"))
async def start_handler(message: types.Message):
    """🚀 Обработчик команды /start"""
    await message.answer(
        "🍕 Добро пожаловать в пиццерию!\n"
        "Выберите пиццу из меню:",
        reply_markup=get_pizza_keyboard()
    )

@dp.message(lambda message: "🍕" in message.text or "🥬" in message.text)
async def pizza_selected(message: types.Message):
    """🍕 Обработчик выбора пиццы"""
    pizza_type = message.text
    await message.answer(
        f"✅ Отличный выбор: {pizza_type}!\n"
        f"📍 Введите ваш адрес доставки:",
        reply_markup=types.ReplyKeyboardRemove()
    )

@dp.message()
async def address_handler(message: types.Message):
    """📍 Обработчик адреса доставки"""
    address = message.text
    await message.answer(
        f"🎉 Спасибо за заказ!\n"
        f"📍 Адрес: {address}\n"
        f"🚗 Ожидайте доставку в течение 30-40 минут!\n"
        f"📞 Мы свяжемся с вами для подтверждения."
    )

# 🚀 Запуск бота
async def main():
    print("🤖 Бот пиццерии запущен!")
    await dp.start_polling(bot)

if __name__ == "__main__":
    asyncio.run(main())

🎯 Результат