Первый коммит

This commit is contained in:
2026-02-17 11:24:55 +07:00
commit a06448ca4b
109 changed files with 21165 additions and 0 deletions

253
.env_example Normal file
View File

@@ -0,0 +1,253 @@
# ╔═══════════════════════════════════════════════════════════════════════════╗
# ║ КОНФИГУРАЦИЯ 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