Licenciamento

Esta página é a referência em tempo de execução de como uma licença molda o comportamento do Doconut: o que cada estado de licença permite, como as capacidades são concedidas e como inspecionar tudo isso a partir do código. (Para carregar uma licença, veja Começando → Configuração de Licença.)

Estados da licença e o que eles fazem

Duas consequências que vale a pena internalizar:

• Uma licença ausente não é uma licença temporária. Sem arquivo de licença, as páginas são renderizadas com marca d'água e nenhuma capacidade (pesquisa, anotação, plugins) está ativa. A experiência completa, sem marca d'água, requer uma Licença temporária (obter uma).
• Só uma licença rejeitada bloqueia a abertura. O vencimento do calendário/assinatura degrada para renderização com marca d'água; mas implantar uma compilação mais nova que a janela de versão da licença é rejeitado e falha rapidamente com um LicenseException, de modo que você a captura no deploy — não ao enviar silenciosamente saída com marca d'água. Essa exceção (de OpenDocumentAsync) traz a razão de License.RejectionMessage.

Capacidades

Doconut controla funcionalidades opcionais por capacidade. Hoje são os plugins opcionais Converter e DICOM, além dos recursos embutidos Pesquisa e Anotação, cada um concedido pela sua licença. O visualizador base não é uma capacidade — ele é o pré-requisito, exposto como IsViewerLicensed:

bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL license present AND covering this build's version

O único ponto de verificação que todo o pipeline usa é IsCapabilityGranted:

bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

Sua lógica, literalmente da implementação: uma licença temporária ativa (não expirada) concede todas as capacidades — incluindo capacidades que ainda não possuem uma flag de compra dedicada; uma licença comprada real concede exatamente suas flags Has* e tem negação padrão para qualquer coisa não mapeada. (Um arquivo legado do tipo TRIAL não é um direito — ele é tratado como não licenciado: marca d'água, nada concedido.)

Licenças temporárias

Pesquisa e Anotação normais usam suas capacidades existentes diretamente.

Licenças temporárias (Desenvolvedor/NFR) são marcadas por uma tag ExpiryNote e possuem uma data de expiração fixa:

A semântica de expiração difere por nível: uma licença temporária expira apenas na data LicenseExpiry (sua janela de assinatura é ignorada; uma licença temporária sem a data é tratada como expirada, como medida de segurança). Todas as demais licenças expiram na data da janela de assinatura/atualização.

Referência IDoconutLicenseService

Injete IDoconutLicenseService (namespace Doconut.Core.Interfaces; registrado como singleton — a licença é analisada uma vez na inicialização):

DoconutLicenseInfo expõe o instantâneo amigável para exibição em painéis administrativos: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, as flags Has*, os campos de licença temporária e RejectionMessage.

// Feature-flag your UI from the same source of truth the SDK uses
app.MapGet("/api/features", (IDoconutLicenseService lic) => Results.Ok(new
{
    viewer     = lic.IsViewerLicensed || lic.IsTemporary,
    search     = lic.IsCapabilityGranted(LicenseCapability.Search),
    annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
    conversion = lic.HasConverter,
    dicom      = lic.HasDicom,
}));

Verificação de saúde

AddDoconut() registra uma verificação de saúde "doconut" que relata o estado da licença/expiração através do mecanismo padrão do ASP.NET Core:

app.MapHealthChecks("/health");

Integre-a ao seu monitoramento e uma assinatura que está expirando se torna um alerta em vez de um ticket de suporte.

Atualizações de versão

Uma licença cobre uma janela de versão. Atualizar o pacote NuGet para uma compilação mais nova que essa janela torna a licença inválida para essa compilação: IsVersionValid passa a false e a abertura é bloqueada com um LicenseException (a razão está em License.RejectionMessage) — falha rápida deliberada, para que uma compilação obsoleta ou não licenciada seja detectada no deploy ao invés de marcar silenciosamente a saída de produção. Renove a assinatura, substitua o .lic e reinicie a aplicação para que AddDoconut() carregue a nova licença.