Mounts y extensiones
Un mount permite colocar una superficie del módulo en una zona estable del CRM sin copiar la interfaz completa. Debe utilizarse cuando el contenido aporta contexto a esa zona, no como sustituto de una
Un mount permite colocar una superficie del módulo en una zona estable del CRM sin copiar la interfaz completa. Debe utilizarse cuando el contenido aporta contexto a esa zona, no como sustituto de una navegación clara.
Mounts públicos de referencia
| Mount | Uso recomendado |
|---|---|
sidebar.main | Acceso principal a una vista del módulo. |
dashboard.widgets | Indicador breve o acceso rápido para el panel. |
client.profile.panels | Información adicional de la ficha 360 de un cliente. |
layout.widgets | Widget transversal, solo si es útil en varias zonas. |
calendar.providers | Eventos proyectados desde un servicio externo. |
ai.context.customer | Contexto resumido de un cliente. |
ai.context.prospect | Contexto resumido de un prospecto. |
ai.context.ticket | Contexto resumido de un ticket. |
Los nombres de mounts son contratos públicos. No dependas de selectores CSS, posiciones visuales o archivos internos del CRM.
Calendario
Un proveedor de calendario proyecta eventos dentro del rango solicitado. No debe insertar eventos duplicados ni convertir la vista del calendario en un almacén secundario de datos. Identifica cada evento de forma estable y devuelve solo el periodo pedido.
Contexto de IA
Un hook de contexto debe devolver datos breves y útiles para la decisión: estado, fechas, responsable y próximos pasos. No envíes HTML completo, consultas SQL, información no relacionada o datos personales que el agente no necesite.
Compatibilidad
Un mount debe degradar correctamente si la zona no está disponible, si el módulo está desactivado o si el usuario no tiene permiso. La funcionalidad principal del CRM no puede depender de que el módulo responda.
Vistas y acciones
Las vistas presentan información y las acciones modifican datos o ejecutan procesos. La separación ayuda a aplicar permisos y evita que una pantalla termine concentrando lógica no relacionada.
Endpoints públicos
Una acción para el personal y un endpoint para un servicio externo no son la misma superficie. Comparten lógica de negocio cuando conviene, pero tienen autenticación, límites y errores propios.