Skip to main content
9 de março de 2026 Atualização da documentação Revisão recomendada

​
Afeta

Equipes que estão saindo do deploy standalone do plugin CRM para o componente CRM embarcado no Midaz. Esta atualização se aplica ao portal público de documentação. Ela não muda o comportamento da API em runtime, a menos que a documentação do produto vinculada diga o contrário.

​
O que mudou

Um novo guia de migração foi publicado para ajudar as equipes a sair do deploy standalone do plugin-crm e ir para o componente CRM integrado no Midaz. A partir do Midaz v3.5.0 e do Helm Chart v5.x, o deploy do CRM não é mais feito como plugin separado. Agora ele está embarcado diretamente no monorepo e no Helm chart do Midaz.

​
O que o guia cobre

​
Comparação de arquitetura

Uma comparação lado a lado entre a arquitetura do plugin standalone (repositório separado, ciclo de release independente, Helm chart dedicado no namespace midaz-plugins) e o componente integrado (monorepo em components/crm/, Helm chart único, namespace compartilhado).

​
Migração passo a passo

O guia percorre todo o processo de migração:
  1. Avaliação pré-migração: Verifique a versão atual do plugin e o estado dos dados
  2. Mapeamento de configuração: Como os valores Helm do standalone se traduzem no chart integrado
  3. Continuidade dos dados: Garantir que os dados de CRM existentes sejam levados sem perda
  4. Procedimento de cutover: Passos para trocar o deploy standalone pelo integrado
  5. Validação: Confirmar que a migração terminou com sucesso

​
Procedimento de rollback

Se surgirem problemas durante a migração, o guia traz um procedimento de rollback para restaurar o deploy standalone.

​
Solução de problemas

Problemas comuns de migração e como resolvê-los, incluindo conflitos de namespace, divergências de configuração e problemas de acesso aos dados.
Deploys novos do Midaz no Helm Chart v5.x ou posterior não precisam deste guia. O CRM é habilitado diretamente nos valores do Helm, conforme descrito no guia de instalação do Midaz.

​
Atualização da navegação

O CRM agora aparece na navegação da documentação como módulo nativo do Midaz, e não na seção de plugins. A página de visão geral do CRM foi atualizada para refletir o status integrado. Este guia está disponível em inglês, português e espanhol.

​
Impacto

Esta é uma atualização de documentação. As integrações existentes não precisam de migração apenas por esta nota de release.

​
O que você precisa fazer

1
Revise o guia de migração do CRM antes de planejar mudanças no deploy do CRM.

​
Prazo

Nenhum.

​
Por quê

O guia documenta como sair do CRM standalone e chegar ao componente CRM nativo do Midaz atual.