Pular para conteúdo

Épico Detalhado - Solicitação de Feedback

Solicitação de Feedback

User View

COMO um colaborador QUERO criar uma solicitação de feedback PARA receber feedback de avaliadores externos (clientes)

Business Narrative

Os colaboradores precisam de uma maneira de solicitar feedback de avaliadores externos (clientes), garantindo que o processo seja aprovado pelo PDM para manter a qualidade e relevância das avaliações.

Screen Flow

LISTA DE SOLICITAÇÕES (colaborador)

  1. O colaborador acessa a tela de listagem de solicitações de feedback, que além da lista, contém um botão para criação de um novo formulário.
  2. A lista contém todas as solicitações que o colaborador já criou com data de criação, status e botões de edição, exclusão e visualização.
  3. Se estiver no status “em criação” o formulário pode ser editado ou excluído.
  4. Se estiver no status “pendente aprovação” o formulário pode ser visualizado *** ou excluído.
  5. Se estiver no status “aguardando respostas” o formulário pode ser visualizado. ***
  6. Se estiver no status “finalizado” o formulário pode ser visualizado. ***

Nota: a função de visualização está contemplada no épico “Visualização de Feedback”

CRIAR NOVO FORMULÁRIO (colaborador)

  1. O colaborador clica no botão "Criar". O colaborador somente pode iniciar um novo formulário após 6 meses da finalização do último.
  2. O sistema exibe um formulário para criar a solicitação de feedback.
  3. O colaborador adiciona no mínimo três perguntas personalizadas.
  4. O colaborador adiciona no mínimo dois avaliadores, no máximo nove, inserindo nome/sobrenome e e-mail em uma lista.
  5. Se o e-mail do avaliador for CI&T o sistema não deve permitir adicionar, pois apenas avaliadores externos podem ser convidados.
  6. O colaborador clica no botão "Enviar para aprovação" se finalizou o preenchimento da solicitação e deseja enviar para aprovação do PDM.
  7. O colaborador é direcionado para a etapa “aprovação PDM”, onde poderá visualizar as perguntas e os avaliadores convidados.
  8. O colaborador clica no botão "Salvar rascunho" caso queira terminar o preenchimento da solicitação mais tarde.
  9. O sistema envia um email de notificação ao PDM.
  10. O status do formulário é atualizado para “pendente aprovação”.

LISTA DE SOLICITAÇÕES (PDM)

  1. O PDM acessa o sistema e visualiza a tela de listagem de feedbacks a aprovar.
  2. A lista contém todas as solicitações de colaboradores do PDM com login, papel, data de criação, status e botões de analisar formulário e visualização.
  3. Se estiver no status “não avaliado” o formulário pode ser analisado.
  4. Se estiver no status “aguardando resposta” não é possível realizar ações.
  5. Se estiver no status “finalizado” o formulário pode ser visualizado. ***
  6. A lista está dividida em 2 partes:
  7. Pendentes: solicitações aguardando resposta dos convidados e solicitações aguardando análise do PDM.
  8. Encerradas: solicitações encerradas

Nota: a função de visualização está contemplada no épico “Visualização de Feedback”

APROVAÇÃO DE FORMULÁRIO (PDM)

  1. O PDM clica no botão “Analisar formulário“.
  2. O PDM aprova ou rejeita a solicitação, selecionando a opção que deseja.
  3. Se a opção selecionada for “Não”, o campo comentário é exibido e o PDM preenche esse campo informando o motivo da rejeição.
  4. O PDM clica no botão “Finalizar análise”.
  5. Se aprovado, a solicitação não pode ser editada e um e-mail é enviado aos avaliadores.
  6. A partir da data da aprovação, os avaliadores têm 3 meses para responder o feedback.
  7. Se rejeitado, o formulário volta para o status anterior (em criação) e o colaborador pode editar as perguntas e os convidados para enviar novamente para aprovação.
  8. Se rejeitado, o colaborador recebe uma notificação por e-mail
  9. Se rejeitado, o PDM não visualiza mais o formulário até que seja enviado para aprovação novamente.
  10. O PDM é direcionado para a lista de solicitações.

EDIÇÃO DE FORMULÁRIO (colaborador)

  1. Ao clicar no botão “editar”, o colaborador é direcionado para a etapa de configuração do formulário.

EXCLUSÃO DE FORMULÁRIO (colaborador)

  1. Ao clicar no botão “excluir” uma mensagem de confirmação é exibida.
  2. Ao confirmar a exclusão uma notificação por e-mail é enviada para o PDM.
  3. A lista de formulários é atualizada.

Non-Functional Requirements

  • Ao salvar o formulário, o ID esse formulário precisa ser um hash.
  • Ao enviar para o avaliador o link do formulário precisar conter o hash.
  • A lista de solicitação deve ter comportamento de paginação.

