GitHub - fedorabakumets/telegram-bot-builder: 🤖 Визуальный конструктор Telegram ботов с drag-and-drop интерфейсом. Создавайте ботов без программирования, получайте готовый Python код для aiogram. React + TypeScript frontend, Express.js backend, PostgreSQL. Поддержка медиа, клавиатур, условной логики и аналитики пользователей.

Создавайте Telegram ботов без программирования!

Визуальный конструктор с drag-and-drop интерфейсом, где вы просто перетаскиваете блоки на холст, а готовый бот появляется сам.

💡 Идеально подходит для малого бизнеса, фрилансеров и тех, кто хочет быстро запустить бота, не изучая программирование.

📞 Связь с нами

🏗️ Архитектура системы

🎨 Frontend

React + TypeScript

Визуальный редактор

• Drag-and-drop интерфейс
• Панель настроек блоков
• Управление проектами

🖥️ Backend

Express.js + Node.js

API сервер

• REST API для данных
• Генерация Python кода
• Загрузка медиафайлов

🗄️ База данных

PostgreSQL + Drizzle

Хранение данных

• Проекты и схемы ботов
• Пользователи и настройки
• Медиафайлы

☁️ Деплой

Railway + Python

Запуск ботов

• Автогенерация кода
• Готовые Python боты
• Облачный хостинг

🔄 Поток данных

📋 Подробное описание потока (нажми для раскрытия)

👤 Пользователь создает схему бота в визуальном редакторе
🎨 Frontend отправляет изменения через WebSocket для реального времени
📡 API Server валидирует данные и сохраняет в PostgreSQL
🤖 Generator преобразует схему в Python код с aiogram
☁️ Deployment автоматически деплоит на Railway
📱 Telegram получает webhook и начинает обрабатывать сообщения
📊 Analytics собирает статистику использования в реальном времени

📁 Структура проекта

Показать структуру проекта

