diff --git a/.env.dev.example b/.env.dev.example
new file mode 100644
index 0000000..99dc107
--- /dev/null
+++ b/.env.dev.example
@@ -0,0 +1,59 @@
+# ========================================
+# OpenCCB Local Development Environment
+# Copia este archivo a .env.dev y completa secretos reales
+# ========================================
+
+# Database URLs for local development
+CMS_DATABASE_URL=postgresql://user:password@localhost:5432/openccb_cms
+LMS_DATABASE_URL=postgresql://user:password@localhost:5432/openccb_lms
+
+# General fallback
+DATABASE_URL=postgresql://user:password@localhost:5432/openccb_cms
+
+# JWT Secret (solo dev)
+JWT_SECRET=change_me_dev_secret
+
+# Logging
+RUST_LOG=debug
+
+# Environment
+ENVIRONMENT=dev
+
+# AI Configuration
+# Providers: 'openai' or 'local'
+AI_PROVIDER=local
+OPENAI_API_KEY=
+
+# Local AI (Ollama & Whisper)
+LOCAL_OLLAMA_URL=http://192.168.0.5:11434
+LOCAL_WHISPER_URL=http://192.168.0.5:9000
+DEV_OLLAMA_URL=http://192.168.0.5:11434
+DEV_WHISPER_URL=http://192.168.0.5:9000
+DEV_BARK_URL=http://localhost:8000
+
+# SMTP for local development
+SMTP_ENABLED=true
+SMTP_HOST=mailpit
+SMTP_PORT=1025
+SMTP_FROM=[LOCAL-QA] OpenCCB Dev <dev@example.com>
+SMTP_USERNAME=
+SMTP_PASSWORD=
+
+# Next.js public variables for local development
+NEXT_PUBLIC_CMS_API_URL=http://localhost:3001
+NEXT_PUBLIC_LMS_API_URL=http://localhost:3002/lms-api
+NEXT_PUBLIC_STUDIO_DOMAIN=localhost
+NEXT_PUBLIC_LEARNING_DOMAIN=localhost
+
+# External MySQL/SAM integration (replace with real values)
+MYSQL_DATABASE_URL=mysql://user:password@host:3306/sige_sam_v3
+SAM_DIAGNOSTICO_DATABASE_URL=mysql://user:password@host:3306/SAM_diagnostico
+SAM_DATABASE_URL=mysql://user:password@host:3306/sige_sam_v3
+
+# Additional AI settings
+LOCAL_VIDEO_BRIDGE_URL=http://localhost:8000
+EMBEDDING_MODEL=nomic-embed-text
+LOCAL_LLM_MODEL=llama3.2:3b
+
+# Backend-to-backend (LMS -> CMS)
+CMS_API_URL=http://studio:3001
diff --git a/.gitignore b/.gitignore
index 47f0c80..7120958 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,6 +17,7 @@ build/
 # --- Variables de Entorno (SEGURIDAD) ---
 # Nunca subas tus llaves secretas o credenciales
 .env
+.env.dev
 .env*.local
 .env.production
 
@@ -39,7 +40,7 @@ services/lms-service/dev_keys/
 *.pem
 ubuntu.pem
 
-# --- TLS/ACME secrets (never commit) ---
+# --- TLS/ACME secrets (never cApoca225!ommit) ---
 nginx/certs-data/**
 *.key
 *.csr