# API Docs

## Rota

- `/adm/api-docs`

## O que é

Central interna de documentação OpenAPI com geração, recarga e visualização imediata no Swagger UI.

## Para que serve

- navegar pelas especificações da API;
- disparar geração de documentação;
- limpar maps e validar cobertura dos YAMLs.

## Blocos principais

- hero da central;
- KPIs rápidos;
- resumo de leitura;
- lista lateral de arquivos OpenAPI;
- painel principal do Swagger UI.

## Botões do topo

- `Gerar docs`: dispara a geração das especificações;
- `Bust maps`: reinicializa os maps associados;
- `Atualizar painel`: recarrega lista e leitura.

## Observações

- a lista lateral é a navegação principal entre specs;
- o painel da direita sempre mostra o arquivo ativo.