Runbook

Runbook

Бот Не Отвечает

1. Проверить контейнер:

docker ps | grep 3xui-shop-bot
docker logs --tail=160 3xui-shop-bot

2. Проверить Redis:

docker ps | grep 3xui-shop-redis

3. Проверить Telegram connectivity и BOT_PROXY_URL.
4. Перезапустить только bot service:

docker compose up -d --build bot

Не Открывается Основная Подписка

1. Проверить /healthz.
2. Проверить, активна ли подписка пользователя.
3. Проверить доступность 3X-UI.
4. Проверить логи app.web.primary_profile.
5. Если проблема только в одном пользователе, проверить vpn_id, server binding и наличие клиента в 3X-UI.

Не Работает Подписка Обхода БС

1. Убедиться, что тариф содержит includes_additional_profile: true.
2. Проверить /wl-filtered/{vpn_id}.
3. Если рекомендуемый вариант недоступен, проверить /wl/{vpn_id}.
4. Смотреть логи app.web.additional_profile.
5. Проверить зеркала внешних источников.

Payment Callback Issue

1. Проверить, включен ли gateway в .env.
2. Сверить callback URL в кабинете платежного шлюза.
3. Проверить transaction status в базе.
4. Проверить idempotency: один callback не должен создавать двойное продление.
5. Запустить reconciliation job или дождаться фоновой задачи, если gateway поддерживает проверку статуса.

После Неудачного Деплоя

1. Не удалять runtime state.
2. Проверить последний стабильный commit или tag.
3. Вернуть код на стабильный commit.
4. Пересобрать bot service.
5. Проверить /healthz, Telegram response и одну активную подписку.