> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/finger/changelog.md).

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