Files
tg_tinder_bot/docs/DEPLOYMENT.md
2025-09-18 08:31:14 +09:00

4.5 KiB
Raw Permalink Blame History

🚀 Checklist для запуска Telegram Tinder Bot

Предварительные требования

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

  • Node.js 16+ установлен
  • PostgreSQL 12+ установлен (или Docker)
  • Git установлен

Telegram Bot Setup

  • Создать бота через @BotFather
  • Получить Bot Token
  • Настроить команды бота:
start - Начать знакомство
profile - Мой профиль
browse - Смотреть анкеты
matches - Мои матчи
settings - Настройки
help - Помощь

🛠️ Установка и настройка

1. Клонирование и установка

git clone <repository-url>
cd telegram-tinder-bot
chmod +x setup.sh
./setup.sh

2. Настройка конфигурации

  • Скопировать .env.example в .env
  • Заполнить TELEGRAM_BOT_TOKEN
  • Настроить подключение к базе данных

3. База данных

  • Создать базу данных telegram_tinder_bot
  • Запустить миграции:
psql -d telegram_tinder_bot -f src/database/migrations/init.sql

🔧 Конфигурация .env файла

# Обязательные настройки
TELEGRAM_BOT_TOKEN=your_bot_token_here
DB_HOST=localhost
DB_PORT=5432
DB_NAME=telegram_tinder_bot
DB_USERNAME=postgres
DB_PASSWORD=your_password

# Опциональные настройки
NODE_ENV=production
PORT=3000
UPLOAD_PATH=./uploads
MAX_FILE_SIZE=5242880

🚀 Запуск бота

Разработка

npm run dev

Продакшен (PM2)

npm run build
npm run start:prod

Docker

docker-compose up -d

🧪 Тестирование

Проверка компиляции

npm run build

Проверка подключения к БД

npm run test:db

Ручное тестирование

  • Отправить /start боту
  • Пройти регистрацию
  • Загрузить фото
  • Попробовать поиск анкет
  • Создать тестовый матч

📊 Мониторинг

Логи

  • Проверить logs/ папку
  • Настроить ротацию логов
  • Мониторинг ошибок

Метрики

  • Количество пользователей
  • Активность регистраций
  • Количество матчей
  • Объем сообщений

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

Обязательно

  • Изменить пароли по умолчанию
  • Настроить файрвол
  • Ограничить доступ к БД
  • Регулярные бэкапы

Опционально

  • SSL сертификаты
  • Rate limiting
  • IP whitelist для админки

🚨 Troubleshooting

Частые проблемы

Bot не отвечает:

  • Проверить токен в .env
  • Проверить сетевое подключение
  • Посмотреть логи ошибок

Ошибки БД:

  • Проверить настройки подключения
  • Убедиться что PostgreSQL запущен
  • Проверить права доступа

Ошибки компиляции:

  • Обновить Node.js
  • Переустановить зависимости: rm -rf node_modules && npm install

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

# Перезапуск бота
pm2 restart telegram-tinder-bot

# Просмотр логов
pm2 logs telegram-tinder-bot

# Статус процессов
pm2 status

# Остановка бота
pm2 stop telegram-tinder-bot

📞 Поддержка

При возникновении проблем:

  1. Проверьте логи в logs/error.log
  2. Убедитесь в правильности конфигурации
  3. Проверьте статус всех сервисов
  4. Создайте issue с описанием проблемы

Полезные ресурсы:


🎉 После выполнения всех пунктов ваш Telegram Tinder Bot готов к работе!