.env.example

# Django Settings
SECRET_KEY=your-secret-key-here-change-in-production
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1

# CORS Allowed Origins (comma-separated) - frontend domains that can access the API
CORS_ALLOWED_ORIGINS=http://localhost:3000

# Allow Private Network Access (needed when frontend is public but API resolves to private IP)
# CORS_ALLOW_PRIVATE_NETWORK=False

# Rate Limiting (per-IP, protects image submission from abuse)
# RATE_LIMIT_ENABLE=True
# RATE_LIMIT_RATE=2/min
# RATE_LIMIT_EXCLUDE_PATHS=/health/,/api/v1/health-light/
# RATE_LIMIT_INCLUDE_PATHS=/api/v1/ocr/

# CSRF Trusted Origins for cross-origin requests (comma-separated)
# Add your frontend domain here to allow cross-origin requests
CSRF_TRUSTED_ORIGINS=https://rest-openlpr.computedsynergy.com

# Qwen3-VL API Configuration
QWEN_API_KEY=your-qwen-api-key-here
QWEN_BASE_URL=https://your-open-api-compatible-endpoint.com/v1
QWEN_MODEL=qwen3-vl-4b-instruct

# File Upload Settings
UPLOAD_FILE_MAX_SIZE=1048576
MAX_BATCH_SIZE=10

# Database Settings (optional - defaults to SQLite)
# DATABASE_URL=postgresql://user:password@localhost:5432/dbname

# Media Settings (optional - defaults to ./media for development, ./container-media for containers)
# MEDIA_PATH=/path/to/media/directory

# Email Settings (optional - for error notifications)
# EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend
# EMAIL_HOST=smtp.gmail.com
# EMAIL_PORT=587
# EMAIL_USE_TLS=True
# EMAIL_HOST_USER=your-email@gmail.com
# EMAIL_HOST_PASSWORD=your-app-password

# Detection pipeline settings
# PROCESSING_TIMEOUT_MINUTES=5
# MAX_RETRIES=2
# RETRY_BATCH_SIZE=5
# RETRY_INTERVAL_MINUTES=5
# RETRY_SCHEDULER_ENABLED=True
# RUN_SCHEDULER explicitly enables the scheduler (auto-detected under Gunicorn)

# Canary Configuration
CANARY_HEADER_NAME=X-Canary-Request
CANARY_HEADER_VALUE=true
CANARY_ENABLED=true

# SPA Frontend Settings (runtime, set via Docker environment)
# BACKEND_API_URL=http://localhost:8000
# NEXT_PUBLIC_UPLOAD_TIMEOUT=120000

# Prometheus URL (for availability graph proxy)
# PROMETHEUS_URL=http://prometheus:9090