📦 telegram-bot-builder/
┣ 📂 client/                     # 🎨 React Frontend
┃ ┣ 📂 components/               # UI компоненты
┃ ┃ ┣ 📂 editor/                 # Визуальный редактор
┃ ┃ ┃ ┣ 📂 bot/                  # Компоненты бота
┃ ┃ ┃ ┣ 📂 canvas/               # Холст редактора
┃ ┃ ┃ ┣ 📂 code/                 # Редактор кода
┃ ┃ ┃ ┣ 📂 database/             # Управление БД
┃ ┃ ┃ ┣ 📂 google-sheets/        # Интеграция с Google Sheets
┃ ┃ ┃ ┣ 📂 groups/               # Управление группами
┃ ┃ ┃ ┣ 📂 properties/           # Панель свойств
┃ ┃ ┃ ┣ 📂 template/             # Шаблоны
┃ ┃ ┃ ┗ 📄 emoji-picker.tsx      # Выбор эмодзи
┃ ┃ ┣ 📂 layout/                 # Компоненты макета
┃ ┃ ┣ 📂 media/                  # Медиа компоненты
┃ ┃ ┣ 📂 ui/                     # Базовые UI элементы
┃ ┃ ┗ 📄 theme-provider.tsx      # Провайдер темы
┃ ┣ 📂 contexts/                 # React контексты
┃ ┣ 📂 hooks/                    # React хуки
┃ ┣ 📂 lib/                      # Библиотеки и утилиты
┃ ┃ ┣ 📂 generate/               # Генерация кода
┃ ┃ ┣ 📂 database/               # Работа с БД
┃ ┃ ┣ 📂 MessageHandlers/        # Обработчики сообщений
┃ ┃ ┣ 📂 CommandHandler/         # Обработчики команд
┃ ┃ ┣ 📂 Keyboard/               # Генерация клавиатур
┃ ┃ ┣ 📂 MediaHandler/           # Обработка медиа
┃ ┃ ┣ 📂 UserHandler/            # Обработка пользователей
┃ ┃ ┣ 📂 Conditional/            # Условная логика
┃ ┃ ┣ 📂 scaffolding/            # Каркас генерации
┃ ┃ ┗ 📄 bot-generator.ts        # Генератор ботов
┃ ┣ 📂 pages/                    # Страницы приложения
┃ ┣ 📂 types/                    # TypeScript типы
┃ ┣ 📂 utils/                    # Утилиты
┃ ┣ 📄 App.tsx                   # Главный компонент
┃ ┗ 📄 main.tsx                  # Точка входа
┣ 📂 server/                     # 🖥️ Express Backend
┃ ┣ 📂 auth/                     # Аутентификация
┃ ┣ 📂 bots/                     # Управление ботами
┃ ┃ ┣ 📄 startBot.ts             # Запуск бота
┃ ┃ ┣ 📄 stopBot.ts              # Остановка бота
┃ ┃ ┗ 📄 restartBotIfRunning.ts  # Перезапуск бота
┃ ┣ 📂 database/                 # Работа с БД
┃ ┃ ┣ 📄 db.ts                   # Подключение к БД
┃ ┃ ┣ 📄 db-routes.ts            # Маршруты БД
┃ ┃ ┣ 📄 db-utils.ts             # Утилиты БД
┃ ┃ ┗ 📄 init-db.ts              # Инициализация БД
┃ ┣ 📂 files/                    # Работа с файлами
┃ ┣ 📂 google-sheets/            # Интеграция с Google Sheets
┃ ┣ 📂 routes/                   # API маршруты
┃ ┃ ┣ 📄 routes.ts               # Основные маршруты
┃ ┃ ┣ 📄 setupProjectRoutes.ts   # Маршруты проектов
┃ ┃ ┣ 📄 setupBotManagementRoutes.ts  # Управление ботами
┃ ┃ ┗ 📄 setupGithubPushRoute.ts # GitHub синхронизация
┃ ┣ 📂 storages/                 # Хранилища
┃ ┣ 📂 telegram/                 # Telegram API
┃ ┃ ┣ 📄 telegram-client.ts      # Клиент Telegram
┃ ┃ ┣ 📄 telegram-media.ts       # Медиа Telegram
┃ ┃ ┗ 📄 auth-middleware.ts      # Аутентификация Telegram
┃ ┣ 📂 terminal/                 # Терминал
┃ ┣ 📂 utils/                    # Утилиты сервера
┃ ┗ 📄 index.ts                  # Точка входа сервера
┣ 📂 shared/                     # 🔗 Общие модули
┃ ┣ 📄 schema.ts                 # Drizzle ORM схемы
┃ ┗ 📄 scaffolding-wrapper.ts    # Обёртка генерации
┣ 📂 config/                     # ⚙️ Конфигурация
┃ ┗ 📂 google-auth/              # Google OAuth
┣ 📂 bots/                       # 🤖 Сгенерированные боты
┃ ┗ 📄 *.py                      # Python боты
┣ 📂 migrations/                 # 🗄️ Миграции БД
┣ 📂 uploads/                    # 📁 Загруженные файлы
┣ 📂 assets/                     # 🖼️ Ресурсы
┃ ┗ 📂 images/                   # Изображения
┣ 📂 docs/                       # 📚 Документация
┃ ┣ 📂 deployment/               # Деплой
┃ ┣ 📂 development/              # Разработка
┃ ┣ 📂 features/                 # Функции
┃ ┣ 📂 analysis/                 # Анализ
┃ ┗ 📄 COMPONENTS.md             # Компоненты
┣ 📂 scripts/                    # 📜 Скрипты
┣ 📂 dist/                       # 📦 Сбилденные файлы
┣ 📄 package.json                # 📦 Зависимости Node.js
┣ 📄 tsconfig.json               # ⚙️ Настройки TypeScript
┣ 📄 vite.config.ts              # ⚡ Конфигурация Vite
┣ 📄 drizzle.config.ts           # 🗄️ Настройки Drizzle ORM
┗ 📄 .env.example                # 🔐 Пример переменных окружения

📡 API Endpoints

🔗 Основные API маршруты (нажми для раскрытия)

🎯 Категория	📡 Endpoint	📝 Описание
📋 Проекты	`GET /api/projects`	Список проектов пользователя
	`POST /api/projects`	Создать новый проект
	`PUT /api/projects/{id}`	Обновить проект
	`DELETE /api/projects/{id}`	Удалить проект
