.env.example

# Environment Configuration Template
# Copy this file to .env and update with your actual values

#==============================================================================
# DATABASE CONFIGURATION
#==============================================================================

# MongoDB connection string
# Local development: mongodb://localhost:27017/ai_simulation
# Production: mongodb://username:password@host:port/database
MONGO_URL=mongodb://localhost:27017/ai_simulation

#==============================================================================
# JWT AUTHENTICATION
#==============================================================================

# JWT secret key - MUST be changed in production
# Generate with: python -c "import secrets; print(secrets.token_urlsafe(32))"
JWT_SECRET_KEY=your_super_secure_jwt_secret_key_here

# JWT algorithm (recommended: HS256)
JWT_ALGORITHM=HS256

# Token expiration time in minutes
JWT_ACCESS_TOKEN_EXPIRE_MINUTES=30

#==============================================================================
# AI SERVICE INTEGRATIONS
#==============================================================================

# OpenAI API key for AI agent conversations
# Get from: https://platform.openai.com/api-keys
OPENAI_API_KEY=your_openai_api_key_here

# FAL.ai API key for avatar generation
# Get from: https://fal.ai/dashboard
FAL_KEY=your_fal_ai_key_here

# Emergent Integrations (if using platform-specific features)
EMERGENT_API_KEY=your_emergent_api_key_here

#==============================================================================
# GOOGLE OAUTH (OPTIONAL)
#==============================================================================

# Google OAuth credentials for social login
# Get from: https://console.developers.google.com/
GOOGLE_CLIENT_ID=your_google_client_id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your_google_client_secret

#==============================================================================
# EMAIL CONFIGURATION (OPTIONAL)
#==============================================================================

# SMTP settings for email notifications
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your_email@gmail.com
SMTP_PASSWORD=your_app_password

# Email sender information
FROM_EMAIL=noreply@yourdomain.com
FROM_NAME=AI Simulation Platform

#==============================================================================
# APPLICATION SETTINGS
#==============================================================================

# Environment (development, staging, production)
ENVIRONMENT=development

# Debug mode (true/false)
DEBUG=true

# Application URL (used for redirects and links)
APP_URL=http://localhost:3000

# API base URL
API_URL=http://localhost:8001

#==============================================================================
# SECURITY SETTINGS
#==============================================================================

# CORS allowed origins (comma-separated)
CORS_ORIGINS=http://localhost:3000,https://yourdomain.com

# Rate limiting (requests per minute)
RATE_LIMIT_REQUESTS=100
RATE_LIMIT_WINDOW=60

# Session settings
SESSION_TIMEOUT_MINUTES=480
COOKIE_SECURE=false

#==============================================================================
# LOGGING & MONITORING
#==============================================================================

# Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
LOG_LEVEL=INFO

# Log file path
LOG_FILE=logs/application.log

# Sentry DSN for error tracking (optional)
SENTRY_DSN=your_sentry_dsn_here

#==============================================================================
# REDIS CACHE (OPTIONAL)
#==============================================================================

# Redis connection for caching
REDIS_URL=redis://localhost:6379/0

# Cache TTL in seconds
CACHE_TTL=3600

#==============================================================================
# FILE STORAGE
#==============================================================================

# File upload settings
MAX_FILE_SIZE_MB=10
UPLOAD_FOLDER=uploads/

# AWS S3 configuration (if using cloud storage)
AWS_ACCESS_KEY_ID=your_aws_access_key
AWS_SECRET_ACCESS_KEY=your_aws_secret_key
AWS_S3_BUCKET=your-s3-bucket-name
AWS_REGION=us-east-1

#==============================================================================
# ANALYTICS & TRACKING
#==============================================================================

# Google Analytics tracking ID (optional)
GOOGLE_ANALYTICS_ID=GA-XXXXXXXXX

# Mixpanel project token (optional)
MIXPANEL_TOKEN=your_mixpanel_token

#==============================================================================
# DEVELOPMENT SETTINGS
#==============================================================================

# Development database (separate from production)
DEV_MONGO_URL=mongodb://localhost:27017/ai_simulation_dev

# Test database
TEST_MONGO_URL=mongodb://localhost:27017/ai_simulation_test

# Development ports
DEV_BACKEND_PORT=8001
DEV_FRONTEND_PORT=3000

#==============================================================================
# PRODUCTION OVERRIDES
#==============================================================================

# Production-specific settings (uncomment for production)
# DEBUG=false
# ENVIRONMENT=production
# COOKIE_SECURE=true
# CORS_ORIGINS=https://yourdomain.com
# LOG_LEVEL=WARNING

#==============================================================================
# SSL/TLS CONFIGURATION
#==============================================================================

# SSL certificate paths (for HTTPS)
SSL_CERT_PATH=/path/to/ssl/certificate.pem
SSL_KEY_PATH=/path/to/ssl/private.key

# SSL/TLS settings
TLS_VERSION=1.3
CIPHER_SUITES=ECDHE+AESGCM:ECDHE+CHACHA20:DHE+AESGCM:DHE+CHACHA20:!aNULL:!MD5:!DSS

#==============================================================================
# BACKUP & MAINTENANCE
#==============================================================================

# Database backup settings
BACKUP_SCHEDULE=0 2 * * *  # Daily at 2 AM
BACKUP_RETENTION_DAYS=30
BACKUP_LOCATION=/backups/

# Maintenance mode
MAINTENANCE_MODE=false
MAINTENANCE_MESSAGE=System maintenance in progress

#==============================================================================
# FEATURE FLAGS
#==============================================================================

# Enable/disable features
ENABLE_GOOGLE_OAUTH=true
ENABLE_EMAIL_NOTIFICATIONS=true
ENABLE_ANALYTICS=true
ENABLE_RATE_LIMITING=true
ENABLE_CACHING=false

# Premium features
ENABLE_FAST_FORWARD=true
ENABLE_WEEKLY_REPORTS=true
ENABLE_ADVANCED_ANALYTICS=true

#==============================================================================
# INTEGRATION SETTINGS
#==============================================================================

# Webhook URLs for integrations
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...

# External API timeouts (seconds)
API_TIMEOUT=30
AI_SERVICE_TIMEOUT=60

#==============================================================================
# PERFORMANCE TUNING
#==============================================================================

# Database connection pool
DB_MIN_CONNECTIONS=1
DB_MAX_CONNECTIONS=10

# Memory limits
MEMORY_LIMIT=512M
MAX_WORKERS=4

# Cache settings
CACHE_MAX_SIZE=100MB
CACHE_STRATEGY=LRU