Бот для поиска и мониторинга свободных мест на поездах РЖД с удобным интерфейсом и автоматическими уведомлениями.

• 🔍 Поиск поездов по маршруту и дате
• 🛏️ Выбор типа места (плацкарт, купе, СВ)
• ⬆️⬇️ Выбор полки для купе (верхняя/нижняя)
• 🔔 Автоматические уведомления о найденных местах
• 📊 История мониторинга и статистика
• 💾 База данных для хранения подписок
• 🎯 Удобный интерфейс с inline-кнопками

git clone <repository-url>
cd rzd

cp env.example .env
nano .env  # Отредактируйте файл и установите токен бота

1. Найдите @BotFather в Telegram
2. Отправьте команду /newbot
3. Следуйте инструкциям для создания бота
4. Скопируйте полученный токен в файл .env

docker-compose up -d

docker-compose stop

git clone <repository-url>
cd rzd

pip install -r requirements.txt

export TELEGRAM_BOT_TOKEN="your_bot_token_here"

1. Найдите @BotFather в Telegram
2. Отправьте команду /newbot
3. Следуйте инструкциям для создания бота
4. Скопируйте полученный токен

python run_bot.py

• /start - начать работу с ботом
• /help - справка по использованию
• /my_subscriptions - просмотр активных подписок

1. Ввод маршрута: Укажите станцию отправления и прибытия
2. Выбор даты: Введите дату поездки в формате ДД.ММ.ГГГГ
3. Выбор поезда: Выберите поезд из найденных вариантов
4. Настройка мониторинга: Выберите тип места и полку (для купе)
5. Получение уведомлений: Бот автоматически уведомит о найденных местах

rzd/
├── main.py              # Основной файл бота
├── rzd_parser.py        # Парсер данных с сайта РЖД
├── database.py          # Работа с базой данных
├── monitoring.py        # Сервис мониторинга
├── run_bot.py          # Скрипт запуска
├── requirements.txt     # Зависимости Python
├── Dockerfile          # Docker образ
├── docker-compose.yml  # Docker Compose конфигурация
├── env.example         # Пример переменных окружения
├── .dockerignore       # Исключения для Docker
├── README.md           # Документация
├── QUICK_START.md      # Быстрый старт
└── data/               # Данные (создается автоматически)
    └── rzd_bot.db      # База данных SQLite

Все настройки можно изменить в файле .env:

# Основные настройки
TELEGRAM_BOT_TOKEN=your_bot_token_here
MONITORING_INTERVAL=300  # Интервал проверки в секундах
LOG_LEVEL=INFO          # Уровень логирования

# Дополнительные настройки
MAX_RETRIES=3           # Количество попыток при ошибке
RETRY_DELAY=60         # Задержка между попытками

По умолчанию бот проверяет доступность мест каждые 5 минут. Для изменения интервала отредактируйте MONITORING_INTERVAL в файле .env.

Бот использует SQLite для хранения данных. База данных создается автоматически при первом запуске и сохраняется в папке data/.

Логи сохраняются в папку logs/ и выводятся в консоль. Для изменения уровня логирования отредактируйте LOG_LEVEL в файле .env.

# Просмотр логов
docker-compose logs -f rzd-bot

# Перезапуск бота
docker-compose restart rzd-bot

# Обновление образа
docker-compose pull && docker-compose up -d

# Полная остановка с удалением данных
docker-compose down -v

• users - информация о пользователях
• subscriptions - подписки на мониторинг
• notifications - история уведомлений
• check_history - история проверок доступности

1. Создайте новый модуль или расширьте существующий
2. Добавьте обработчики в main.py
3. Обновите базу данных при необходимости
4. Протестируйте функциональность

Для отладки включите подробное логирование:

logging.basicConfig(level=logging.DEBUG)

• Парсинг данных зависит от структуры сайта РЖД
• При изменении сайта может потребоваться обновление парсера
• Интервал проверки ограничен для избежания блокировки
• Требуется стабильное интернет-соединение

• Токен бота хранится в переменных окружения
• Данные пользователей шифруются в базе данных
• Ограничена частота запросов к сайту РЖД

Этот проект создан в образовательных целях. Используйте ответственно и в соответствии с правилами сайта РЖД.

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

1. Проверьте логи бота
2. Убедитесь в правильности токена
3. Проверьте подключение к интернету
4. Создайте issue в репозитории

Для обновления бота:

1. Остановите текущий процесс
2. Обновите код
3. Установите новые зависимости (если есть)
4. Перезапустите бота

Удачного использования! 🚂✨