Afecta a
Equipos que pasan del despliegue standalone del plugin de CRM al componente CRM embebido en Midaz. Esta actualización aplica al portal de documentación pública. No cambia el comportamiento de la API en tiempo de ejecución, a menos que la documentación de producto enlazada indique lo contrario.
Qué cambió
Se publicó una nueva guía de migración para ayudar a los equipos a pasar del despliegue standalone de
plugin-crm al componente CRM integrado en Midaz.
A partir de Midaz v3.5.0 y Helm Chart v5.x, CRM ya no se despliega como un plugin separado. Ahora está embebido directamente en el monorepo y el Helm chart de Midaz.
Qué cubre la guía
Comparación de arquitectura
Una comparación lado a lado de la arquitectura del plugin standalone (repositorio separado, ciclo de release independiente, Helm chart dedicado en el namespacemidaz-plugins) frente al componente integrado (monorepo en components/crm/, un solo Helm chart, namespace compartido).
Migración paso a paso
La guía recorre el proceso completo de migración:- Evaluación previa a la migración — Verifica la versión actual del plugin y el estado de los datos
- Mapeo de configuración — Cómo se traducen los valores de Helm standalone al chart integrado
- Continuidad de datos — Asegurar que los datos de CRM existentes se conserven sin pérdida
- Procedimiento de cutover — Pasos para cambiar del despliegue standalone al integrado
- Validación — Confirmar que la migración se completó correctamente
Procedimiento de rollback
Si surgen problemas durante la migración, la guía incluye un procedimiento de rollback para restaurar el despliegue standalone.Solución de problemas
Problemas comunes de migración y sus resoluciones, incluidos los conflictos de namespace, las discrepancias de configuración y los problemas de acceso a los datos.Los despliegues nuevos de Midaz (v5.x+) no necesitan esta guía. CRM se habilita directamente en los valores de Helm, como se describe en la guía de instalación de Midaz.
Actualización de navegación
CRM ahora aparece como un módulo nativo de Midaz en la navegación de la documentación, en lugar de estar bajo la sección de plugins. La página de resumen de CRM se actualizó para reflejar su estado integrado. Esta guía está disponible en inglés, portugués y español.
Impacto
Esta es una actualización de documentación. Las integraciones existentes no necesitan una migración solo por esta nota de versión.
Qué debes hacer
1
Revisa la guía de migración de CRM antes de planificar cambios en el despliegue de CRM.