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>

README.md

@@ -0,0 +1,141 @@
+# WhatsApp Centralizado
+
+Plataforma de mensajería centralizada con automatización de chatbots, gestión multi-agente e integración profunda con Odoo.
+
+## Descripción
+
+WhatsApp Centralizado es una solución empresarial similar a Kommo, Wasapi, ManyChat y Brevo, diseñada para:
+
+- **Automatizar conversaciones** con un potente Flow Builder visual (drag & drop)
+- **Gestionar equipos de agentes** con colas inteligentes, SLA y métricas
+- **Integrar con Odoo** de forma bidireccional (CRM, Ventas, Inventario, Helpdesk, etc.)
+- **Conectar múltiples números** de WhatsApp desde una sola plataforma
+
+## Características Principales
+
+### Flow Builder Visual
+- 30+ tipos de nodos (mensajes, lógica, validación, acciones)
+- Editor drag & drop con React Flow
+- Variables y contexto de conversación
+- A/B Testing integrado
+- Integración con IA (GPT, Claude, Ollama)
+- Sub-flujos reutilizables
+
+### Gestión Multi-Agente
+- Sistema de colas (Ventas, Soporte, etc.)
+- Asignación inteligente (round-robin, least-busy, skill-based)
+- Transferencia bot → humano → bot
+- Panel de supervisor en tiempo real
+- SLA tracking con alertas
+- Encuestas CSAT integradas
+
+### Integración Odoo
+- Conexión bidireccional via XML-RPC
+- 8 módulos soportados (Contactos, CRM, Ventas, Inventario, Helpdesk, Facturación, Calendario, Productos)
+- 20+ acciones disponibles en flujos
+- Automatizaciones Odoo → WhatsApp
+- Módulo Odoo con widget de chat
+
+## Stack Tecnológico
+
+| Componente | Tecnología |
+|------------|------------|
+| WhatsApp Core | Node.js + TypeScript + Baileys |
+| API Gateway | Python + FastAPI |
+| Flow Engine | Python |
+| Frontend | React + TypeScript |
+| Base de Datos | PostgreSQL + Redis |
+| Despliegue | Docker + Docker Compose |
+
+## Arquitectura
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                        FRONTEND (React)                         │
+│     Dashboard  │  Inbox Chat  │  Flow Builder (React Flow)      │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                    API GATEWAY (FastAPI)                         │
+│        JWT Auth  │  REST API  │  WebSocket (tiempo real)        │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+              ┌───────────────┼───────────────┐
+              ▼               ▼               ▼
+┌──────────────────┐ ┌──────────────┐ ┌──────────────────────────┐
+│  WHATSAPP CORE   │ │  FLOW ENGINE │ │  INTEGRATIONS            │
+│  (Node.js)       │ │  (Python)    │ │  (Python)                │
+│  Baileys         │ │  Motor bot   │ │  Odoo, Webhooks          │
+└──────────────────┘ └──────────────┘ └──────────────────────────┘
+                              │
+                    ┌─────────┴─────────┐
+                    ▼                   ▼
+              ┌──────────┐        ┌──────────┐
+              │PostgreSQL│        │  Redis   │
+              └──────────┘        └──────────┘
+```
+
+## Inicio Rápido
+
+### Requisitos
+- Docker 24.0+
+- Docker Compose 2.20+
+- 4GB RAM mínimo (8GB recomendado)
+
+### Instalación
+
+```bash
+# Clonar repositorio
+git clone https://git.consultoria-as.com/tu-usuario/WhatsAppCentralizado.git
+cd WhatsAppCentralizado
+
+# Copiar configuración
+cp .env.example .env
+
+# Editar variables de entorno
+nano .env
+
+# Iniciar servicios
+docker-compose up -d
+
+# Aplicar migraciones
+docker-compose exec api-gateway alembic upgrade head
+
+# Crear usuario admin
+docker-compose exec api-gateway python scripts/create_admin.py
+```
+
+### Acceso
+- Frontend: http://localhost:3000
+- API: http://localhost:8000
+- Docs API: http://localhost:8000/docs
+
+## Documentación
+
+- [Diseño del Sistema](docs/plans/2026-01-29-whatsapp-centralizado-design.md)
+- [Arquitectura](docs/architecture/README.md)
+- [API Reference](docs/api/README.md)
+- [Flow Builder](docs/flow-builder/README.md)
+- [Integración Odoo](docs/odoo-integration/README.md)
+- [Guía de Despliegue](docs/deployment/README.md)
+
+## Roadmap
+
+- [x] Diseño y arquitectura
+- [ ] Fase 1: Fundación (WhatsApp Core + API + Frontend básico)
+- [ ] Fase 2: Flow Engine Básico
+- [ ] Fase 3: Inbox Avanzado + Multi-agente
+- [ ] Fase 4: Flow Engine Avanzado
+- [ ] Fase 5: Integración Odoo Completa
+- [ ] Fase 6: Módulo Odoo
+- [ ] Fase 7: Reportes y Analytics
+- [ ] Fase 8: Multi-canal (Email, SMS)
+
+## Licencia
+
+Propietario - Todos los derechos reservados.
+
+## Contacto
+
+Desarrollado para uso interno empresarial.