{"v":{"area":"admin","slug":"tracy-logs","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/tracy-logs.md","relative_path":"docs/readme/admin/tracy-logs.md","title":"Tracy Logs","html":"<h1>Tracy Logs</h1><h2>Rota</h2><ul><li><code>/adm/tracy-logs</code></li></ul><h2>O que e</h2><p>Central tecnica do Tracy para leitura de issues agregadas, logs brutos, arquivos de apoio e correlacao com atividade de devs no GitHub.</p><h2>Para que serve</h2><ul><li>acompanhar issues abertas, resolvidas e ignoradas;</li><li>ler eventos brutos do banco e arquivos de forense em <code>/logs</code>;</li><li>sincronizar e fazer backfill da base de issues;</li><li>cruzar colaborador, repositorios mapeados, <code>target_path</code>, erros do Tracy e itens operacionais relacionados.</li></ul><h2>Blocos principais</h2><ul><li>hero e resumo consolidado da central;</li><li>painel de correlacao com devs e repos;</li><li>KPIs de issues e KPIs de leitura bruta em cards Matdash;</li><li>abas para issues agregadas e logs brutos em tabelas <code>tiix-table-shell</code>;</li><li>filtros em offcanvas para manter o miolo da tela limpo.</li></ul><h2>Correlacao com devs</h2><ul><li>o seletor de colaborador usa a base de usuarios do admin;</li><li>a correlacao consulta <code>/adm/api/GitHubMonitor/userActivitySummary</code>;</li><li>a janela define quais areas o colaborador tocou no GitHub;</li><li>os cards mostram <code>target_path</code>, top erros do Tracy, quantidade de ocorrencias e tarefas/tickets ligados por <code>changelog_relations</code>;</li><li>o botao <code>Abrir atividade GitHub</code> leva para a pagina detalhada do mesmo colaborador.</li></ul><h2>Botoes do topo</h2><ul><li><code>Filtros de issues</code>: abre o offcanvas da leitura agregada;</li><li><code>Filtros brutos</code>: abre o offcanvas de banco e forense;</li><li><code>Sincronizar issues</code>: reler logs e reabrir issues que voltaram;</li><li><code>Atualizar painel</code>: recarrega a aba atual.</li></ul><h2>Observacoes</h2><ul><li>a correlacao reaproveita a mesma regra do monitor GitHub, evitando duplicar o vinculo <code>repo -&gt; target_path -&gt; Tracy</code>;</li><li>a janela do colaborador filtra as areas tocadas no periodo, enquanto os totais do Tracy mostram o estado atual dessas areas;</li><li>tarefas e tickets dependem de vinculos existentes em <code>wpjy_changelog_relations</code>;</li><li>as tabelas principais usam DataTable server-side com idioma inline.</li></ul>"},"exp":1780849749}