🧩 Узлы	`GET /api/projects/{id}/nodes`	Получить схему бота
	`POST /api/projects/{id}/nodes`	Добавить узел
	`PUT /api/projects/{id}/nodes/{nodeId}`	Обновить узел
	`DELETE /api/projects/{id}/nodes/{nodeId}`	Удалить узел
🤖 Боты	`POST /api/bots/{id}/generate`	Сгенерировать Python код
	`POST /api/bots/{id}/deploy`	Задеплоить бота
	`GET /api/bots/{id}/status`	Статус бота
	`POST /api/bots/{id}/stop`	Остановить бота
📁 Медиа	`POST /api/media/upload`	Загрузить файл
	`GET /api/media/{id}`	Скачать файл
	`DELETE /api/media/{id}`	Удалить файл
📊 Статистика	`GET /api/bots/{id}/stats`	Статистика использования
	`GET /api/bots/{id}/users`	Пользователи бота
	`GET /api/bots/{id}/messages`	История сообщений

🎯 Основные возможности

🎨 Создавайте ботов перетаскиванием - никакого кода, просто перемещайте блоки мышкой
💬 Отправляйте сообщения - с форматированием, кнопками и медиафайлами
🎨 Красивые интерфейсы - встроенные и обычные клавиатуры
📁 Работа с медиа - фото, видео, аудио, документы
📝 Сбор данных - формы для сбора информации от пользователей
🧠 Логика и условия - "если произошло то-то, то сделай это"
👥 База пользователей - автоматически собирает информацию о пользователях
📊 Статистика - смотрите, кто написал боту, какие команды использует
🎭 Светлая и темная темы - удобно работать днем и ночью
📱 Работает на мобильных телефонах - создавайте ботов с планшета или смартфона, интерфейс адаптирован для всех устройств

☁️ Деплой в облако

Railway (рекомендуется)

Зарегистрируйтесь на Railway.app
Создайте новый проект
Подключите репозиторий с кодом
Добавьте переменные окружения (см. docs/deployment/RAILWAY_DEPLOY.md)
Создайте PostgreSQL базу данных
Запустите миграции базы данных

Подробные инструкции по деплою на Railway смотрите в файле docs/deployment/RAILWAY_DEPLOY.md.

📜 Пошаговая инструкция

Требования

Node.js ≥ 18.0.0
PostgreSQL ≥ 15
Python ≥ 3.10 (для сгенерированных ботов)
Git

Шаг 1: Обновление системы и установка зависимостей

🐧 Linux (Ubuntu/Debian) 🏁 Windows 🍎 macOS

Способ 1: Через терминал (рекомендуется):

Ubuntu/Debian:

sudo apt update && sudo apt install -y git

Fedora/CentOS:

sudo dnf install -y git

Arch Linux:

sudo pacman -S git

Способ 2: С сайта:

Перейдите на git-scm.com/install/linux
Выберите ваш дистрибутив
Следуйте инструкции по установке

Проверка установки:

git --version

Способ 1: Через winget (рекомендуется):

winget install --id Git.Git -e --source winget

Способ 2: Через установщик:

Скачайте с git-scm.com/install/windows
Запустите .exe файл
Оставьте настройки по умолчанию (нажимайте "Next")

Проверка установки: Откройте PowerShell от имени администратора (Win + X → "Терминал (администратор)"):

git --version

Если версия не отображается, перезапустите PowerShell

Способ 1: Через Homebrew (рекомендуется):

# Установка Homebrew (если не установлен)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Установка Git
brew install git

Способ 2: С сайта:

Перейдите на git-scm.com/install/mac
Скачайте установщик для macOS (.dmg)
Откройте .dmg файл и перетащите Git в Applications

Проверка установки:

git --version

Homebrew — менеджер пакетов для macOS, упрощает установку программ

Шаг 2: Установка Node.js LTS

🐧 Linux 🏁 Windows 🍎 macOS

Способ 1: Через терминал (рекомендуется):

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
node -v && npm -v

Способ 2: С сайта:

Перейдите на nodejs.org
Скачайте .deb или .rpm пакет
Установите: sudo dpkg -i nodejs_*.deb

Способ 1: Через winget:

