{"v":{"area":"admin","slug":"dev-changelogs","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/dev-changelogs.md","relative_path":"docs/readme/admin/dev-changelogs.md","title":"Changelogs da Equipe","html":"<h1>Changelogs da Equipe</h1><h2>Rota</h2><ul><li><code>/adm/dev-changelogs</code></li></ul><h2>O que e</h2><p>Tela autoral para colaboradores registrarem changelogs proprios sem depender da central corporativa.</p><h2>Para que serve</h2><ul><li>gerar changelogs em markdown no padrao do projeto;</li><li>gravar arquivos em <code>docs/changelogs</code>;</li><li>espelhar o registro no banco oficial de changelogs;</li><li>permitir historico proprio, upload de markdown e revisao do conteudo salvo;</li><li>remover emojis automaticamente no envio para preservar o padrao editorial do historico;</li><li>acompanhar indicadores de volume, score documental, impacto e ritmo de documentacao;</li><li>conectar a experiencia com a gamificacao tecnica baseada em commits, changelogs, badges e metas.</li></ul><h2>Blocos principais</h2><ul><li>hero com contexto da experiencia autoral;</li><li>painel de KPIs com total de changelogs, score documental, impacto alto e sequencia ativa;</li><li>graficos de ritmo documental por dia e distribuicao por tipo;</li><li>bloco de gamificacao com nivel, badges e proximas metas do colaborador;</li><li>formulario de novo changelog por markdown;</li><li>bloco de importacao de arquivo pronto;</li><li>lista compacta em DataTable dos changelogs do colaborador, com filtros por busca, tipo, modulo e data;</li><li>acoes de abrir feed interno, feed publico e central corporativa.</li></ul><h2>Botoes do topo</h2><ul><li><code>Feed interno</code>: abre a visao interna de changelogs;</li><li><code>Minha atividade</code>: abre a visao completa de atividade GitHub e gamificacao do colaborador;</li><li><code>Central corporativa</code>: abre a tela administrativa completa de changelogs;</li><li><code>Inserir modelo</code>: preenche um markdown base para acelerar o registro;</li><li><code>Salvar changelog</code>: persiste conteudo digitado;</li><li><code>Importar arquivos</code>: sobe markdown pronto para o fluxo autoral.</li></ul><h2>Listagem</h2><ul><li>a listagem principal usa DataTable para reduzir altura e evitar cards de linha inteira;</li><li>cada linha mostra data, titulo, resumo curto, tipo, impacto, visibilidade, modulo, autor, arquivos e acoes;</li><li>o botao de olho abre o detalhe completo em modal, preservando a leitura do markdown sem poluir a tabela;</li><li>o botao de lixeira aparece apenas quando o usuario pode gerenciar aquele registro.</li></ul><h2>Indicadores</h2><ul><li>os KPIs e graficos usam os dados carregados pela propria listagem da tela;</li><li>o seletor rapido de periodo aplica datas nos filtros e atualiza os graficos;</li><li>o bloco de gamificacao chama <code>/adm/api/GitHubMonitor/userActivitySummary</code>, reaproveitando a regra oficial de nivel, badges e plano de evolucao;</li><li>quando os graficos ApexCharts nao estiverem disponiveis, a tela mostra uma leitura simples em barras/listas.</li></ul><h2>Observacoes</h2><ul><li>a tela foi pensada para colaboradores internos e perfis dev;</li><li>o arquivo salvo entra em <code>docs/changelogs</code> e atualiza o <code>README.md</code> do diretorio;</li><li>emojis enviados no titulo ou no markdown sao removidos automaticamente antes de gravar em arquivo e no banco;</li><li>a exclusao preserva autoria e nao abre o mesmo grau de governanca da central corporativa;</li><li>super admins podem alternar para a visao geral, mas o painel de gamificacao continua focado no colaborador logado.</li></ul>"},"exp":1780849740}