Acceptance Criteria

  • O sistema deve permitir a criação de uma solicitação de feedback com no mínimo três perguntas personalizadas.
  • O sistema deve permitir a adição dinâmica de nome e email dos avaliadores.
  • O sistema deve enviar um email de notificação ao PDM ao salvar a solicitação.
  • O sistema deve permitir que o PDM aprove ou rejeite solicitações de feedback.
  • O sistema deve enviar um email aos avaliadores quando uma solicitação for aprovada.
  • O sistema deve permitir que o colaborador edite a solicitação se a mesma for rejeitada pelo PDM.
  • O sistema deve permitir que o colaborador exclua a solicitação se a mesma estiver nas etapas de criação ou aprovação.

Visão da Histórias

mmd

Solicitação de Feedback

  1. Listagem de solicitações de feedback

    • Desenvolver o endpoint para listar as solicitações de feedback de um colaborador.
    • Implementar a interface de usuário para exibir a lista com data de criação, status e botões de ação (editar, excluir, visualizar).
    • Aplicar lógica condicional para habilitar/desabilitar botões com base no status do formulário ("em criação", "pendente aprovação", "aguardando respostas", "finalizado").
    • Implementar a funcionalidade de paginação para a lista de solicitações.

  2. Layout da tela de criação de solicitação, incluindo barra de status

    • Projetar e implementar o layout da tela de criação do formulário de solicitação de feedback.
    • Incluir campos para perguntas personalizadas e avaliadores.
    • Desenvolver uma barra de status visual para indicar o progresso da solicitação.

  3. Adicionar Perguntas Personalizadas

    • Implementar a funcionalidade de adicionar dinamicamente no mínimo três perguntas personalizadas ao formulário.
    • Desenvolver o componente de UI para entrada de texto das perguntas.
    • Garantir a validação para o número mínimo de perguntas.

  4. Adicionar Avaliadores Dinamicamente

    • Implementar a funcionalidade de adicionar dinamicamente no mínimo dois e no máximo nove avaliadores (nome, sobrenome, e-mail).
    • Desenvolver o componente de UI para entrada dos dados do avaliador.
    • Adicionar validação para o domínio de e-mail (@ciandt.com.br não permitido).
    • Garantir a validação para o número mínimo e máximo de avaliadores.

  5. Salvar e Notificar PDM

    • Implementar a funcionalidade do botão "Enviar para aprovação" para persistir a solicitação no banco de dados.
    • Desenvolver o endpoint para criar/atualizar a solicitação de feedback.
    • Atualizar o status do formulário para "pendente aprovação".
    • Desenvolver e-mail de notificação para o PDM informando sobre a nova solicitação.
    • Implementar a funcionalidade do botão "Salvar rascunho" para persistir a solicitação com o status "em criação".
    • Garantir que o ID do formulário seja um hash ao salvar.
    • Implementar validação para o intervalo de criação de novos formulários (6 meses após a finalização do último).

Aprovação de Solicitação de Feedback

  1. Listagem de solicitações a aprovar

    • Desenvolver o endpoint para listar as solicitações de feedback pendentes de aprovação para um PDM.
    • Implementar a interface de usuário para exibir a lista com login, papel, data de criação, status e botões de ação (analisar formulário, visualizar).
    • Separar a lista em seções "Pendentes" (aguardando resposta ou análise PDM) e "Encerradas".
    • Aplicar lógica condicional para habilitar/desabilitar ações com base no status do formulário ("não avaliado", "aguardando resposta", "finalizado").

  2. Aprovar ou Rejeitar Solicitação

    • Desenvolver a interface para o PDM aprovar ou rejeitar a solicitação.
    • Implementar um campo de comentário condicional para rejeição.
    • Desenvolver o endpoint para processar a aprovação/rejeição da solicitação.
    • Atualizar o status da solicitação conforme a decisão do PDM (aprovado: "aguardando respostas", rejeitado: "em criação").
    • Implementar a lógica para ocultar o formulário rejeitado da visualização do PDM até que seja reenviado.
    • Desenvolver e-mail de notificação para o colaborador em caso de rejeição.

  3. Editar Solicitação Rejeitada

    • Implementar a navegação para a tela de edição quando o status do formulário for "em criação" após uma rejeição.
    • Carregar os dados do formulário rejeitado para edição.
    • Permitir que o colaborador modifique perguntas e avaliadores.

  4. Enviar Email aos Avaliadores

    • Implementar o serviço de envio de e-mails para os avaliadores quando a solicitação for aprovada.
    • Garantir que o link do formulário no e-mail contenha o hash do formulário.
    • Definir o prazo de 3 meses para os avaliadores responderem o feedback a partir da data de aprovação.