> ## 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 a transição do deploy standalone do plugin-crm para o componente CRM integrado no Midaz v3.5.0 e Helm Chart v5.x.

<Badge stroke icon="calendar-days" iconType="regular">9 de março de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Atualização de documentação</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Revisão recomendada</Badge>

## Afeta

***

Times migrando do deploy standalone do plugin CRM para o componente CRM embarcado no Midaz.

Esta atualização se aplica ao portal de documentação pública. Não altera o comportamento da API em runtime, a menos que a documentação do produto vinculada indique o contrário.

## O que mudou

***

Um novo [guia de migração](/pt/midaz/crm/crm-migration-guide) foi publicado para ajudar os times na transição do deploy standalone do `plugin-crm` para o componente CRM integrado no Midaz.

A partir do **Midaz v3.5.0** e do **Helm Chart v5.x**, o CRM não é mais deployado como plugin separado. Agora ele está embarcado diretamente no monorepo do Midaz e no chart Helm.

### O que o guia cobre

***

### Comparação de arquitetura

Uma comparação lado a lado da arquitetura standalone do plugin (repositório separado, ciclo de release independente, chart Helm dedicado no namespace `midaz-plugins`) versus o componente integrado (monorepo em `components/crm/`, chart Helm ú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 standalone são traduzidos para o chart integrado
3. **Continuidade de dados** — Garantir que os dados existentes do CRM sejam mantidos sem perda
4. **Procedimento de cutover** — Passos para mudar do deploy standalone para o integrado
5. **Validação** — Confirmação de que a migração foi concluída com sucesso

### Procedimento de rollback

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

### Troubleshooting

Problemas comuns de migração e suas resoluções, incluindo conflitos de namespace, incompatibilidades de configuração e problemas de acesso a dados.

<Info>
  Novos deploys do Midaz (v5.x+) não precisam deste guia. O CRM é habilitado diretamente nos valores Helm conforme descrito no [guia de instalação do Midaz](/pt/platform/helm/midaz/midaz-installation).
</Info>

### Atualização de navegação

***

O CRM agora está listado como módulo nativo do Midaz na navegação da documentação, em vez de ficar 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. Integrações existentes não precisam de migração apenas com base nesta release note.

## O que você precisa fazer

***

<Steps>
  <Step>
    Revise o guia de migração do CRM antes de planejar mudanças no deploy do CRM.
  </Step>
</Steps>

### Prazo

Nenhum.

### Por quê

O guia documenta como migrar do CRM standalone para o atual componente CRM nativo do Midaz.