Documentação: Sistema de Feedback do Projeto

[FernandoAlmeidaPinto]

Objetivo

Implementar uma solução mais eficiente e acessível para coletar feedbacks de todas as pessoas que utilizam o projeto.

---

Situação Atual

Atualmente, existe uma categoria no Menu de Admin chamada Reportar Erro, que redireciona o usuário para uma planilha no Google Docs. Essa abordagem apresenta as seguintes limitações:

• Pouca praticidade para o usuário.
• Canal de comunicação pouco eficiente e limitado.
• Dificuldade em organizar e priorizar os feedbacks recebidos.

---

Solução Proposta

Adição de um Ícone de Report no Header

Será adicionado um ícone para reportar problemas no canto superior direito, junto ao header da aplicação. O ícone utilizado será:
.

Funcionalidade do Ícone

Ao clicar no ícone, será exibido um menu com as seguintes opções de feedback:

1. Abrir Discussão sobre Problemas
   O usuário poderá descrever problemas encontrados na aplicação.

2. Abrir Discussão sobre Ideias
   O usuário poderá sugerir melhorias ou novas funcionalidades.

3. Relatar um Bug
   O usuário poderá relatar um erro específico, com detalhes técnicos ou contextuais.

---

Benefícios Esperados

• Melhoria na Experiência do Usuário: Um sistema mais intuitivo e direto para reportar feedbacks.
• Aumento na Participação: Facilita a comunicação com todos os usuários, incentivando a contribuição.
• Organização e Priorização: Permite categorizar e gerenciar melhor os feedbacks recebidos.

---

Próximos Passos

1. Desenvolver o Componente de Feedback
   Implementar o ícone e o menu de opções no header da aplicação.

2. Criar as Integrações Necessárias
   Conectar as opções de feedback a um sistema de gerenciamento (e.g., ferramenta de issues ou fórum interno).

3. Testar e Refinar
   Validar a usabilidade do novo sistema de feedback com um grupo de usuários antes de disponibilizá-lo para todos.

4. Divulgar o Novo Sistema
   Comunicar aos usuários sobre a nova funcionalidade e incentivar o uso.

---

Conclusão

Com essa mudança, o canal de comunicação do projeto será significativamente aprimorado, proporcionando uma experiência melhor para os usuários e facilitando a gestão de feedbacks pela equipe.

[rBressanS]

@FernandoAlmeidaPinto De início eu faria a implementação usando apenas um google forms, ou alguma coisa similar, acho que isso resolveria uma boa parte do problema, com menos complexidade e necessidade de tempo.
E caso fosse constatado na prática que é necessário uma solução mais robusta, poderiamos voltar no assunto, o que acha?

[FernandoAlmeidaPinto]

@rBressanS O seu "de início" foi o nosso "de início" do passado. Só que a gente usou o Google Docs.
Agora, não queremos mais usar ferramentas externas para identificar bugs ou possíveis problemas. Nosso objetivo com essa discussão era propor uma forma de centralizar tudo no GitHub.

Acho que a ideia proposta acima segue algumas regras que definimos como importantes:

• A opção de reportar bugs ou sugerir ideias deve estar visível para o usuário em qualquer lugar da plataforma.
• Nunca deve ficar oculta a ponto de o usuário precisar rolar a tela para encontrá-la.
• Ao clicar, o usuário deve ser direcionado diretamente para o GitHub.
• Como nem todo usuário é desenvolvedor, ele não pode precisar navegar no GitHub; ou seja, o clique deve levá-lo exatamente para onde precisa.
• Queremos distinguir claramente o que é um possível problema (bug) ou uma sugestão de nova funcionalidade.