{"v":{"area":"admin","slug":"workspace","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/workspace.md","relative_path":"docs/readme/admin/workspace.md","title":"Workspace","html":"<h1>Workspace</h1><h2>Rota</h2><ul><li><code>/adm/workspace</code></li></ul><h2>O que e</h2><p>Home operacional do colaborador no admin, com contexto pessoal, tarefas, tempo, sprint, checkpoints, performance e agora um bloco enxuto de incidentes nas areas em que ele atuou.</p><h2>Para que serve</h2><ul><li>concentrar o ponto de entrada diario do colaborador;</li><li>mostrar o que esta aberto, atrasado e em andamento no trabalho atual;</li><li>resumir tempo, sprint e checkpoints;</li><li>expor incidentes correlacionados com os repositorios e <code>target_path</code> tocados recentemente;</li><li>permitir triagem e resolucao de incidentes simples sem sair da home;</li><li>ligar esse contexto a tarefas, tickets e atividade GitHub sem mandar o usuario para telas de lideranca.</li></ul><h2>Blocos principais</h2><ul><li>hero do workspace com identidade e atalhos;</li><li>cards de KPIs pessoais;</li><li>bloco <code>Performance do dia</code>;</li><li>bloco <code>Incidentes nas minhas areas</code>;</li><li>contexto pessoal, tempo, alertas, tarefas, sprint e checkpoints.</li></ul><h2>Performance do dia</h2><ul><li>o widget faz <code>rebuild</code> diario no carregamento do <code>workspace</code> para evitar score estagnado;</li><li>continua lendo tarefas, comentarios, worklogs e checkpoints;</li><li>agora soma tambem sinais reais de desenvolvimento do proprio dia:</li><li>commits GitHub do colaborador;</li><li>repositorios e <code>target_path</code> tocados;</li><li>issues e ocorrencias do Tracy no escopo dessas areas;</li><li>quando a linha diaria ainda nao esta persistida, o card usa o resultado recem-calculado como fallback visual;</li><li>a leitura visual do card mostra <code>commits</code>, <code>areas</code> e <code>Tracy</code> junto dos fatos operacionais para o colaborador entender de onde veio o score.</li></ul><h2>Como melhorar a leitura do score no Workspace</h2><ul><li>abrir o Workspace cedo ajuda a disciplina do dia;</li><li>revisar tarefas vencidas e evitar deixar atraso aberto pesa mais do que adicionar atividade vazia;</li><li>checkpoint, worklog e conclusao no prazo ajudam a sustentar a nota;</li><li>meta parada e qualidade ruim seguram o score mesmo quando existe volume;</li><li>para devs, commits, repositorios tocados e sinais do Tracy ajudam a evitar leitura zerada quando existe trabalho tecnico real.</li></ul><h2>Incidentes nas minhas areas</h2><ul><li>usa a janela fixa de 30 dias;</li><li>consulta <code>/adm/api/GitHubMonitor/userActivitySummary</code> no contexto do proprio usuario;</li><li>mostra areas tocadas, issues abertas, ocorrencias e ultima ocorrencia;</li><li>lista os <code>target_path</code> mais recentes com top erros do Tracy;</li><li>puxa tarefas e tickets relacionados por <code>changelog_relations</code>;</li><li>oferece atalhos para <code>Minha atividade GitHub</code> e <code>Meu perfil</code>;</li><li>agora permite agir sem sair do <code>workspace</code>:</li><li>ver detalhes da issue do Tracy;</li><li>marcar como visto;</li><li>marcar <code>Estou corrigindo</code>;</li><li>abrir tarefa ja vinculada ao incidente;</li><li>abrir ticket ja vinculado ao incidente;</li><li>marcar a issue como resolvida no Tracy, com confirmacao.</li></ul><h2>Abrir tarefa a partir de incidente</h2><ul><li>o botao <code>Abrir tarefa</code> cria uma tarefa do tipo <code>bug</code> para o usuario logado;</li><li>a tarefa recebe titulo, descricao, prioridade e contexto gerados a partir da issue do Tracy;</li><li>se ja houver tarefa vinculada para o colaborador e issue, o workspace reutiliza o vinculo existente;</li><li>a resposta valida aceita o ID retornado pelo modulo de tarefas em <code>id</code> ou <code>data.id</code>;</li><li>apos a criacao, o card mostra o link <code>Tarefa #...</code> e o estado fica como <code>Corrigindo</code>.</li></ul><h2>Marcar resolvido</h2><ul><li>o botao <code>Marcar resolvido</code> aciona <code>/adm/api/TracyLogs/resolve</code>;</li><li>a tela pede confirmacao porque essa acao altera o status oficial da issue do Tracy;</li><li>ao confirmar, o badge visual do erro passa para <code>resolved</code>;</li><li>use essa acao quando a correcao ja foi aplicada ou quando a issue nao deve mais aparecer como aberta no Tracy.</li></ul><h2>Estado do colaborador no Tracy</h2><ul><li>o status oficial da issue continua no Tracy (<code>open</code>, <code>resolved</code>, <code>ignored</code>);</li><li>o <code>workspace</code> usa uma camada paralela de triagem por colaborador em <code>wpjy_tracy_issue_user_state</code>;</li><li>esse estado nao resolve nem ignora automaticamente a issue;</li><li>ele registra:</li><li>se o colaborador ja viu;</li><li>se assumiu a correcao;</li><li>qual tarefa ele abriu a partir da issue;</li><li>qual ticket ele abriu a partir da issue.</li><li>tarefas criadas a partir de issue do Tracy recebem <code>id_contrato</code> do contexto/usuario e usam o contrato padrao <code>57</code> quando nao houver contrato resolvido.</li><li>apenas a acao explicita <code>Marcar resolvido</code> altera o status oficial da issue.</li></ul><h2>Observacoes</h2><ul><li>o bloco foi pensado para colaborador, nao para triagem completa do Tracy;</li><li>a regra de correlacao continua centralizada no modulo GitHubMonitor;</li><li>na leitura pessoal, os repositorios realmente tocados pelo proprio colaborador nao ficam escondidos por ACL de equipe nessa etapa da correlacao;</li><li>se a conta GitHub ainda nao estiver conectada, a leitura pode ficar menos precisa ou vazia;</li><li>a tabela <code>wpjy_tracy_issue_user_state</code> pode ser criada automaticamente pelo modulo, mas a migration <code>sql/2026-04-17-tracy-issue-user-state.sql</code> foi adicionada para aplicacao controlada em ambiente.</li></ul>"},"exp":1780849755}