# ==============================================================================
# VOLATIO ENVIRONMENT CONFIGURATION
# ==============================================================================
# Copy this file to .env and fill in the values.
# Variables marked [REQUIRED] must be set for the app to work.
# Variables marked [OPTIONAL] can be left empty for basic operation.
# ==============================================================================

# ==============================================================================
# REQUIRED - Core Infrastructure
# ==============================================================================

# PostgreSQL Database (TimescaleDB)
# Used for: all data - users, auth, market data, news, signals, paper trading
DATABASE_URL=postgres://volatio:vibes123@localhost:5433/volatio_market

# Redis (for BullMQ job queues)
REDIS_URL=redis://localhost:6379

# Auth.js v5 Secret (generate with: openssl rand -base64 32)
AUTH_SECRET=super-secret-vibes-key
AUTH_URL=http://localhost:3000

# ==============================================================================
# REQUIRED - Database Seeding
# ==============================================================================

# Initial admin user created during setup
SUPERUSER_EMAIL=admin@volatio.io
SUPERUSER_PASSWORD=Trading2024!
SUPERUSER_NAME=Admin

# ==============================================================================
# REQUIRED - Internal Services
# ==============================================================================

# ML Service (Python FastAPI)
ML_SERVICE_URL=http://localhost:8000

# API URL (for dashboard to call API)
NEXT_PUBLIC_API_URL=http://localhost:3001

# ==============================================================================
# OPTIONAL - Data Provider API Keys
# ==============================================================================
# These are needed for production scraping jobs.
# Leave empty for local development with seeded sample data.

# Polygon.io (via Massive) - Market data and news
# Get keys from: https://polygon.io/ (requires Massive subscription for flat files)
MASSIVE_API_KEY=
MASSIVE_S3_ACCESS_KEY_ID=
MASSIVE_S3_SECRET_ACCESS_KEY=
MASSIVE_S3_ENDPOINT=https://files.polygon.io

# FRED API - Federal Reserve Economic Data
# Get free key from: https://fred.stlouisfed.org/docs/api/api_key.html
FRED_API_KEY=

# ==============================================================================
# OPTIONAL - Cloud Storage
# ==============================================================================
# Used for archiving scraped data to S3.
# Leave empty to skip S3 archival.

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_REGION=us-east-1
S3_BUCKET=volatio-data

# ==============================================================================
# OPTIONAL - Web Scraping Proxies
# ==============================================================================
# Bright Data residential proxies for rate-limited scraping.
# Leave empty to use direct connections (may hit rate limits).

BRIGHTDATA_PROXY_URL=