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

# Processo de versionamento

> Entenda como o versionamento funciona na Lerian, o que esperar entre releases, como o versionamento semântico é automatizado e como planejar upgrades com orientação clara para cada versão major.

Versionamento não é apenas uma convenção de nomenclatura; é um processo automatizado que garante consistência entre releases. Esta seção explica como a automação conduz a geração de versões, como os cronogramas de suporte são definidos e o que esperar ao migrar entre versões.

## Automação de versionamento

***

Para garantir um processo de versionamento automatizado e previsível, seguimos os princípios do **versionamento semântico**.

### Como funciona

***

<Steps>
  <Step>
    Identifica os commits feitos desde a última versão.
  </Step>

  <Step>
    Determina a nova versão com base em regras pré-definidas.
  </Step>

  <Step>
    Gera e publica a nova versão automaticamente.
  </Step>
</Steps>

## Cronograma de suporte de versões

***

O Midaz segue uma política de suporte clara que define o que esperar de cada versão ao longo do seu ciclo de vida.

* **Suporte ativo (versão major atual):** inclui novas funcionalidades, correções de bugs e patches de segurança.
* **Suporte de segurança (pós-suporte ativo):** limitado apenas a patches críticos de segurança.

<Danger>
  Versões mais antigas não recebem mais atualizações ou suporte.
</Danger>

## Recomendações de caminho de upgrade

***

O upgrade entre versões do Midaz segue recomendações claras para manter o processo previsível e seguro.

* **Upgrades de versão minor** (`1.0.0 → 1.1.0`) são simples e exigem pouco esforço.
* **Upgrades de versão major** (`1.2.0 → 2.0.0`) podem envolver planejamento e testes.
* Cada versão major vem com um **guia de upgrade** claro para apoiar a transição.