winget install OpenJS.NodeJS.LTS
node -v && npm -v

Способ 2: С сайта:

Перейдите на nodejs.org
Скачайте установщик (.msi)
Запустите и следуйте инструкциям
Проверьте установку:

node -v
npm -v

Способ 1: Через Homebrew:

brew install node@lts
node -v && npm -v

Способ 2: С сайта:

Перейдите на nodejs.org
Скачайте установщик (.pkg)
Запустите и следуйте инструкциям

Шаг 3: Установка PostgreSQL

🐧 Linux 🏁 Windows 🍎 macOS

Способ 1: Через терминал:

sudo apt install -y postgresql postgresql-contrib
sudo systemctl enable postgresql
sudo systemctl start postgresql

Способ 2: Официальный репозиторий:

Посетите postgresql.org/download/linux
Выберите дистрибутив
Следуйте инструкции

Способ 1: Через winget:

winget install PostgreSQL.PostgreSQL

Способ 2: С сайта:

Перейдите на postgresql.org/download/windows
Скачайте установщик
Запустите и запомните пароль postgres

Способ 1: Через Homebrew:

brew install postgresql@15
brew services start postgresql@15

Способ 2: С сайта:

Перейдите на postgresql.org/download/macosx
Скачайте установщик
Запустите и следуйте инструкциям

Шаг 4: Установка Python 3

🐧 Linux 🏁 Windows 🍎 macOS

Способ 1: Через терминал:

sudo apt install -y python3 python3-venv python3-pip
python3 --version

Способ 2: Официальный сайт:

Посетите python.org/downloads
Выберите версию для Linux
Следуйте инструкции по компиляции

Способ 1: Через winget:

winget install Python.Python.3.12

Способ 2: С сайта:

Перейдите на python.org/downloads
Скачайте установщик
При установке отметьте "Add Python to PATH"
Проверьте установку:

python --version

Способ 1: Через Homebrew:

brew install python
python3 --version

Способ 2: С сайта:

Перейдите на python.org/downloads
Скачайте установщик для macOS (.pkg)
Запустите и следуйте инструкциям

Шаг 5: Настройка базы данных

🐧 Linux

🏁 Windows

🍎 macOS

sudo -u postgres psql

CREATE USER tbb WITH PASSWORD 'builder2025!' LOGIN;
CREATE DATABASE telegram_bot_builder OWNER tbb;
GRANT ALL PRIVILEGES ON DATABASE telegram_bot_builder TO tbb;
GRANT ALL ON SCHEMA public TO tbb;
\q

psql -U postgres

CREATE USER tbb WITH PASSWORD 'builder2025!' LOGIN;
CREATE DATABASE telegram_bot_builder OWNER tbb;
GRANT ALL PRIVILEGES ON DATABASE telegram_bot_builder TO tbb;
GRANT ALL ON SCHEMA public TO tbb;
\q

psql postgres

CREATE USER tbb WITH PASSWORD 'builder2025!' LOGIN;
CREATE DATABASE telegram_bot_builder OWNER tbb;
GRANT ALL PRIVILEGES ON DATABASE telegram_bot_builder TO tbb;
GRANT ALL ON SCHEMA public TO tbb;
\q

Шаг 6: Клонирование проекта

🐧 Linux

🏁 Windows

🍎 macOS

cd /opt
sudo git clone https://github.com/fedorabakumets/telegram-bot-builder.git
sudo chown -R "$USER":"$USER" telegram-bot-builder
cd telegram-bot-builder

mkdir C:\projects
cd C:\projects
git clone https://github.com/fedorabakumets/telegram-bot-builder.git
cd telegram-bot-builder

mkdir -p ~/projects
cd ~/projects
git clone https://github.com/fedorabakumets/telegram-bot-builder.git
cd telegram-bot-builder

Шаг 7: Настройка окружения

Пример .env для всех систем:

NODE_ENV=development
PORT=5000
DATABASE_URL=postgresql://tbb:builder2025!@localhost:5432/telegram_bot_builder

🐧 Linux	🏁 Windows	🍎 macOS
cp .env.example .env nano .env	copy .env.example .env notepad .env	cp .env.example .env nano .env

Шаг 8: Установка зависимостей и запуск

