... | @@ -26,219 +26,260 @@ Nesta seção serão abordados os requisitos para desenvolvimento do projeto, or |
... | @@ -26,219 +26,260 @@ Nesta seção serão abordados os requisitos para desenvolvimento do projeto, or |
|
- [Descrição](#descrição)
|
|
- [Descrição](#descrição)
|
|
- [Sumário](#sumário)
|
|
- [Sumário](#sumário)
|
|
- [User Stories](#user-stories)
|
|
- [User Stories](#user-stories)
|
|
- [**Epic 1: Cadastro e Gestão de Usuários e Organizações**](#epic-1-cadastro-e-gestão-de-usuários-e-organizações)
|
|
- [**Epic 1: Cadastro e Gestão de Usuários e Organizações (USs 1 a 8)**](#epic-1-cadastro-e-gestão-de-usuários-e-organizações-uss-1-a-8)
|
|
- [**Epic 2: Gestão e Coleta de Dados**](#epic-2-gestão-e-coleta-de-dados)
|
|
- [**Objetivo: Permitir que usuários se cadastrem, façam login e gerenciem equipes dentro da plataforma.**](#objetivo-permitir-que-usuários-se-cadastrem-façam-login-e-gerenciem-equipes-dentro-da-plataforma)
|
|
- [**Epic 3: Visualização e Relatórios**](#epic-3-visualização-e-relatórios)
|
|
- [**Epic 2: Gestão e Coleta de Dados (USs 10, 11, 15)**](#epic-2-gestão-e-coleta-de-dados-uss-10-11-15)
|
|
- [**Epic 4: Gestão do Sistema (administrador/Root)**](#epic-4-gestão-do-sistema-administradorroot)
|
|
- [**Objetivo: Permitir que usuários criem, enviem e respondam questionários.**](#objetivo-permitir-que-usuários-criem-enviem-e-respondam-questionários)
|
|
|
|
- [**Epic 3: Visualização e Relatórios (USs 9, 12, 13)**](#epic-3-visualização-e-relatórios-uss-9-12-13)
|
|
|
|
- [**Objetivo: Permitir que os usuários visualizem e analisem os dados coletados.**](#objetivo-permitir-que-os-usuários-visualizem-e-analisem-os-dados-coletados)
|
|
|
|
- [**Epic 4: Gestão do Sistema (Administrador)**](#epic-4-gestão-do-sistema-administrador)
|
|
|
|
- [**Objetivo: Gerenciar notificações e comunicação com usuários.**](#objetivo-gerenciar-notificações-e-comunicação-com-usuários)
|
|
|
|
|
|
|
|
|
|
## User Stories
|
|
## User Stories
|
|
|
|
|
|
### **Epic 1: Cadastro e Gestão de Usuários e Organizações**
|
|
### **Epic 1: Cadastro e Gestão de Usuários e Organizações (USs 1 a 8)**
|
|
|
|
### **Objetivo: Permitir que usuários se cadastrem, façam login e gerenciem equipes dentro da plataforma.**
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US01 - Como usuário, quero criar uma organização para poder gerenciar a comunicação interna do meu time</summary>
|
|
<summary>US01 - Como usuário, quero me cadastrar na plataforma para acessar a ferramenta.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar estrutura de banco de dados para armazenar organizações.
|
|
- [ ] Nome completo, e-mail, senha.
|
|
- [ ] Criar tela de cadastro de organização.
|
|
|
|
- [ ] Implementar autenticação e associação de usuários a organizações.
|
|
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O usuário consegue criar uma nova organização com nome e descrição.
|
|
✅ O usuário pode se cadastrar fornecendo nome completo, e-mail e senha.
|
|
- O sistema salva a organização no banco de dados.
|
|
✅ O sistema deve validar se o e-mail já está em uso e exibir um erro caso esteja.
|
|
- O usuário pode visualizar a organização criada em sua conta.
|
|
✅ O sistema deve exigir uma senha com pelo menos 8 caracteres, incluindo letras e números.
|
|
- Apenas usuários autenticados podem criar organizações.
|
|
✅ O cadastro bem-sucedido deve redirecionar o usuário para a tela de login.
|
|
|
|
✅ O usuário recebe um e-mail de confirmação após o cadastro.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US02 - Como usuário, quero cadastrar usuários na plataforma para que possam preencher os questionários</summary>
|
|
<summary>US02 - Como usuário, quero me cadastrar utilizando meu usuário Google na plataforma para acessar a ferramenta.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar estrutura no banco para usuários (admin, gerente, colaborador).
|
|
**Critérios de Aceitação:**
|
|
- [ ] Criar tela de cadastro de usuários.
|
|
|
|
- [ ] Implementar envio de convite por e-mail com link de acesso.
|
|
✅ O usuário pode optar por se cadastrar via conta Google.
|
|
- [ ] Implementar cadastro em lote via importação de CSV.
|
|
✅ O sistema deve solicitar permissão de acesso ao e-mail do usuário via OAuth.
|
|
|
|
✅ O sistema cria automaticamente uma conta para o usuário se ele ainda não tiver uma.
|
|
|
|
✅ O login bem-sucedido deve redirecionar para o dashboard.
|
|
|
|
|
|
|
|
</details>
|
|
|
|
|
|
|
|
<details>
|
|
|
|
<summary>US03 - Como usuário, quero poder fazer login na plataforma para utilizar a ferramenta.</summary>
|
|
|
|
<br>
|
|
|
|
|
|
|
|
- [ ] Login do usuário.
|
|
|
|
- [ ] Autenticação via OAuth/outro (Google, Microsoft, etc.).
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O usuário pode adicionar novos usuários manualmente ou via CSV.
|
|
✅ O usuário pode entrar no sistema com e-mail/senha ou via OAuth (Google, Microsoft etc.).
|
|
- Os usuários recebem um e-mail com convite para acessar a plataforma.
|
|
✅ O sistema exibe erro para credenciais inválidas.
|
|
- O sistema armazena corretamente os papéis dos usuários.
|
|
✅ Após login bem-sucedido, o usuário é redirecionado para o dashboard.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>Como usuário, quero poder fazer login na plataforma para acessar meus dados</summary>
|
|
<summary>US04 - Como usuário, quero cadastrar times na plataforma, para que ter um controle sobre os colaboradores que responderam o questionário.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Implementar autenticação via OAuth/outro (Google, Microsoft, etc.).
|
|
- [ ] Nome e descrição do time.
|
|
- [ ] Criar tela de login.
|
|
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O usuário pode entrar no sistema com credenciais ou via OAuth.
|
|
✅ O usuário pode criar um time informando nome e descrição.
|
|
- O sistema exibe erro para credenciais inválidas.
|
|
✅ O sistema deve validar se o nome do time já está em uso.
|
|
- O login bem-sucedido redireciona para o dashboard.
|
|
✅ O cadastro bem-sucedido exibe o time na lista de times do usuário.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
### **Epic 2: Gestão e Coleta de Dados**
|
|
<details>
|
|
|
|
<summary>US05 - Como usuário, quero visualizar meus times na plataforma, para ter um controle sobre os times que criei.</summary>
|
|
|
|
<br>
|
|
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
|
|
✅ O usuário pode visualizar a lista de times que criou.
|
|
|
|
✅ A lista de times exibe nome, descrição e número de membros.
|
|
|
|
|
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US04 - Como usuário, quero enviar questionários para minha equipe para coletar dados sobre a comunicação interna</summary>
|
|
<summary>US06 - Como usuário, quero editar um time que criei na plataforma para ter um controle sobre os times que criei.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar estrutura no banco para armazenar questionários e respostas.
|
|
- [ ] Editar nome do time.
|
|
- [ ] Criar tela para envio de questionários.
|
|
- [ ] Editar descrição do time.
|
|
- [ ] Gerar link único para cada questionário e permitir compartilhamento (via email).
|
|
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O usuário pode criar e enviar questionários.
|
|
✅ O usuário pode alterar o nome e a descrição do time.
|
|
- Cada questionário recebe um link único.
|
|
✅ O sistema deve validar se o novo nome do time já está em uso.
|
|
- Os respondentes conseguem acessar o questionário pelo link.
|
|
✅ O sistema exibe mensagem de sucesso após edição concluída.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US05 - Como colaborador, quero acessar o questionário pelo link e responder às perguntas para contribuir com o diagnóstico</summary>
|
|
<summary>US07 - Como usuário, quero excluir um time que criei na plataforma, para ter um controle sobre os times que criei.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar tela para preenchimento do questionário.
|
|
|
|
- [ ] Validar envio de respostas.
|
|
|
|
- [ ] Integrar envio de respostas com API externa do modelo em R.
|
|
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O respondente pode acessar o questionário e responder todas as perguntas.
|
|
✅ O usuário pode excluir um time criado por ele.
|
|
- O sistema armazena corretamente as respostas.
|
|
✅ O sistema solicita confirmação antes da exclusão.
|
|
- O envio de respostas é validado e não permite envios vazios.
|
|
✅ O time excluído não aparece mais na lista de times do usuário.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US06 - Como usuário, quero acompanhar o progresso das respostas para saber quem já respondeu</summary>
|
|
<summary>US08 - Como usuário, quero cadastrar colaboradores em um time, para que possam responder o questionário.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar estrutura no banco para armazenar status das respostas.
|
|
- [ ] Nome do membro.
|
|
- [ ] Criar tela de acompanhamento dos respondentes.
|
|
- [ ] Email do membro.
|
|
|
|
- [ ] Cargo do membro (campo opcional).
|
|
|
|
- [ ] Fazer upload de um arquivo CSV para cadastrar múltiplos membros automaticamente.
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O usuário consegue visualizar quem já respondeu.
|
|
✅ O usuário pode adicionar novos membros informando nome, e-mail e cargo (opcional).
|
|
- O progresso da pesquisa é atualizado em tempo real.
|
|
✅ O usuário pode importar um arquivo CSV para cadastrar múltiplos membros.
|
|
|
|
✅ Os membros cadastrados recebem um e-mail com convite para acessar a plataforma.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
### **Epic 3: Visualização e Relatórios**
|
|
|
|
|
|
|
|
|
|
### **Epic 2: Gestão e Coleta de Dados (USs 10, 11, 15)**
|
|
|
|
### **Objetivo: Permitir que usuários criem, enviem e respondam questionários.**
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US07 - Como usuário, quero visualizar um dashboard com estatísticas sobre a comunicação interna da minha equipe</summary>
|
|
<summary>US10 - Como usuário, quero cadastrar um formulário, para enviar aos colaboradores de um time e obter feedback.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar dashboard com métricas gerais (número de respostas, progresso, insights).
|
|
- [ ] Título do formulário.
|
|
- [ ] Criar integração com API externa para exibir gráficos e análises.
|
|
- [ ] Descrição do formulário.
|
|
|
|
- [ ] Time cadastrado previamente.
|
|
|
|
- [ ] Cadastrar múltiplas perguntas (texto e tipo).
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O usuário consegue visualizar métricas relevantes.
|
|
✅ O usuário pode criar um formulário informando título, descrição e perguntas.
|
|
- Os gráficos exibem dados corretamente.
|
|
✅ O formulário deve estar vinculado a um time previamente cadastrado.
|
|
- A interface é responsiva e de fácil entendimento.
|
|
✅ O sistema valida se há pelo menos uma pergunta antes de salvar o formulário.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US08 - Como usuário, quero exportar os relatórios dos questionários para análise detalhada</summary>
|
|
<summary>US11 - Como usuário, quero enviar questionários para um time, para coletar dados necessários para utilizar o modelo.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar funcionalidade para geração de relatório em PDF/CSV.
|
|
|
|
- [ ] Criar botão de exportação na interface.
|
|
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O usuário pode exportar os dados do questionário em formato PDF ou CSV.
|
|
✅ O usuário pode enviar um formulário para um time selecionado.
|
|
- Os relatórios gerados contêm todas as respostas e métricas necessárias.
|
|
✅ Os membros do time recebem uma notificação por e-mail sobre o formulário.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
### **Epic 4: Gestão do Sistema (administrador/Root)**
|
|
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US09 - Como administrador, quero gerenciar todas as organizações cadastradas para manter o controle do sistema</summary>
|
|
<summary>US15 - Como respondente, quero responder um formulário, para dar relatar ao meu gerente minhas relações comunicativas com outros membros do time.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar painel administrativo para listar todas as organizações.
|
|
- [ ] Retomar um formulário não finalizado.
|
|
- [ ] Permitir ativar/desativar organizações.
|
|
|
|
- [ ] Implementar filtros de busca e ordenação.
|
|
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O administrador pode visualizar e gerenciar todas as organizações cadastradas.
|
|
✅ O usuário pode responder um formulário e enviá-lo quando finalizado.
|
|
- Organizações podem ser ativadas/desativadas.
|
|
✅ O usuário pode retomar um formulário salvo como rascunho antes do envio.
|
|
|
|
✅ O sistema deve confirmar que todas as perguntas obrigatórias foram respondidas antes do envio.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
|
|
|
|
|
|
### **Epic 3: Visualização e Relatórios (USs 9, 12, 13)**
|
|
|
|
### **Objetivo: Permitir que os usuários visualizem e analisem os dados coletados.**
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US10 - Como administrador, quero gerenciar usuários do sistema para garantir segurança e organização</summary>
|
|
<summary>US09 - Como usuário, quero ver um dashboard com informações gerais sobre questionários e times, para ter uma visão mais ampla das informações.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar tela de gestão de usuários com papéis (administrador, usuário, Gerente, Colaborador).
|
|
- [ ] Formulário ativos.
|
|
- [ ] Implementar funcionalidade de reset de senha para usuárioes e usuários.
|
|
- [ ] Membros da equipe (todos os times).
|
|
- [ ] Permitir exclusão de usuários inativos.
|
|
- [ ] Taxa de resposta.
|
|
|
|
- [ ] Pontuação de engajamento.
|
|
|
|
- [ ] Grafo de conexões dos respondentes.
|
|
|
|
- [ ] Lista de formulários recentes.
|
|
|
|
- [ ] Tendências de engajamento da equipe.
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O administrador pode alterar papéis e excluir usuários.
|
|
✅ O usuário pode visualizar estatísticas em tempo real.
|
|
- O sistema permite reset de senha.
|
|
✅ O dashboard exibe gráficos sobre formulários ativos, taxa de resposta e engajamento.
|
|
|
|
✅ Os dados do dashboard devem ser atualizados periodicamente sem necessidade de recarregar a página.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US11 - Como administrador, quero monitorar logs de atividades para garantir a segurança e auditoria do sistema</summary>
|
|
<summary>US12 - Como usuário, quero visualizar formulários que criei e suas respostas, para ter um controle dos formulários enviados.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar estrutura no banco para armazenar logs de ações importantes.
|
|
- [ ] Filtros (todos, ativos, fechado).
|
|
- [ ] Criar tela para visualizar logs (quem fez login, quem enviou questionários, etc.).
|
|
- [ ] Rascunho.
|
|
|
|
- [ ] Pesquisa com filtro via palavras-chave.
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O administrador pode visualizar logs de ações críticas.
|
|
✅ O usuário pode visualizar a lista de formulários criados.
|
|
- Os logs armazenam corretamente os eventos do sistema.
|
|
✅ O usuário pode filtrar por formulários ativos, fechados e rascunhos.
|
|
|
|
✅ O sistema deve permitir a busca por palavras-chave nos formulários.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US12 - Como administrador, quero configurar permissões padrão para novos usuários e organizações</summary>
|
|
<summary>US13 - Como usuário, quero ver relatórios envolvendo todos os times, para obter feedback de engajamento</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar configuração de permissões personalizáveis para cada papel.
|
|
- [ ] Confirmar tipos de relatórios com o cliente.
|
|
- [ ] Implementar herança de permissões?? .
|
|
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- Novos usuários recebem permissões padrão configuráveis.
|
|
✅ O usuário pode visualizar relatórios consolidados sobre todos os times.
|
|
- O administrador pode personalizar as permissões de cada papel.
|
|
✅ Os relatórios exibem estatísticas sobre engajamento e participação nos formulários.
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
|
|
### **Epic 4: Gestão do Sistema (Administrador)**
|
|
|
|
### **Objetivo: Gerenciar notificações e comunicação com usuários.**
|
|
|
|
|
|
<details>
|
|
<details>
|
|
<summary>US13 - Como administrador, quero visualizar estatísticas de uso do sistema para entender seu crescimento</summary>
|
|
<summary>US14 - Como usuário, quero receber notificações, para ter informações sobre as pesquisas fora da plataforma.</summary>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
- [ ] Criar um dashboard geral com número de organizações ativas, usuários cadastrados, questionários enviados e taxa de resposta.
|
|
- [ ] Notificações por email.
|
|
- [ ] Implementar gráficos de crescimento e uso do sistema ao longo do tempo.
|
|
- [ ] Pesquisa criada.
|
|
|
|
- [ ] Pesquisa concluída.
|
|
|
|
- [ ] Nova resposta.
|
|
|
|
- [ ] E-mails de marketing.
|
|
|
|
- [ ] Escolher frequencia de notificações.
|
|
|
|
|
|
**Critérios de Aceitação:**
|
|
**Critérios de Aceitação:**
|
|
|
|
|
|
- O administrador pode visualizar estatísticas de uso em tempo real.
|
|
✅ O usuário pode receber notificações por e-mail sobre novas pesquisas e respostas.
|
|
- O dashboard exibe gráficos e métricas detalhadas.
|
|
✅ O usuário pode definir a frequência das notificações.
|
|
|
|
✅ O sistema permite desativar notificações opcionais (ex.: e-mails de marketing).
|
|
|
|
|
|
</details>
|
|
</details>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
---
|
|
[**Topo**](#requisitos-do-projeto) |
|
[**Topo**](#requisitos-do-projeto) |
|
|
|
\ No newline at end of file |