Painel de Gestão de Projetos (integração Jira)

Implementação da Fase 1 (MVP) do PRD: integração real com o Jira, login individual com perfis (admin/gestor/analista), dashboard de % de conclusão por projeto e frente de trabalho, e painel pessoal do analista.

Infraestrutura já provisionada

• Supabase (projeto painel-jira-gestao, plano free): banco Postgres com RLS por perfil, autenticação, e duas Edge Functions:
  • save-jira-connection: valida e salva a conexão com o Jira (token criptografado no banco via pgcrypto, chave guardada no Supabase Vault — nunca em texto puro).
  • jira-sync: sincroniza Épicos → Frentes, Histórias (qualquer tipo padrão do 2º nível) → Projetos, Subtarefas → Atividades, além dos campos "Trimestre" e "Planejamento Inicial" (ids resolvidos pelo nome). Pode ser disparada manualmente (botão no admin) ou automaticamente via pg_cron a cada 5 minutos (respeitando o intervalo configurável por conexão). O resumo da última execução fica em jira_connections.last_sync_summary.
• A view project_completion calcula o % de conclusão de cada projeto no banco.

Abas

• Dashboard: visão geral (indicadores por status do Jira, frentes e projetos). O botão Exportar Excel (admin e gestor) baixa todos os projetos com nome, frente, planejamento inicial, responsável, descrição, status, % completo e trimestre (/api/export/projetos).
• Trimestre: um trimestre por vez (padrão: o atual) com entrega, planejados x adicionados, quebra por frente e lista de projetos filtrável.
• Analistas: uma linha por responsável (projetos por categoria de status do Jira, atrasados, parados, % e subtarefas abertas atribuídas). "Sem responsável" reúne o que não tem dono.
• Desenvolvimento Individual (só administradores e gestores): feedbacks e reuniões de desenvolvimento por analista, com alerta de cadência (mais de 30 dias sem reunião ou próxima reunião vencida) e "sinais dos projetos" do Jira para preparar a conversa. Os registros ficam em analyst_feedbacks e analyst_meetings, protegidos por RLS (is_manager()); analistas comuns não leem nada. O analista é identificado pelo nome que vem do Jira.
• Meu Painel: projetos e tarefas do próprio analista.

Regras da Visão geral

• Entregue = status com categoria "concluído" no Jira, exceto "Cancelado" (cancelados ficam fora de todos os percentuais e aparecem à parte).
• % do projeto = 100% se entregue; senão subtarefas concluídas ÷ total; sem subtarefas = 0%.
• % da frente = média dos % dos projetos ponderada pelo nº de subtarefas (mínimo 1).
• Atrasado = prazo vencido e não entregue. Parado = em andamento sem atualização há mais de 14 dias. Não iniciado = categoria "a fazer" no Jira.
• Planejado x entregue por trimestre: usa o campo Trimestre e o Planejamento Inicial ("Sim" = planejado; "Não" = adicionado ao longo do ano) das histórias. O trimestre não tem ano no Jira; assume-se o ano corrente.

Rodando localmente

Node.js não está instalado nesta máquina — instale a versão LTS (https://nodejs.org) antes de continuar.

npm install
npm run dev

Acesse http://localhost:3000.

Primeiro acesso (bootstrap)

1. Vá em Criar conta e cadastre-se com seu e-mail corporativo — o primeiro usuário cadastrado vira administrador automaticamente.
2. Confirme o e-mail se a confirmação estiver habilitada no projeto Supabase (padrão do Supabase).
3. Faça login e acesse Conexão Jira no menu (visível apenas para administradores).
4. Cole ali a URL do site, o e-mail da conta e o token de API do Jira — esses dados vão direto do navegador para a função segura no Supabase, nunca passam pelo chat ou por qualquer log.
5. Clique em Salvar conexão e depois em Sincronizar agora para popular o dashboard.

A partir daí, a sincronização automática roda a cada 5 minutos (respeitando o intervalo mínimo configurado, padrão 15 minutos).

Escopo do Jira

A sincronização traz só o projeto configurado em jira_connections.jira_project (hoje: "Canais Digitais e Processos", nome ou chave do projeto no Jira). Deixar a coluna vazia sincroniza todos os projetos. Ao trocar o projeto, apague os dados antigos (delete from work_fronts; — os projetos e atividades caem em cascata) e sincronize de novo.

Vínculo analista ↔ Jira

O e-mail de cadastro na plataforma precisa ser o mesmo cadastrado como responsável (assignee) no Jira — é assim que o sync liga cada Projeto/Atividade ao usuário correto.

O que fica para as próximas fases (conforme roadmap do PRD)

• Fase 2: matriz Analista × Frente × Projeto, alertas de projeto parado por e-mail/in-app, exportação CSV/PDF.
• Fase 3: histórico/tendência de conclusão, comentários internos, log de auditoria, visão trimestral planejado x executado.
• Login SSO (hoje: e-mail/senha via Supabase Auth).
• Filtro de período no dashboard (frente, analista e status já estão implementados).
• Limite de "projeto parado" hoje é fixo em 14 dias sem atividade concluída; tornar configurável pelo admin é um ajuste pequeno quando chegar a Fase 2.