1. Установка зависимостей:

npm install

2. Запуск приложения:

Режим	Команда	Описание
🧪 Разработка	`npm run dev`	Запуск с автоперезагрузкой при изменениях
🚀 Продакшен	`npm run build` → `npm run start`	Сборка и запуск готовой версии

✅ Готово! Приложение доступно по адресу: http://localhost:5000

🐳 Альтернатива: Docker (любая ОС)

Требования: Docker и Docker Compose

git clone https://github.com/fedorabakumets/telegram-bot-builder.git
cd telegram-bot-builder
docker compose up -d
docker compose logs -f

Полезные команды:

docker compose down        # Остановить
docker compose build --no-cache  # Пересобрать
docker compose logs -f     # Логи

✅ Готово! Приложение доступно по адресу: http://localhost:5000

💡 Нужно обновить проект? См. 🔄 Как обновить проект с GitHub

🎓 Как создать своего первого бота?

Пошаговое руководство (нажми для раскрытия)

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

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

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

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

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

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

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

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

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

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

🧩 Типы блоков

Элементы для построения (нажми для раскрытия)

📨 Сообщения и контент

Блок	Что он делает
💬 Текстовое сообщение	Отправляет текст пользователю (можно добавить медиафайлы)
🎭 Стикер	Отправляет анимированный стикер
🎤 Голосовое сообщение	Отправляет голосовое сообщение
📍 Геолокация	Отправляет карту с координатами
📇 Контакт	Поделиться контактом

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

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

📸 Фотографии - изображения в формате JPG, PNG
🎬 Видео - видеоролики
🎵 Аудио файлы - музыка и голосовые записи
📄 Документы - файлы PDF, Word, Excel и другие
🎤 Аудиосообщения - голосовые сообщения от пользователя

Или используйте отдельный блок:

🎤 Голосовое сообщение - специальный блок для отправки чистых аудио сообщений

Как использовать:

Выберите блок "Текстовое сообщение"
В панели свойств (справа) найдите раздел с медиафайлами
Загрузите файл со своего компьютера
Бот будет отправлять его вместе с текстом!

⚙️ Команды (можно добавлять свои!)

Встроенные команды: /start, /help, /settings, /menu

Важно: Вы можете добавить любые свои команды! Например:

/price - показать цены
/order - оформить заказ
/support - получить поддержку
/about - информация о компании

👥 Управление пользователями

Заблокировать пользователя - запретить участию в группе
Разблокировать - снять блокировку с участника
Заглушить пользователя - ограничить право голоса участника
Снять ограничения - восстановить права участника
Исключить пользователя - удалить участника из группы

📝 Управление контентом

Закрепить сообщение - закрепить сообщение в группе
Открыть сообщение - опубликовать сообщение в группе
Удалить сообщение - удалить сообщение из группы

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

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

Кнопки - пользователь выбирает один из вариантов, и бот переходит на нужное сообщение
Ожидание ввода - бот ждет ответ от пользователя, затем переходит на следующее сообщение
Автопереход - переход к следующему блоку автоматически без ожидания
Условные переходы - "если произошло то-то, то на другое сообщение..." (указывается в свойствах)

📚 Пример: Простой бот для пиццерии

🍕 Пошаговый пример создания бота (нажми для раскрытия)

🎯 Что мы создадим:

Полнофункциональный бот для приема заказов пиццы с меню, выбором и подтверждением

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

🚀 СТАРТ

Команда /start

⬇️

💬 ПРИВЕТСТВИЕ

"Добро пожаловать! Выберите пиццу 🍕"

⬇️

🍕 ВЫБОР ПИЦЦЫ

🍕 Маргарита 🍕 Пепперони 🥬 Вегетарианская

⬇️

📝 АДРЕС ДОСТАВКИ

"Введите ваш адрес доставки"

⬇️

✅ ПОДТВЕРЖДЕНИЕ

Проверка заказа

⬇️

🚗 ГОТОВО!

"Спасибо за заказ! Ожидайте доставку"

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

📋 Подробная инструкция (нажми для раскрытия)

🎯 Шаг 1: Создание проекта

Откройте Telegram Bot Builder
Создайте новый проект "Пиццерия"
Получите токен от @BotFather

