test/BotBoard

BotBoard Travel Border Bot

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

Возможности

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

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

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

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

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

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

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

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

Команды бота

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

Важно

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