# 2026-04-16 - Consolidação de CnesEstablishments e correção do filtro de UF

## O que mudou

- o repositório legado `App\Modules\Repositories\Cnes\CnesEstablishmentsRepository` deixou de manter uma segunda implementação completa das consultas e passou a reutilizar o núcleo moderno de `App\Modules\CnesEstablishments`
- os endpoints antigos do domínio `Repositories` continuam com a mesma assinatura pública, mas agora usam adaptação de filtros e payloads para evitar divergência entre as duas versões
- o módulo `CnesEstablishments` passou a aceitar filtro de estado tanto por `codigo_uf` quanto por `sigla`, compatibilizando a busca com os dados retornados em `options`
- a listagem moderna de `CnesEstablishments` ganhou ordenação segura para colunas que já existiam na versão legada, como `estado_nome`, `municipio_nome`, `tipo_estabelecimento`, `tipo_unidade`, `natureza_juridica`, `id` e `updated_at`
- as opções de estados expostas pelo módulo moderno agora retornam também os metadados `sigla` e `codigo_uf`, reduzindo ambiguidade para consumidores futuros
- as estatísticas modernas passaram a incluir também contagem de `email` e `URL`, permitindo que o adapter legado reaproveite uma única consulta agregada em vez de executar uma query extra

## Impacto funcional

- reduz o risco de comportamento diferente entre a API nova de `CnesEstablishments` e os endpoints legados do hub de `Repositories`
- elimina duplicação relevante de SQL e de regras de paginação/consulta do repositório CNES
- reduz uma consulta desnecessária no caminho legado de `stats`
- corrige um ponto de inconsistência onde a UI podia trabalhar com `sigla` enquanto a filtragem esperava `codigo_uf`

## Arquivos envolvidos

- `src/Modules/CnesEstablishments/Repositories/CnesEstablishmentsRepository.php`
- `src/Modules/Repositories/Cnes/CnesEstablishmentsRepository.php`