🧩 Шаг 2: Добавление блоков

Стартовое сообщение → "Добро пожаловать! Выберите пиццу 🍕"
Кнопки выбора → ["🍕 Маргарита", "🍕 Пепперони", "🥬 Вегетарианская"]
Сообщение с ожиданием → "Введите ваш адрес доставки"
Финальное сообщение → "Спасибо за заказ! Ожидайте доставку 🚗"

⚙️ Шаг 3: Настройка переходов

Старт → Приветствие (автопереход)
Приветствие → Выбор пиццы (кнопки)
Выбор пиццы → Адрес (любая кнопка)
Адрес → Подтверждение (ожидание ввода)

🚀 Шаг 4: Запуск и тестирование

Нажмите "Сгенерировать код"
Скачайте готовый Python файл
Запустите бота и протестируйте

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

🐍 Посмотреть автоматически созданный Python код (нажми чтобы раскрыть)

# 🤖 Автоматически сгенерированный бот для пиццерии
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())

🎯 Результат

⚡ Быстро

10 минут от идеи
до готового бота

🎯 Просто

Без единой строки
программирования

🚀 Готово

Бот готов принимать
заказы прямо сейчас!

📚 Документация

Вся документация проекта организована в папке docs/ и разделена по категориям для удобного поиска

🛠️ Разработчикам

📋 Настройка проекта
Пошаговое руководство по установке

🔧 Устранение неполадок
Решение частых проблем

🤝 Для контрибьюторов
Как участвовать в разработке

📄 Спецификация
Техническое описание

🚀 Деплой

🚂 Railway
Развертывание на Railway (рекомендуется)

🐳 Docker
Контейнеризация приложения

☁️ VPS
Развертывание на собственном сервере

⚙️ CI/CD
Автоматическое развертывание

📊 Анализ

🏗️ Структура проекта
Детальный анализ архитектуры

🔧 Инфраструктура
Технические решения

📈 Производительность
Оптимизация и мониторинг

🧪 Тестирование
Стратегии тестирования

🔒 Безопасность

🛡️ Обновление проекта
Как обновить проект с GitHub

🔐 Аутентификация
Защита пользовательских данных

🚨 Мониторинг
Отслеживание угроз

📋 Аудит
Проверка безопасности

📖 Быстрый доступ к документации

🗂️ Полная структура документации (нажми для раскрытия)

📂 docs/
├── 📁 development/              # 🛠️ Документация для разработчиков
│   ├── 📄 SETUP.md             # Настройка окружения разработки
│   ├── 📄 TROUBLESHOOTING_RU.md # Устранение неполадок
│   ├── 📄 CONTRIBUTING.md       # Руководство для контрибьюторов
│   ├── 📄 REQUIREMENTS_SPECIFICATION.md # Техническая спецификация
│   └── 📄 HOW_TO_UPDATE.md     # Как обновить проект
│
├── 📁 deployment/               # 🚀 Руководства по развертыванию
│   ├── 📄 RAILWAY_DEPLOY.md    # Развертывание на Railway
│   ├── 📄 RAILWAY_CLI_GUIDE.md # Руководство по Railway CLI
│   └── 📄 RAILWAY_TROUBLESHOOTING.md # Устранение проблем
│
├── 📁 analysis/                 # 📊 Анализ проекта
│   ├── 📄 PROJECT_STRUCTURE_ANALYSIS.md # Анализ структуры
│   ├── 📄 PROJECT_STRUCTURE_DIAGRAM.md # Диаграмма структуры
│   └── 📄 INFRASTRUCTURE_ANALYSIS.md    # Анализ инфраструктуры
│
├── 📄 COMPONENTS.md            # 🧩 Компоненты проекта
└── 📄 README.md                # 📚 Индекс документации

📋 Системные требования

Технические требования (нажми для раскрытия)

💻 Компонент	⚡ Минимум	🚀 Рекомендуемо	🎯 Оптимально
Node.js	18.0	20.0+	22.0+ LTS
PostgreSQL	13	15+	16+ Latest
Python	3.11	3.12+	3.13+ Latest
RAM	1 GB	2+ GB	4+ GB
Диск	500 MB	1+ GB	2+ GB SSD

