> 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/iad/release_notes/1.1.0_release_notes.md).

# 1.1.0

**Data de lançamento:** 20 de março de 2026

## Visão geral

**Facephi IAD Service 1.1.0** tem como foco a resiliência operacional, a flexibilidade de configuração e um diagnóstico aprimorado. Esta é uma versão totalmente retrocompatível: não há alterações incompatíveis na API nem na configuração.

## Novidades

### Aprimoramento do diagnóstico de licenças

* **Tradução de erros de licença** — Mais de 110 códigos de status de licença agora são mapeados para mensagens compreensíveis, com recomendações práticas.
* **Relatório de erros padronizado** — Falhas relacionadas à licença geram entradas de log consistentes e estruturadas para facilitar a solução de problemas.

### Reforço da imagem Docker

* Imagem base simplificada, com superfície de ataque reduzida.
* Melhor gerenciamento de pacotes e fixação (pinning) de dependências.
* Saída de logs mais limpa (a saída excessiva de logs detalhados na detecção do Docker e na ativação do engine foi removida).

## Correções de bugs

* Os erros do proxy REST agora são criados e relatados por meio de um único fluxo de código consistente.
* As respostas de erro do engine são padronizadas antes de serem encaminhadas ao cliente.
* A saída excessiva de logs de depuração durante a detecção do ambiente Docker foi removida.

## Guia de atualização

Esta versão não exige etapas de migração. Os arquivos `config.json` existentes e os clientes da API continuam funcionando sem alterações.

Para aproveitar a configuração por meio de variáveis de ambiente, defina as variáveis `FACEPHI_IAD_REST_*` ou `FACEPHI_IAD_ENGINE_*` desejadas antes de iniciar o serviço ou no seu manifesto do Docker Compose / Kubernetes.

## Implantação

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:1.1.0

docker run -d \
  -p 6982:6982 \
  -v /path/to/license:/app/license \
  -v /path/to/config:/app/config \
  --name iad-service \
  facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:1.1.0
```

## Requisitos

| Componente          | Requisito                                |
| ------------------- | ---------------------------------------- |
| Sistema operacional | Linux x86\_64 (Ubuntu 24.04 recomendado) |
| Licença             | Arquivo de licença válido da Facephi     |
| Docker              | Para implantação em contêineres          |

## Problemas conhecidos

Nenhum problema foi identificado nesta versão.

## Suporte

Para obter Suporte Técnico, entre em contato com seu representante da Facephi.

## Documentação

* [Referência de configuração](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/iad.md)
* [Referência da API](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/iad/technical_documentation/api_reference.md)
* [Registro de alterações](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/iad/changelog.md)
