Bug Reports

Sistema de reporte de bugs, sugestoes e melhorias integrado ao portal. Disponivel quando o modo beta esta ativo nas configuracoes do nucleo.

Widget Flutuante

  • Botao flutuante no canto inferior direito da tela com icone de bug
  • Visivel apenas quando o campo modoBeta esta ativo nas configuracoes do nucleo
  • Ao clicar, o sistema captura automaticamente um screenshot da tela via html2canvas e abre o formulario de reporte

Formulario de Reporte

CampoTipoDescricao
tipoenumbug, sugestao ou melhoria
prioridadeenumbaixa, media ou alta
descricaotextDescricao detalhada do problema ou sugestao
paginastring (auto)URL da pagina atual, preenchida automaticamente

Metadata Automatica

Alem dos campos do formulario, o sistema coleta automaticamente:

  • userAgent: Navegador e sistema operacional do usuario
  • resolucao: Resolucao da tela (largura x altura)
  • cargo: Cargo do usuario no nucleo
  • nucleoNome: Nome do nucleo atual
  • timestamp: Data e hora do reporte

Screenshot

A captura de tela e feita automaticamente ao abrir o formulario usando html2canvas. A imagem e armazenada como base64 junto ao reporte, permitindo que administradores vejam exatamente o estado da tela no momento do bug.

Endpoints

MetodoRotaAcessoDescricao
POST/api/bug-reportsQualquer membroCriar novo bug report
GET/api/bug-reportsADMINListar bug reports do nucleo
GET/api/bug-reports/allSUPER_ADMINListar bug reports de todos os nucleos
PATCH/api/bug-reports/:id/statusADMINAlterar status do bug report
DELETE/api/bug-reports/:idADMINRemover bug report

Kanban de Gestao

Na pagina de Configuracoes, os administradores tem acesso a um painel Kanban para gerenciar os bug reports:

  • 3 colunas: Planejando, Fazendo e Feito
  • Cards arrastáveis entre colunas para atualizar o status
  • Cada card e clicavel e exibe:
    • Tipo e prioridade do reporte
    • Descricao completa
    • Screenshot capturado
    • Metadata do usuario (navegador, resolucao, cargo, nucleo, timestamp)

Fluxo Completo

  1. Admin ativa modoBeta nas configuracoes do nucleo
  2. Widget de bug aparece para todos os membros do nucleo
  3. Membro clica no widget → screenshot automatico + formulario
  4. Membro preenche tipo, prioridade e descricao → envia
  5. Admin acessa Kanban nas configuracoes para ver e gerenciar os reports
  6. Admin arrasta cards entre Planejando → Fazendo → Feito