🖥️ Поддерживаемые ОС

🚀 Развертывание готового бота

После создания бота, приложение генерирует Python файл. Вы можете:

Скачать готовый код
Запустить локально на своем компьютере:
- На Windows, Mac или Linux
- Просто установите Python и запустите файл
- Идеально для тестирования перед публикацией
Развернуть на хостинге для постоянной работы:
- Railway - современная платформа для деплоя
- VPS (DigitalOcean, Linode, AWS) - полный контроль
- Cloud Run - от Google для больших нагрузок
Модифицировать если нужна специальная логика

Подробные инструкции по деплою на Railway смотрите в файле docs/deployment/RAILWAY_DEPLOY.md.

📄 Лицензия

MIT License - используйте свободно для личных и коммерческих целей.

🤝 Помощь и поддержка

🆘 Быстрая помощь

🐛 Нашли баг?

💡 Есть идея?

📖 Нужна помощь?

🤝 Хотите помочь?

Name		Name	Last commit message	Last commit date
Latest commit History 5,145 Commits
.railway		.railway
.vscode		.vscode
assets		assets
bots		bots
client		client
config/google-auth		config/google-auth
docs		docs
lib		lib
migrations		migrations
public		public
scripts		scripts
server		server
shared		shared
uploads		uploads
.c8rc.json		.c8rc.json
.dockerignore		.dockerignore
.env.example		.env.example
.env.production		.env.production
.env.railway		.env.railway
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.node-version		.node-version
.npmrc		.npmrc
.nvmrc		.nvmrc
.railwayignore		.railwayignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
_tmp_ict_d02.py		_tmp_ict_d02.py
components.json		components.json
docker-compose.yml		docker-compose.yml
drizzle.config.ts		drizzle.config.ts
eslint.config.js		eslint.config.js
global.d.ts		global.d.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
pyproject.toml		pyproject.toml
railway.json		railway.json
railway.toml		railway.toml
requirements.txt		requirements.txt
run-tests.js		run-tests.js
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json
tsconfig.lib-check.json		tsconfig.lib-check.json
tsconfig.node.json		tsconfig.node.json
tsconfig.server.json		tsconfig.server.json
tsconfig.templates.json		tsconfig.templates.json
vite.config.ts		vite.config.ts
vitest.config.ts		vitest.config.ts
vitest.lib.config.ts		vitest.lib.config.ts

Folders and files

Latest commit

History

Repository files navigation

📞 Связь с нами

🏗️ Архитектура системы

🎨 Frontend

🖥️ Backend

🗄️ База данных

☁️ Деплой

🔄 Поток данных

📁 Структура проекта

📡 API Endpoints

🎯 Основные возможности

☁️ Деплой в облако

Railway (рекомендуется)

📜 Пошаговая инструкция

Требования

🎓 Как создать своего первого бота?

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

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

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

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

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

🧩 Типы блоков

📨 Сообщения и контент

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

⚙️ Команды (можно добавлять свои!)

👥 Управление пользователями

📝 Управление контентом

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

📚 Пример: Простой бот для пиццерии

🎯 Что мы создадим:

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

🚀 СТАРТ

💬 ПРИВЕТСТВИЕ

🍕 ВЫБОР ПИЦЦЫ

📝 АДРЕС ДОСТАВКИ

✅ ПОДТВЕРЖДЕНИЕ

🚗 ГОТОВО!

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

🎯 Шаг 1: Создание проекта

🧩 Шаг 2: Добавление блоков

⚙️ Шаг 3: Настройка переходов

🚀 Шаг 4: Запуск и тестирование

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

🎯 Результат

⚡ Быстро

🎯 Просто

🚀 Готово

📚 Документация

🛠️ Разработчикам

🚀 Деплой

📊 Анализ

🔒 Безопасность

📖 Быстрый доступ к документации

📋 Системные требования

🖥️ Поддерживаемые ОС

🚀 Развертывание готового бота

📄 Лицензия

🤝 Помощь и поддержка

🆘 Быстрая помощь

🐛 Нашли баг?

💡 Есть идея?

📖 Нужна помощь?

🤝 Хотите помочь?

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 20

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages