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
modoBetaesta ativo nas configuracoes do nucleo - Ao clicar, o sistema captura automaticamente um screenshot da tela via
html2canvase abre o formulario de reporte
Formulario de Reporte
| Campo | Tipo | Descricao |
|---|---|---|
tipo | enum | bug, sugestao ou melhoria |
prioridade | enum | baixa, media ou alta |
descricao | text | Descricao detalhada do problema ou sugestao |
pagina | string (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
| Metodo | Rota | Acesso | Descricao |
|---|---|---|---|
| POST | /api/bug-reports | Qualquer membro | Criar novo bug report |
| GET | /api/bug-reports | ADMIN | Listar bug reports do nucleo |
| GET | /api/bug-reports/all | SUPER_ADMIN | Listar bug reports de todos os nucleos |
| PATCH | /api/bug-reports/:id/status | ADMIN | Alterar status do bug report |
| DELETE | /api/bug-reports/:id | ADMIN | Remover 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
- Admin ativa
modoBetanas configuracoes do nucleo - Widget de bug aparece para todos os membros do nucleo
- Membro clica no widget → screenshot automatico + formulario
- Membro preenche tipo, prioridade e descricao → envia
- Admin acessa Kanban nas configuracoes para ver e gerenciar os reports
- Admin arrasta cards entre Planejando → Fazendo → Feito