Feat/winter improvements

.env.example

@@ -1,12 +1,55 @@
-# Example environment variables file
-# Copy this to .env.production and update with your actual values
-
-# For production deployment:
-VUE_APP_WS_URL=wss://YOUR-FLY-APP-NAME.fly.dev
-VUE_APP_WS_PORT=443
-VUE_APP_WS_PATH=/ws
-
-# For local development (copy to .env.development):
-# VUE_APP_WS_URL=ws://localhost
-# VUE_APP_WS_PORT=10086
-# VUE_APP_WS_PATH=/ws
+# PythonIDE Environment Configuration
+# Copy this file to .env and fill in your values
+
+# ===========================================
+# DATABASE CONFIGURATION
+# ===========================================
+# PostgreSQL connection string
+# For local Docker: postgresql://postgres:postgres@localhost:5432/pythonide
+# For AWS RDS: postgresql://user:password@host:5432/pythonide
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/pythonide
+
+# ===========================================
+# SECURITY
+# ===========================================
+# Secret key for session management (generate a random string for production)
+IDE_SECRET_KEY=your-secret-key-change-in-production
+
+# ===========================================
+# FILE STORAGE
+# ===========================================
+# Path to store user files
+# For local Docker: /app/server/projects
+# For AWS EFS: /mnt/efs/pythonide-data
+IDE_DATA_PATH=/app/server/projects
+
+# ===========================================
+# EXECUTION LIMITS
+# ===========================================
+# Maximum concurrent Python processes
+MAX_CONCURRENT_PROCESSES=60
+MAX_CONCURRENT_EXECUTIONS=60
+
+# Maximum age of a process before termination (seconds)
+MAX_PROCESS_AGE=300
+
+# Execution timeout per script (seconds)
+EXECUTION_TIMEOUT=60
+
+# Memory limit per execution (MB)
+MEMORY_LIMIT_MB=128
+
+# ===========================================
+# SERVER CONFIGURATION
+# ===========================================
+# Port for the server to listen on
+PORT=8080
+
+# Number of Tornado processes (usually 1 for development)
+TORNADO_PROCESSES=1
+
+# ===========================================
+# OPTIONAL: EXAM MODE
+# ===========================================
+# Set to 'true' to enable exam mode restrictions
+IS_EXAM_MODE=false

.gitignore

@@ -4,6 +4,7 @@ node_modules
 
 # local env files - ALL environment files should be ignored
 .env*
+!.env.example
 .env.local
 .env.*.local
 .env.development
@@ -65,4 +66,6 @@ server/.venv
 
 # Test files
 matplotlibSavefig.py
-LOCAL_TEST_ACCOUNTS.md
+LOCAL_TEST_ACCOUNTS.md
+
+docs/