# ╔═══════════════════════════════════════════════════════════════════════════╗
# ║                    КОНФИГУРАЦИЯ TELEGRAM БОТА                             ║
# ║                                                                           ║
# ║  Инструкция:                                                              ║
# ║  1. Скопируйте этот файл и переименуйте в .env                           ║
# ║  2. Заполните обязательные поля (отмечены [ОБЯЗАТЕЛЬНО])                 ║
# ║  3. Настройте опциональные параметры по необходимости                    ║
# ║                                                                           ║
# ╚═══════════════════════════════════════════════════════════════════════════╝



# ═══════════════════════════════════════════════════════════════════════════
#              МИНИМАЛЬНАЯ КОНФИГУРАЦИЯ (только обязательные поля)
# ═══════════════════════════════════════════════════════════════════════════

# [ОБЯЗАТЕЛЬНО] Токен бота от @BotFather
BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567890

# [ОБЯЗАТЕЛЬНО] ID владельцев (узнать: @userinfobot)
OWNER_ID=123456789

# [ОБЯЗАТЕЛЬНО] ID админского чата (узнать: @username_to_id_bot)
ADMIN_CHAT_ID=-1001234567890



# ═══════════════════════════════════════════════════════════════════════════
#                           🤖 ТОКЕН БОТА
# ═══════════════════════════════════════════════════════════════════════════

# [ОБЯЗАТЕЛЬНО] Токен бота от @BotFather
# Как получить: отправьте /newbot боту @BotFather и следуйте инструкциям
BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567890


# ═══════════════════════════════════════════════════════════════════════════
#                         👤 АДМИНИСТРАТОРЫ И ID
# ═══════════════════════════════════════════════════════════════════════════

# [ОБЯЗАТЕЛЬНО] ID владельцев бота (список через запятую)
# Как узнать свой ID: отправьте сообщение боту @userinfobot
OWNER_ID=123456789,987654321

# [ОБЯЗАТЕЛЬНО] ID чата для уведомлений админов (куда бот будет слать логи о спаме)
# Для группы: добавьте бота в группу и используйте бота @username_to_id_bot
ADMIN_CHAT_ID=-1001234567890

# Дополнительные админы (не суперадмины, но имеют доступ к командам)
# Необязательно, можно оставить пустым
ADMIN_ID=111111111,222222222


# ═══════════════════════════════════════════════════════════════════════════
#                         ⚙️ ОСНОВНЫЕ НАСТРОЙКИ БОТА
# ═══════════════════════════════════════════════════════════════════════════

# Имя бота (отображается в /start и описании)
BOT_NAME=Первозданная Жемчужина

# Описание бота (длинное, до 512 символов)
# Если не указано, будет сгенерировано автоматически
# BOT_DESCRIPTION=Бот-модератор для защиты чата от спама и нецензурных слов

# Короткое описание (до 120 символов)
# Если не указано, будет сгенерировано автоматически
# BOT_SHORT_DESCRIPTION=Тех.поддержка: @verdise

# Путь к фото профиля бота (необязательно)
# BOT_PHOTO=./assets/bot_avatar.jpg


# ═══════════════════════════════════════════════════════════════════════════
#                         💬 НАСТРОЙКИ СООБЩЕНИЙ
# ═══════════════════════════════════════════════════════════════════════════

# Режим разметки текста (HTML, Markdown, MarkdownV2)
PARSE_MODE=HTML

# Префиксы команд (символы, которые могут начинать команды)
PREFIX=/!.&?

# Отключить звуковые уведомления при отправке сообщений ботом
DISABLE_NOTIFICATION=false

# Защитить контент от пересылки и сохранения
PROTECT_CONTENT=false

# Разрешить отправку без ответа на реплай
ALLOW_SENDING_WITHOUT_REPLY=true

# Настройки превью ссылок
LINK_PREVIEW_IS_DISABLED=false
LINK_PREVIEW_PREFER_SMALL_MEDIA=false
LINK_PREVIEW_PREFER_LARGE_MEDIA=true
LINK_PREVIEW_SHOW_ABOVE_TEXT=true

# Показывать подпись над медиа
SHOW_CAPTION_ABOVE_MEDIA=false


