SeráBug?

Isso é um bug ou só mais uma ideia mal explicada?

SeráBug? é um sistema open-source para triagem de bugs, sugestões e surtos de usuários.
Criado para separar o que vale virar issue no GitHub do que pode ser ignorado com consciência limpa.

---

✨ Sobre

Desenvolvido pela Envolve, esse sistema surgiu da dor real de lidar com:

• Bug que não é bug
• Issue sem contexto
• GitHub lotado de ticket inútil
• QA tendo que adivinhar o que o usuário queria dizer

SeráBug? resolve isso com um fluxo claro, modular e sem burocracia.

---

🧩 O que ele faz

1. Usuário preenche um formulário simples quando achar um “problema”.
2. O sistema coleta automaticamente dados do ambiente (navegador, SO, tela, etc).
3. A submissão vai para um painel de QA onde pode ser analisada.
4. Só se for confirmada como real → o sistema cria uma Issue completa no GitHub com todos os detalhes.

---

📦 Stack Tecnológica

Camada	Tecnologia
Backend	VADEN (Dart) (docs aqui)
Frontend	Flutter (porque a putaria é toda Dart mesmo)
Integrações	Make.com (integra tudo sem precisar reinventar o Zapier)
Armazenamento	Google Sheets (fase 1), Firestore/Mongo (futuro)
Repositório	GitHub Issues com labels e templates
Notificações	Discord (opcional, mas divertido)

---

🚀 Como rodar o projeto (backend)

Pré-requisitos:

• Dart SDK >= 3.x
• VADEN CLI instalado (dart pub global activate vaden_cli)

# Clonar o projeto
git clone https://github.com/sua-org/seraBug.git
cd seraBug/api

# Rodar o servidor local
vaden dev

Servidor inicia por padrão em http://localhost:8080

---

📁 Estrutura do Projeto

seraBug/
├── api/                  # Backend VADEN
│   └── routes/
│       └── report_bug.dart
├── dashboard/            # Painel de triagem QA (feito em Flutter)
├── forms/                # Formulários simples e avançados
├── docs/                 # Arquitetura, fluxos, etc
├── scripts/              # Integrações com Make.com
├── .github/
│   └── ISSUE_TEMPLATE/   # Templates customizados
├── README.md
└── LICENSE

---

🧠 Como funciona o fluxo

1. Usuário abre um botão "Reportar Bug"
2. Um formulário simples é exibido
3. O Make.com recebe o input + dados técnicos via webhook
4. Tudo é salvo em uma aba de triagem
5. QA acessa um painel com esses reports
6. Se confirmar o bug → formulário completo é enviado
7. O Make.com cria a Issue real no GitHub com tudo formatado

---

🛣️ Roadmap

• Criar repositório público e arquitetura
• Definir stack e nome com cara de Gabriel
• Criar endpoint /report-bug no backend
• Integrar Google Forms e Sheets via Make
• Montar dashboard Flutter para o QA
• Criar template de issue automatizado
• Disparar para GitHub + Discord após aprovação
• Criar versão open SaaS (quem sabe...)

---

🤝 Contribuindo

Quer contribuir com o SeráBug?
Sinta-se livre pra abrir uma Issue, propor melhorias ou sugerir novos fluxos.
Só não mande bug falso, senão você vai conhecer o espírito do nome do projeto na prática.

---

📄 Licença

MIT License © 2025 Gabriel Aderaldo