.env.example

# ============================================================================
# FLASK CONFIGURATION
# ============================================================================
# PURPOSE: Set the application execution mode.
# WHY: 'development' enables detailed error pages and auto-reloading.
# IMPACT: Controls the internal Flask behavior.
FLASK_ENV=development

# PURPOSE: Toggle debug mode.
# WHY: True enables the interactive debugger in the browser on crash.
# IMPACT: Essential for development, MUST BE FALSE in production for security.
FLASK_DEBUG=True

# PURPOSE: Main security salt for Flask sessions.
# WHY: Used to sign cookies and prevent session tampering.
# IMPACT: System-wide security.
SECRET_KEY=your-secret-key-here-change-in-production

# ============================================================================
# SERVER CONFIGURATION
# ============================================================================
# PURPOSE: Define the network interface the server binds to.
# WHY: '0.0.0.0' makes the server accessible from outside the container or local network.
HOST=0.0.0.0

# PURPOSE: Define the TCP port for the backend.
PORT=5000

# ============================================================================
# DATABASE CONFIGURATION
# ============================================================================
# PURPOSE: Connection string for SQLAlchemy.
# WHY: Tells the app exactly where the user accounts and recipes are stored.
# IMPACT: Persistence layer.
DATABASE_URL=sqlite:///recipe_generator.db

# ============================================================================
# JWT CONFIGURATION
# ============================================================================
# PURPOSE: Secret key specifically for JSON Web Tokens.
# WHY: Protects the integrity of user login sessions.
JWT_SECRET_KEY=your-jwt-secret-key-change-in-production

# PURPOSE: Set the lifespan of a login session.
# WHY: 86400 seconds (24 hours) balance convenience with security.
JWT_ACCESS_TOKEN_EXPIRES=86400

# ============================================================================
# REDIS CONFIGURATION
# ============================================================================
# PURPOSE: URL for the Redis cache server.
# WHY: Used to speed up recipe generation by caching frequent results.
REDIS_URL=redis://localhost:6379/0

# ============================================================================
# RATE LIMITING
# ============================================================================
# PURPOSE: Toggle the API rate limiter.
# WHY: Prevents bots from crashing the server with too many requests.
RATE_LIMIT_ENABLED=True
RATE_LIMIT_PER_MINUTE=10

# ============================================================================
# MODEL CONFIGURATION
# ============================================================================
# PURPOSE: Toggle hardware acceleration.
# WHY: Most cheap/free servers don't have GPUs; False keeps the app compatible.
USE_GPU=False

# PURPOSE: Local path to the AI model weight file.
MODEL_PATH=Foodimg2Ing/data/modelbest.ckpt

# ============================================================================
# FRONTEND URL (FOR CORS)
# ============================================================================
# PURPOSE: Define the allowed origin for web requests.
# WHY: Browsers block scripts from one site (Vite) talking to another (Flask) unless permitted.
# IMPACT: Enables secure frontend-backend communication.
FRONTEND_URL=http://localhost:5173

# ============================================================================
# FILE UPLOAD
# ============================================================================
# PURPOSE: Limit the size of uploaded food images.
# WHY: Prevents users from filling up server disk space with 100MB 4K photos.
# IMPACT: Resource management.
MAX_CONTENT_LENGTH=16777216  # 16MB in bytes

# PURPOSE: Directory where images are stored before processing.
UPLOAD_FOLDER=Foodimg2Ing/static/demo_imgs