Initial commit: Documentación completa del proyecto WhatsApp Centralizado

- README principal con descripción del proyecto
- Documento de diseño completo (arquitectura, DB, flujos)
- Documentación de API REST y WebSocket
- Guía del Flow Builder (30+ tipos de nodos)
- Documentación de integración con Odoo
- Guía de despliegue con Docker
- Esquema de base de datos
- Estructura de carpetas del proyecto
- Archivo .env.example con todas las variables

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.env.example

@@ -0,0 +1,109 @@
+# =============================================================================
+# WhatsApp Centralizado - Variables de Entorno
+# =============================================================================
+# Copiar este archivo a .env y configurar los valores
+
+# -----------------------------------------------------------------------------
+# Base de Datos PostgreSQL
+# -----------------------------------------------------------------------------
+DB_USER=whatsapp_admin
+DB_PASSWORD=cambiar_por_password_seguro_32_caracteres
+DB_HOST=postgres
+DB_PORT=5432
+DB_NAME=whatsapp_central
+
+# URL completa de conexión (generada automáticamente en docker-compose)
+# DATABASE_URL=postgresql://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}
+
+# -----------------------------------------------------------------------------
+# Redis
+# -----------------------------------------------------------------------------
+REDIS_HOST=redis
+REDIS_PORT=6379
+REDIS_URL=redis://redis:6379
+
+# -----------------------------------------------------------------------------
+# JWT / Autenticación
+# -----------------------------------------------------------------------------
+# Generar con: openssl rand -base64 64
+JWT_SECRET=cambiar_por_secreto_aleatorio_64_caracteres
+JWT_ACCESS_TOKEN_EXPIRE_MINUTES=60
+JWT_REFRESH_TOKEN_EXPIRE_DAYS=7
+
+# -----------------------------------------------------------------------------
+# Dominio / URLs
+# -----------------------------------------------------------------------------
+DOMAIN=localhost
+FRONTEND_URL=http://localhost:3000
+API_URL=http://localhost:8000
+WHATSAPP_CORE_URL=http://whatsapp-core:3001
+
+# -----------------------------------------------------------------------------
+# WhatsApp Core (Node.js)
+# -----------------------------------------------------------------------------
+NODE_ENV=production
+WS_PORT=3001
+
+# -----------------------------------------------------------------------------
+# Odoo (Opcional)
+# -----------------------------------------------------------------------------
+# Configurar después de instalar
+ODOO_URL=https://odoo.tuempresa.com
+ODOO_DB=production
+ODOO_USER=api-whatsapp@tuempresa.com
+ODOO_API_KEY=
+
+# -----------------------------------------------------------------------------
+# OpenAI / IA (Opcional)
+# -----------------------------------------------------------------------------
+# Para nodos de AI Response
+OPENAI_API_KEY=
+OPENAI_MODEL=gpt-4
+
+# Anthropic Claude (alternativa)
+ANTHROPIC_API_KEY=
+ANTHROPIC_MODEL=claude-3-sonnet-20240229
+
+# Ollama local (alternativa)
+OLLAMA_URL=http://localhost:11434
+OLLAMA_MODEL=llama2
+
+# -----------------------------------------------------------------------------
+# Email (Opcional - para notificaciones)
+# -----------------------------------------------------------------------------
+SMTP_HOST=smtp.tuempresa.com
+SMTP_PORT=587
+SMTP_USER=notificaciones@tuempresa.com
+SMTP_PASSWORD=
+SMTP_FROM=WhatsApp Central <notificaciones@tuempresa.com>
+
+# -----------------------------------------------------------------------------
+# Webhooks
+# -----------------------------------------------------------------------------
+# Secret para validar webhooks entrantes de Odoo
+ODOO_WEBHOOK_SECRET=cambiar_por_secreto_aleatorio
+
+# -----------------------------------------------------------------------------
+# Seguridad
+# -----------------------------------------------------------------------------
+# Bcrypt rounds para passwords
+BCRYPT_ROUNDS=12
+
+# Rate limiting
+RATE_LIMIT_REQUESTS=100
+RATE_LIMIT_WINDOW=60
+
+# CORS (separado por comas)
+CORS_ORIGINS=http://localhost:3000,https://chat.tuempresa.com
+
+# -----------------------------------------------------------------------------
+# Logging
+# -----------------------------------------------------------------------------
+LOG_LEVEL=INFO
+LOG_FORMAT=json
+
+# -----------------------------------------------------------------------------
+# Desarrollo (solo para dev)
+# -----------------------------------------------------------------------------
+DEBUG=false
+RELOAD=false