first draft videos

.env.example

@@ -68,6 +68,41 @@ AI_EMBEDDINGS_MODEL=mistral-embed
 # User rate limiting (queries per minute)
 AI_RATE_LIMIT_MAX_REQUESTS=4
 
+# ============================================================================
+# 🎥 VIDEO EMBEDDING - PRODUCTION CONFIGURATION
+# ============================================================================
+
+# Enable local caching of Nextcloud videos (highly recommended)
+VIDEO_CACHE_ENABLED=true
+
+# Directory for cached videos (ensure it's writable and has sufficient space)
+# This directory will grow over time as videos are cached permanently
+VIDEO_CACHE_DIR=./cache/videos
+
+# Emergency cleanup threshold in MB - videos are cached indefinitely
+# Only triggers cleanup when approaching this limit to prevent disk full
+# Recommended: 2000MB (2GB) for small deployments, 5000MB+ for larger ones
+VIDEO_CACHE_MAX_SIZE=2000
+
+# Maximum individual video file size for caching in MB
+# Videos larger than this will stream directly without caching
+VIDEO_MAX_SIZE=200
+
+MINIO_URL=http://127.0.0.1:9000
+MINIO_ACCESS_KEY=your-access-key
+MINIO_SECRET_KEY=your-secret-key
+
+
+# ============================================================================
+# CACHING BEHAVIOR
+# ============================================================================
+# - Videos downloaded once, cached permanently
+# - No time-based expiration
+# - Dramatically improves loading times after first download
+# - Emergency cleanup only when approaching disk space limit
+# - Perfect for manually curated forensics training content
+# ============================================================================
+
 # ============================================================================
 # 🎛️ PERFORMANCE TUNING - SENSIBLE DEFAULTS PROVIDED
 # ============================================================================