# Django Configuration Example
# Все настройки читаются из переменных окружения (DEV/PROD без распознавания хоста)
# Для локальной разработки можно скопировать файл в .env.local и экспортировать его.

# ============================================================================
# DJANGO
# ============================================================================

# Django SECRET_KEY - сгенерируйте с помощью:
# python -c 'from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())'
DJANGO_SECRET_KEY=your-super-secret-key-here-change-me

# Режим отладки (НИКОГДА не True на продакшене!)
DEBUG=False

# Допустимые хосты (разделены запятой без пробелов)
ALLOWED_HOSTS=localhost,127.0.0.1,yourdomain.com

# Базовый публичный URL сайта (используется для абсолютных URL в sitemap.xml)
SITE_BASE_URL=https://yourdomain.com

# Админы для email-оповещений Django (формат: Имя:email,Имя2:email2)
ADMINS=Admin:admin@example.com

# ============================================================================
# DATABASE
# ============================================================================

# Database backend (по умолчанию SQLite)
DATABASE_ENGINE=django.db.backends.sqlite3

# Имя/путь базы данных:
# - для SQLite: только имя файла (полный путь соберется в settings.py через PROJECT_ROOT/database)
# - для MySQL/MariaDB: имя базы
DATABASE_NAME=oknadria.sqlite3

# Для MySQL/MariaDB (используются, если DATABASE_ENGINE=django.db.backends.mysql)
# DATABASE_HOST=localhost
# DATABASE_PORT=3306
# DATABASE_USER=name-for-db-user
# DATABASE_PASSWORD=your-db-password-here

# Пути вычисляются автоматически внутри settings.py от PROJECT_ROOT
TOUCH_RELOAD=/app/logs/touch-reload.txt

# Подкаталог в MEDIA_ROOT, где хранится кеш sitemap-файлов
SITEMAP_SUBDIR=_serv_sitemap

# ============================================================================
# EMAIL
# ============================================================================

# Email backend
EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend

# SMTP Settings
EMAIL_HOST=smtp.example.com
EMAIL_PORT=587
EMAIL_USE_TLS=True
EMAIL_USE_SSL=False
EMAIL_HOST_USER=your-email@example.com
EMAIL_HOST_PASSWORD=your-email-password

# Default from email
DEFAULT_FROM_EMAIL=noreply@example.com
SERVER_EMAIL=admin@example.com

# ============================================================================
# SECURITY
# ============================================================================

# HTTPS and secure cookies (включить на продакшене)
SECURE_SSL_REDIRECT=False
SESSION_COOKIE_SECURE=False
CSRF_COOKIE_SECURE=False

# ============================================================================
# CAPTCHA
# ============================================================================

# Google reCAPTCHA v2
# Получите на https://www.google.com/recaptcha/admin
# ВАЖНО: Никогда не коммитьте реальные ключи в git!
CAPTCHA_PUBLIC_KEY=your-recaptcha-public-key-here
CAPTCHA_PRIVATE_KEY=your-recaptcha-private-key-here

# ============================================================================
# EXTERNAL APIs
# ============================================================================

# Yandex Maps
# Получите на https://developer.tech.yandex.ru/
YANDEX_MAPS_API_KEY=your-yandex-maps-api-key

# ============================================================================
# LOGGING
# ============================================================================

# Log level: DEBUG, INFO, WARNING, ERROR, CRITICAL
LOG_LEVEL=INFO

# ============================================================================
# CACHE (опционально, если используется Redis)
# ============================================================================

# CACHE_BACKEND=redis
# CACHE_LOCATION=redis://localhost:6379/1

# ============================================================================
# CELERY (опционально, если используется Celery)
# ============================================================================

# CELERY_BROKER_URL=redis://localhost:6379/0
# CELERY_RESULT_BACKEND=redis://localhost:6379/0

# ============================================================================
# ИНСТРУКЦИЯ ПО ИСПОЛЬЗОВАНИЮ
# ============================================================================

# 1. Скопируйте этот файл:
#    cp .env.sample .env.local
#
# 2. Отредактируйте значения в .env.local:
#    nano .env.local
#
# 3. Убедитесь, что .env.local в .gitignore:
#    grep ".env" .gitignore
#
# 4. Экспортируйте переменные перед запуском Django:
#    set -a; source .env.local; set +a
#
# ВАЖНО:
# - НИКОГДА не коммитьте .env.local или файлы с реальными значениями в git!
# - На продакшене используйте переменные окружения, установленные в:
#   - systemd service файл
#   - Docker env vars
#   - Kubernetes secrets
#   - AWS Systems Manager Parameter Store
#   - HashiCorp Vault

