.env.example

# Graphica Coordinator Configuration
# Copy this file to .env and adjust values for your environment

# ==============================================================================
# SHARD CONFIGURATION (REQUIRED FOR DISTRIBUTED MODE)
# ==============================================================================

# Comma-separated list of shard endpoints (host:port)
# Example: shard-0.local:9090,shard-1.local:9091,shard-2.local:9092
# Leave empty for standalone mode (in-memory RDF store, no persistence)
SHARD_URLS=

# Number of shards (informational, derived from SHARD_URLS)
# Default: 2
SHARD_COUNT=2

# ==============================================================================
# NETWORK CONFIGURATION
# ==============================================================================

# REST API port (HTTP)
# Default: 8080
REST_PORT=8080

# gRPC API port
# Default: 9090
GRPC_PORT=9090

# Bind address for REST API
# Default: 0.0.0.0 (all interfaces)
# Use 127.0.0.1 for localhost only
REST_BIND_ADDRESS=0.0.0.0

# Bind address for gRPC API
# Default: 0.0.0.0 (all interfaces)
GRPC_BIND_ADDRESS=0.0.0.0

# ==============================================================================
# STORAGE CONFIGURATION
# ==============================================================================

# RocksDB path for coordinator data (temporal indexes, shard registry)
# Default: ./data/coordinator/rocksdb
ROCKSDB_PATH=./data/coordinator/rocksdb

# Parquet storage path for lineage data (warm tier)
# Default: ./data/parquet
PARQUET_PATH=./data/parquet

# Archive path for cold storage (S3/local filesystem)
# Default: ./data/archive
ARCHIVE_PATH=./data/archive

# ==============================================================================
# KAFKA CONFIGURATION
# ==============================================================================

# Kafka bootstrap servers (comma-separated)
# Default: localhost:9092
KAFKA_BROKERS=localhost:9092

# Kafka consumer group ID
# Default: graphica-coordinator
KAFKA_CONSUMER_GROUP=graphica-coordinator

# Kafka topic for lineage events
# Default: graphica.lineage
KAFKA_LINEAGE_TOPIC=graphica.lineage

# Kafka topic for quality events
# Default: graphica.quality
KAFKA_QUALITY_TOPIC=graphica.quality

# ==============================================================================
# AUTHENTICATION & SECURITY
# ==============================================================================

# JWT secret for token signing (base64 encoded)
# Generate with: openssl rand -base64 32
# REQUIRED for production
JWT_SECRET=

# JWT token expiration time (seconds)
# Default: 3600 (1 hour)
JWT_EXPIRATION_SECONDS=3600

# Enable authentication
# Default: true
# Set to false for development only
ENABLE_AUTH=true

# CORS allowed origins (comma-separated)
# Default: http://localhost:3000,http://localhost:5173
CORS_ALLOWED_ORIGINS=http://localhost:3000,http://localhost:5173

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

# Rust log level
# Options: trace, debug, info, warn, error
# Default: info
RUST_LOG=info

# Enable metrics endpoint
# Default: true
ENABLE_METRICS=true

# Metrics port (Prometheus format)
# Default: 9091
METRICS_PORT=9091

# Enable tracing
# Default: false
ENABLE_TRACING=false

# Jaeger agent endpoint for distributed tracing
# Default: localhost:6831
JAEGER_AGENT_ENDPOINT=localhost:6831

# ==============================================================================
# CONNECTION POOL SETTINGS
# ==============================================================================

# Shard connection timeout (milliseconds)
# Default: 5000 (5 seconds)
SHARD_CONNECT_TIMEOUT_MS=5000

# Shard request timeout (milliseconds)
# Default: 30000 (30 seconds)
SHARD_REQUEST_TIMEOUT_MS=30000

# Circuit breaker: max failures before opening
# Default: 3
SHARD_MAX_FAILURES=3

# Circuit breaker: reset duration (seconds)
# Default: 30
SHARD_CIRCUIT_RESET_SECONDS=30

# Connection pool size per shard
# Default: 10
SHARD_POOL_SIZE=10

# ==============================================================================
# QUERY EXECUTION SETTINGS
# ==============================================================================

# Query timeout (milliseconds)
# Default: 60000 (60 seconds)
QUERY_TIMEOUT_MS=60000

# Max query results per shard (for scatter-gather)
# Default: 10000
QUERY_MAX_RESULTS_PER_SHARD=10000

# Query failure mode
# Options: best_effort, all_or_nothing, quorum
# Default: best_effort
QUERY_FAILURE_MODE=best_effort

# Enable query result caching
# Default: false
ENABLE_QUERY_CACHE=false

# Query cache TTL (seconds)
# Default: 300 (5 minutes)
QUERY_CACHE_TTL_SECONDS=300

# ==============================================================================
# WORKFLOW ENGINE SETTINGS
# ==============================================================================

# Enable workflow engine
# Default: false
ENABLE_WORKFLOW_ENGINE=false

# Workflow execution timeout (seconds)
# Default: 3600 (1 hour)
WORKFLOW_TIMEOUT_SECONDS=3600

# Max concurrent workflow executions
# Default: 10
WORKFLOW_MAX_CONCURRENT=10

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

# RocksDB block cache size (MB)
# Default: 256
ROCKSDB_BLOCK_CACHE_MB=256

# RocksDB write buffer size (MB)
# Default: 64
ROCKSDB_WRITE_BUFFER_MB=64

# RocksDB max background jobs
# Default: 4
ROCKSDB_MAX_BACKGROUND_JOBS=4

# Max HTTP request body size (bytes)
# Default: 10485760 (10MB)
MAX_REQUEST_BODY_SIZE=10485760

# HTTP request timeout (seconds)
# Default: 60
HTTP_REQUEST_TIMEOUT_SECONDS=60

# ==============================================================================
# DEVELOPMENT & DEBUGGING
# ==============================================================================

# Enable development mode (less strict validation, verbose errors)
# Default: false
DEV_MODE=false

# Enable SQL query logging
# Default: false
LOG_SQL_QUERIES=false

# Enable detailed error messages in API responses
# Default: false (for security)
DETAILED_ERRORS=false

# Pretty print JSON responses
# Default: false
PRETTY_PRINT_JSON=false

# ==============================================================================
# HEALTH CHECK SETTINGS
# ==============================================================================

# Health check interval (seconds)
# Default: 30
HEALTH_CHECK_INTERVAL_SECONDS=30

# Shard health check timeout (milliseconds)
# Default: 5000
SHARD_HEALTH_TIMEOUT_MS=5000

# Mark shard unhealthy after N failed health checks
# Default: 3
SHARD_HEALTH_FAILURE_THRESHOLD=3

# ==============================================================================
# ADVANCED SETTINGS
# ==============================================================================

# RDF storage client endpoint (for schema inference)
# Example: http://localhost:9090
# Leave empty to disable
SHARD_ENDPOINT=

# Ontology registry path
# Default: ./data/ontologies
ONTOLOGY_REGISTRY_PATH=./data/ontologies

# Enable bitemporal indexing
# Default: true
ENABLE_BITEMPORAL=true

# Replication factor for shard registry
# Default: 2
SHARD_REPLICATION_FACTOR=2

# Shard heartbeat timeout (seconds)
# Default: 60
SHARD_HEARTBEAT_TIMEOUT_SECONDS=60