# Tracy Logs

## Rota

- `/adm/tracy-logs`

## O que e

Central tecnica do Tracy para leitura de issues agregadas, logs brutos, arquivos de apoio e agora tambem correlacao com atividade de devs no GitHub.

## Para que serve

- acompanhar issues abertas, resolvidas e ignoradas;
- ler eventos brutos do banco e arquivos de forense em `/logs`;
- sincronizar e fazer backfill da base de issues;
- cruzar colaborador, repositorios mapeados, `target_path`, erros do Tracy e itens operacionais relacionados.

## Blocos principais

- hero e resumo consolidado da central;
- painel de correlacao com devs e repos;
- KPIs de issues e KPIs de leitura bruta;
- abas para issues agregadas e logs brutos;
- filtros em offcanvas para manter o miolo da tela limpo.

## Correlacao com devs

- o seletor de colaborador usa a base de usuarios do admin;
- a correlacao consulta `/adm/api/GitHubMonitor/userActivitySummary`;
- a janela define quais areas o colaborador tocou no GitHub;
- os cards mostram `target_path`, top erros do Tracy, quantidade de ocorrencias e tarefas/tickets ligados por `changelog_relations`;
- o botao `Abrir atividade GitHub` leva para a pagina detalhada do mesmo colaborador.

## Botoes do topo

- `Filtros de issues`: abre o offcanvas da leitura agregada;
- `Filtros brutos`: abre o offcanvas de banco e forense;
- `Sincronizar issues`: reler logs e reabrir issues que voltaram;
- `Atualizar painel`: recarrega a aba atual.

## Observacoes

- a correlacao reaproveita a mesma regra do monitor GitHub, evitando duplicar o vinculo `repo -> target_path -> Tracy`;
- a janela do colaborador filtra as areas tocadas no periodo, enquanto os totais do Tracy mostram o estado atual dessas areas;
- tarefas e tickets dependem de vinculos existentes em `wpjy_changelog_relations`.