remnawave-bedolaga-telegram-bot/docs/referral_program_setting.md

# Включение/отключение реферальной программы

## Описание
Добавлена возможность включать и отключать реферальную программу (партнерку) через переменную окружения.

## Настройка
В файле `.env` установите значение переменной:

- `REFERRAL_PROGRAM_ENABLED=true` - реферальная программа включена
- `REFERRAL_PROGRAM_ENABLED=false` - реферальная программа отключена

## Поведение
- При отключенной программе кнопки "Партнерка", "Рефералы" и другие связанные элементы скрываются из главного меню бота
- Обычные (не реферальные) кнопки продолжают отображаться независимо от настройки
- Административные функции реферальной программы остаются доступными в админ-панели для управления
- Настройка также учитывается в API и других сервисах, использующих информацию о реферальной программе

## Примеры скрываемых элементов
- Кнопка "🤝 Партнерка" в главном меню
- Кнопка "👥 Мои рефералы" 
- Кнопка "🤝 Referral program" (английская версия)
- Другие элементы, содержащие слова "partner", "referr", "партнер", "реферал"

## Технические детали
- Новая переменная `REFERRAL_PROGRAM_ENABLED` добавлена в `app/config.py`
- Метод `is_referral_program_enabled()` проверяет состояние настройки
- Функция `get_main_menu_keyboard` в `app/keyboards/inline.py` скрывает кнопку "Партнерка" при отключенной программе
- Сервис `MainMenuButtonService` в `app/services/main_menu_button_service.py` скрывает дополнительные кнопки, связанные с рефералами
- Обновлен файл `.env.example` с новой настройкой