StenChat — Chat en Tiempo Real para Dolibarr

Módulo de mensajería instantánea y videollamadas peer-to-peer para Dolibarr ERP/CRM. Permite la comunicación en tiempo real entre usuarios del sistema con soporte para videochat WebRTC y uso compartido de pantalla.

Capacidades de Comunicación

Mensajería Instantánea

• Conversaciones uno a uno entre usuarios de Dolibarr
• Mensajes de texto en tiempo real vía polling AJAX
• Adjuntar archivos (imágenes, documentos, etc.)
• Notificaciones de escritorio para mensajes nuevos
• Historial persistente de mensajes en base de datos

Videollamadas (WebRTC)

• Videollamadas peer-to-peer sin servidores intermedios
• Inicio de videollamada mediante invitación enviada como mensaje de chat
• Botón "Unirse a videollamada" en el mensaje de invitación
• Modal emergente con video local y remoto (jQuery UI Dialog)
• Activación/desactivación de micrófono y cámara
• Uso compartido de pantalla (screen sharing)
• Señalización STUN (stun.l.google.com:19302)
• Funciona en redes LAN y mismo NAT
• Colgado y limpieza automática de señales

Presencia

• Indicador de usuarios en línea en tiempo real
• Heartbeat periódico para detectar conexión activa

Dependencias del Sistema

Dolibarr

• Versión mínima: 18.0
• Módulo instalado en htdocs/custom/stenchat/

PHP

• Versión mínima: 7.2
• Extensiones requeridas:
  • pdo_sqlite (para tabla de señalización WebRTC)
  • gd o imagick (para previsualización de imágenes)
  • zip (para compresión de archivos)

Navegador Web

• WebRTC: Chrome 56+, Firefox 52+, Edge 79+, Safari 12.1+
• Screen Sharing: Chrome 72+, Firefox 66+, Edge 79+
• JavaScript habilitado
• Notificaciones de escritorio (opcional, requiere permiso del usuario)

Servidor Web

• Apache o Nginx con PHP configurado
• Permisos de escritura en htdocs/custom/stenchat/files/ y htdocs/custom/stenchat/data/

Instalación

1. Descargar el módulo

# Clonar desde GitLab
git clone https://gitlab.com/jbasisty/dolibarr-chat.git /ruta/a/dolibarr/htdocs/custom/stenchat

# O descomprimir el archivo zip
unzip module_stenchat-1.0.0.zip -d /ruta/a/dolibarr/htdocs/custom/

2. Crear directorios de datos

mkdir -p /ruta/a/dolibarr/documents/custom/stenchat/files
chmod -R 755 /ruta/a/dolibarr/documents/custom/stenchat

3. Activar el módulo en Dolibarr

1. Inicie sesión en Dolibarr como administrador
2. Vaya a Inicio → Módulos → Módulo StenChat
3. Haga clic en Activar

4. Verificar instalación

• El módulo crea automáticamente las tablas necesarias (llx_stenchat_message, llx_stenchat_signal)
• Aparecerá un nuevo elemento Chat en el menú de navegación
• Haga clic en Chat para comenzar a usar la mensajería

Estructura del Módulo

custom/stenchat/
├── ajax/              # Endpoints AJAX (mensajes, señalización, archivos, max_id)
├── class/             # Clases PHP (StenChatDB, StenChatMessage)
├── core/modules/      # Descriptor del módulo (modStenChat.class.php)
├── css/               # Hojas de estilo
├── js/                # JavaScript del cliente (WebRTC, UI)
├── sql/               # Esquema de base de datos
├── chat.php           # Página principal del chat
└── .gitignore

Licencia

GNU General Public License v3.0 o superior.

Autor

Desarrollado para Dolibarr ERP/CRM por Javier Basisty.