# ═══════════════════════════════════════════════════════════════════════════
#                         📝 ЛОГИРОВАНИЕ
# ═══════════════════════════════════════════════════════════════════════════

# Включить логи в консоль
LOG_CONSOLE=true

# Включить логи в файл
LOG_FILE=true

# Директория для логов
LOG_DIR=Logs

# Имя файла с общей информацией
LOG_FILE_INFO=bot_info.log

# Ротация логов (размер файла для создания нового)
# Примеры: 100 MB, 500 MB, 1 GB
LOG_ROTATION=100 MB

# Время хранения старых логов
# Примеры: 7 days, 30 days, 1 week, 1 month
LOG_RETENTION=7 days

# Выводить информацию о старте в консоль
START_INFO_CONSOLE=true

# Выводить информацию о старте в файл
START_INFO_TO_FILE=true


# ═══════════════════════════════════════════════════════════════════════════
#                         🌐 WEBHOOK (опционально)
# ═══════════════════════════════════════════════════════════════════════════

# Использовать вебхук вместо long polling
# false = long polling (рекомендуется для начинающих)
# true = webhook (требует публичный HTTPS домен)
WEBHOOK=false

# URL вебхука (обязателен если WEBHOOK=true)
# Должен быть публичный HTTPS адрес
# WEBHOOK_URL=https://your-domain.com/webhook

# Секретный токен для вебхука (генерируется автоматически если не указан)
# SECRET_TOKEN=your-secret-token-here

# Хост для uvicorn (внутренний адрес сервера)
WEBAPP_HOST=0.0.0.0

# Порт для uvicorn
WEBAPP_PORT=3131

# Уровень логов для uvicorn (debug, info, warning, error, critical)
LOG_LEVEL=warning

# Включить access log для uvicorn
ACCES_LOG=false


# ═══════════════════════════════════════════════════════════════════════════
#                         🔑 API КЛЮЧИ (опционально)
# ═══════════════════════════════════════════════════════════════════════════

# Различные API ключи для интеграций
# Заполните только те, которые используете

# Общий API ключ
# API_KEY=your-api-key-here

# Web API ключ
# WEB_API_KEY=your-web-api-key-here

# API ключ для погоды (например, OpenWeatherMap)
# WEATHER_API_KEY=your-weather-api-key-here


# ═══════════════════════════════════════════════════════════════════════════
#                    👮 ПРАВА АДМИНИСТРАТОРА БОТА
# ═══════════════════════════════════════════════════════════════════════════

# Разрешить боту редактировать свой профиль при старте
BOT_EDIT=false

# Анонимный администратор
ANONYMOUS=false

# Управление чатом
MANAGE_CHAT=true

# Изменение информации о чате
CHANGE_INFO=true

# Повышение участников
PROMOTE_MEMBERS=true

# Ограничение участников (бан, мут)
RESTRICT_MEMBERS=true

# Публикация сообщений (для каналов)
POST_MESSAGE=true

# Управление темами (топиками)
MANAGE_TOPICS=true

# Приглашение пользователей
INVITE_USER=true

# Удаление сообщений
DELETE_MESSAGES=true

# Управление видеочатами
MANAGE_VIDEO_CHATS=true

# Редактирование сообщений (для каналов)
EDIT_MESSAGES=true

# Закрепление сообщений
PIN_MESSAGE=true

# Публикация историй
POST_STORIES=true

# Редактирование историй
EDIT_STORIES=true

# Удаление историй
DELETE_STORIES=true


# ═══════════════════════════════════════════════════════════════════════════
#                    🚫 МОДЕРАТОР (банворды и фильтры)
# ═══════════════════════════════════════════════════════════════════════════

# Файл с запрещенными словами (JSON)
WORDS_FILE=banwords.json

# Директория для постов
POSTS_DIR=posts


# ═══════════════════════════════════════════════════════════════════════════
#                         📌 ДОПОЛНИТЕЛЬНЫЕ НАСТРОЙКИ
# ═══════════════════════════════════════════════════════════════════════════

# Добавьте сюда свои кастомные переменные по необходимости
# Например:

# DATABASE_URL=postgresql://user:password@localhost/dbname
# REDIS_URL=redis://localhost:6379
# MAX_WARNINGS=3
# BAN_DURATION=86400
