BotBoard Travel Border Bot

Telegram-бот @vacation_sml_bot для помощи в поездке через границу Беларусь-Польша.

Возможности

Показывает очереди по польскому направлению с официальной страницы ГПК.
Выделяет самые свободные пункты пропуска по текущим числовым данным.
Отвечает на вопросы через AI с учетом свежих данных очередей.
Работает через long polling, поэтому не требует публичного webhook URL.

Локальный запуск

Создай .env рядом с .env.example.
Заполни переменные окружения:

TELEGRAM_BOT_TOKEN=...
BORDER_STATUS_URL=https://gpk.gov.by/situation-at-the-border/
AI_BASE_URL=https://uat1-www.a1.by:7443/aisearch
AI_API_KEY=...
AI_MODEL=gpt-5.5
REQUEST_TIMEOUT_SECONDS=20

Установи зависимости и запусти:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python -m app.main

Docker

docker compose up -d --build
docker compose logs -f botboard

Portainer

Открой Portainer.
Создай новый Stack.
Используй содержимое docker-compose.yml.
В рабочую директорию/репозиторий стека добавь .env с реальными секретами.
Запусти Deploy the stack.

Секреты не коммитятся: .env исключен через .gitignore и .dockerignore.

Команды бота

/start - стартовое меню.
/poland - очереди по Польше.
/best - лучшие пункты по минимальной очереди.
/ai вопрос - вопрос AI с учетом очередей.

Важно

Данные берутся из открытого официального источника ГПК. Бот помогает ориентироваться, но не заменяет официальные правила, требования к документам, визам и решения пограничных служб.

README.md Unescape Escape