# 2026-04-16 - API Docs com cobertura dinamica dos YAML faltantes

## O que mudou

- a central de `API Docs` passou a montar especificacoes dinamicas quando encontra YAMLs placeholder, aproveitando anotacoes dos controllers e specs auxiliares ja existentes
- `index.yaml` e `openapi.yaml` deixaram de ser apenas agregadores opacos para a tela e agora podem ser consultados na central por meio de bundle dinamico dos modulos referenciados
- `kpis.yaml` tambem passou a ser recuperado por fallback, em vez de continuar fora da lista por estar vazio
- reforcei o padrao dos YAMLs gerados com `license.url`, `operationId` e respostas `400` basicas
- ajustei `asaas-admin.yaml` para o mesmo nivel minimo de padronizacao

## Valor entregue

- elimina a sensacao de lista incompleta na central de documentacao, mesmo quando o repositorio ainda tem arquivos placeholder ou agregadores parciais
- melhora a confianca para consulta tecnica porque a tela deixa de esconder modulos importantes so por falta de acabamento manual no YAML
- cria uma base mais resiliente para evoluir a documentacao sem depender de preencher tudo de uma vez a mao