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

# Fundamentos do licenciamento

> Entenda como a Lerian licencia recursos enterprise e plugins, por que as licenças existem e como o modelo modular de monetização é estruturado.

O Midaz — nosso Core source-available — é gratuito para usar. Mas quando se trata de monetizar o restante do portfólio da Lerian — produtos, recursos e plugins enterprise, sejam desenvolvidos pela Lerian ou por nossos parceiros — dependemos de um sistema de licenciamento para gerenciar o acesso.

## Por que licenças importam

***

Sem licenças, não podemos **garantir o pagamento** antes do uso, **personalizar o acesso** por cliente, ou **escalar o suporte** e operações comerciais com confiança.

O licenciamento nos ajuda a proteger receita, simplificar operações e garantir que os clientes recebam o que pagaram; nem menos, nem mais.

## Como a Lerian monetiza

***

O modelo de negócios da Lerian é modular. Cada linha de produto pode requerer uma licença para desbloquear o acesso:

| Linha de Receita               | Descrição                                                                                      |
| :----------------------------- | :--------------------------------------------------------------------------------------------- |
| **Suporte**                    | Suporte técnico + acesso a plugins enterprise como pacote                                      |
| **Marketplace / Plugins**      | Licenças individuais de plugins, cobradas mensalmente. Inclui plugins da Lerian e de terceiros |
| **Aprendizado e Certificação** | Cursos e certificações relacionados ao Midaz e seu ecossistema                                 |
| **Serviços Profissionais**     | Consultoria customizada e entrega de projetos                                                  |

<Note>
  Recursos enterprise incluídos no plano de Suporte são na verdade plugins — mas licenciados como um pacote unificado em vez de um por um.
</Note>

## Cenários de licenciamento suportados

***

Seu plugin deve suportar todos os seguintes casos de uso:

| Cenário                            | Descrição                                                        |
| :--------------------------------- | :--------------------------------------------------------------- |
| **Community**                      | Apenas OSS. Nenhuma licença necessária                           |
| **Apenas suporte**                 | Uma licença global para recursos enterprise da Lerian            |
| **Suporte + plugins Lerian**       | Uma licença global + licenças individuais por plugin Lerian      |
| **Suporte + plugins de terceiros** | Uma licença global + licenças individuais por plugin de parceiro |
| **Suporte + plugins mistos**       | Configuração combinada: licenças Lerian + parceiro               |

<Danger>
  Nosso sistema também deve suportar futuros modelos SaaS, permitindo que parceiros licenciem e distribuam seus próprios plugins independentemente.
</Danger>

## Como o License Manager funciona

***

### Powered by KeyGen

Usamos o [KeyGen](https://keygen.sh/) para gerenciar chaves de licença e seu ciclo de vida. Ele suporta:

* Geração de chaves de licença
* Controle de status (ativa, expirada, revogada)
* Validação periódica
* Integração com futuros fluxos de cobrança

Embora estejamos atualmente usando ciclos de cobrança mensais, nosso sistema está preparado para outros intervalos, como quinzenal, trimestral ou anual.

## Fluxo de validação de licença

***

Todo plugin ou recurso enterprise deve validar regularmente sua licença usando o SDK oficial **uma vez por semana**.

<Note>
  O SDK lida com cache, lógica de retry e degradação graciosa, então você não precisa construir essa lógica você mesmo.
</Note>

### Resultados de status

| Status                                                                    | Comportamento                                                           |
| :------------------------------------------------------------------------ | :---------------------------------------------------------------------- |
| <Icon icon="square-check" color="green" /> **Licença ativa**              | Acesso completo e cliente em boa situação.                              |
| <Icon icon="triangle-exclamation" color="#f1ba5c" /> **Licença expirada** | Continuar acesso (período de carência de 2 semanas) e mostrar aviso.    |
| <Icon icon="circle-minus" color="#ff0000" /> **Licença revogada**         | Bloquear acesso após o período de carência até a licença ser restaurada |

## Arquitetura

***

### Visão geral da validação de licença

<Frame>
  <img src="https://mintcdn.com/lerian-49cb71fc/dIivJl2jpQJ0JZcX/images/pt/d2/license-manager-1.svg?fit=max&auto=format&n=dIivJl2jpQJ0JZcX&q=85&s=531ba4891b369047134c2e2215927f56" alt="License Manager 1 Jp" width="1292" height="1090" data-path="images/pt/d2/license-manager-1.svg" />
</Frame>

Cada plugin usa o **License SDK** para verificar se a licença fornecida pelo cliente é válida. Aqui está o que acontece nos bastidores:

1. O SDK envia a chave de licença e informações do cliente para o servidor da Lerian.
2. A Lerian verifica o status da licença:
   * Está ativa?
   * Está expirada, mas ainda dentro do período de carência?
   * Foi revogada?
3. O servidor responde com uma resposta que seu plugin pode usar para permitir, avisar ou bloquear o acesso.
4. Para melhorar a performance, este resultado é armazenado em um cache local para que não precise verificar toda vez.

<Note>
  **O que você precisa fazer**: Incluir o License SDK no seu plugin. Ele cuidará da validação e cache automaticamente.
</Note>

### Como cada plugin usa licenciamento

<Frame>
  <img src="https://mintcdn.com/lerian-49cb71fc/dIivJl2jpQJ0JZcX/images/pt/d2/license-manager-2.svg?fit=max&auto=format&n=dIivJl2jpQJ0JZcX&q=85&s=277ea549a955850ccac925c5edeb4a57" alt="Como um plugin usa o SDK de licenças para validar no servidor de licenças e armazenar o resultado em cache local para permitir, avisar ou bloquear o acesso" width="3284" height="633" data-path="images/pt/d2/license-manager-2.svg" />
</Frame>

Todo plugin ou recurso enterprise — seja desenvolvido pela Lerian ou um parceiro — usa o **License SDK** para validar sua licença.

* Cada plugin tem sua própria chave de licença.
* O SDK verifica a licença comunicando-se com o sistema de licenciamento da Lerian.
* A Lerian verifica se a licença é válida usando um backend seguro (powered by KeyGen).
* Em versões futuras, licenças serão automaticamente gerenciadas com base na cobrança.

<Note>
  **O que você precisa fazer**: Adicionar o License SDK ao seu plugin e garantir que ele chame `validateLicense()` antes de expor qualquer recurso pago.
</Note>

## Benefícios para parceiros

***

O License Manager é mais do que apenas um porteiro; é uma fundação para escalar de forma responsável e sustentável.

### Resolve

* Uso não autorizado de recursos pagos
* Rastreamento e revogação manual de licenças
* Riscos legais e de compliance

### Possibilita

* Monetização transparente de plugins de parceiros
* Modelos flexíveis de revenda e pacotes
* Políticas de licenciamento configuráveis: trials, renovações, janelas de tolerância

<Danger>
  Versões futuras serão integradas com nosso sistema de cobrança para automatizar revogação e renovação de licenças.
</Danger>