Changelog

[2.1.0] - 2026-06-11

Adicionado

• Novo Endpoint de gerenciamento GET /api/v1/finger/metrics que retorna usageCountersEnabled, extractCount, authenticateCount e totalCount.

• Contagem de uso condicionada por Licença para as operações POST /api/v1/finger/extract e POST /api/v1/finger/authenticate concluídas com sucesso, por meio da chave de metadados ActivateUsageCounters.

Alterado

• Melhorado o comportamento de sincronização dos contadores de uso para reduzir o descompasso entre as métricas do lado do serviço e os valores do painel de Licença.

• Atualizada a cobertura de testes de Integração para validar o comportamento das métricas sem depender de temporizações frágeis.

Documentação

• Atualizados README.md, o OpenAPI, as notas de Versão e a documentação técnica para incluir o contrato de /metrics e a configuração dos contadores de uso.

• Documentados os formatos de imagem suportados para as entradas baseadas em imagem em extract e authenticate: wsq, bmp, png, jpg, jp2.

[2.0.0] - 2026-06-08

Mudanças incompatíveis (Breaking Changes)

• Removidas as rotas públicas herdadas POST /api/v1/finger/create-template e POST /api/v1/finger/verify.

• Introduzido o contrato público 2.0.0 para POST /api/v1/finger/extract e POST /api/v1/finger/authenticate.

• Alterados os payloads de requisição e resposta das operações de Impressão Digital, incompatíveis com clientes 1.x.x.

Adicionado

• Camada de mapeamento da API pública (FingerContractMapper) que traduz o contrato público de Facephi para o contrato do backend de processamento.

• Validação de entrada (codificação Base64, campos obrigatórios, nomes de posição, scanType) que retorna error400.

• Testes unitários para o mapeamento de contratos e a validação (FingerContractMapperTest).

• Asserções de testes de integração que verificam os campos do contrato público, a ausência de campos específicos da implementação e as respostas 404 nas rotas herdadas removidas.

Alterado

• Renomeados os campos de resposta para: fingerTemplate, quality, qualityDetails, authStatus, similarity, sdkDuration, queueDuration.

• A validação de authThreshold nas solicitações de autenticação é estritamente do tipo inteiro (0..100), conforme o contrato público documentado.

• Normalizadas as mensagens do payload público error400 de extract/authenticate/health para uma linguagem orientada a produto.

Documentação

• Renovadas as guias de instalação, técnica e de visão geral para o lançamento público 2.0.0.

Testes

• Testes unitários: FingerContractMapperTest, que cobre o mapeamento, a validação e a ausência de campos internos em todas as respostas.

• Testes de integração: coleção de Newman atualizada para o contrato público 2.0.0 com asserções de inspeção de stubs e verificações explícitas das rotas herdadas removidas.

[1.0.0] - 2026-04-20

Adicionado

• Pacote inicial de documentação pública em doc/.

• Especificação OpenAPI 3.0 para todos os Endpoints públicos.

• Guias de instalação e de especificações técnicas.

• Notas de Versão para o lançamento público inicial do serviço.

Escopo do serviço

• Endpoint de criação de templates de Impressão Digital.

• Endpoint de verificação 1:1 de Impressão Digital.

• Endpoints de gerenciamento para Versão, saúde e configuração em tempo de execução.

• Precedência de configuração em tempo de execução com sobrescrita por variáveis de ambiente.

• Modelo de papéis de implantação master/worker para operação em cluster.