> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia de migração do CRM standalone

> Novo guia de migração do CRM para sair do deploy standalone do plugin-crm e ir para o componente CRM integrado no Midaz v3.5.0 e no Helm Chart v5.x.

9 de março de 2026Atualização da documentaçãoRevisã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](https://docs.lerian.studio/pt/products/midaz/crm/crm-migration-guide.md) 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.

> [!NOTE]
>
> 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](https://github.com/LerianStudio/helm/blob/main/charts/midaz/README.md#install-midaz-helm-chart).

### 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

***

**Step 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.