# Central de Changelogs

## Rota

- `/adm/changelogs`

## O que e

Tela corporativa de governanca dos changelogs, com grade principal, importacao, acoes em lote e detalhamento operacional.

## Para que serve

- centralizar o historico oficial de changelogs do produto;
- importar arquivos de `docs/changelogs` para o banco;
- evitar duplicidade por hash durante importacoes;
- atualizar registros existentes quando o operador optar por forcar a sincronizacao;
- revisar detalhes, publicar em lote e abrir o feed interno ou publico.

## Blocos principais

- hero com contexto da central e atalhos para feed interno e publico;
- KPIs com totais, indicadores e estado da operacao;
- grade principal em DataTable com filtros server-side;
- importacao em lote a partir de `docs/changelogs`;
- detalhe lateral para revisar markdown, arquivos e acoes relacionadas.

## Botoes do topo

- `Importar changelogs`: envia arquivos selecionados manualmente;
- `Importar docs/changelogs para o banco`: le os arquivos versionados e mostra um relatorio detalhado de importados, atualizados, duplicados e invalidos;
- `Feed interno`: abre a visao operacional de changelogs;
- `Feed publico`: abre a vitrine publica dos changelogs publicados.

## Observacoes

- a importacao de `docs/changelogs` compara o hash do markdown para identificar duplicidade;
- quando o modo forcar estiver desligado, itens repetidos entram como duplicados e nao sao reinseridos;
- quando o modo forcar estiver ligado, itens existentes podem ser atualizados;
- o retorno da importacao agora detalha os arquivos por status e tambem informa normalizacao automatica de emojis quando houver.