Especificação de Requisitos Release 1 - ejplatform/ej-meta GitHub Wiki

Especificação de Requisitos para a Primeira Entrega

O presente documento descreve o mapeamento de requisitos para a primeira entrega do projeto Plataforma Virtual de Participação Adolescente (PVPA) de acordo com as técnicas e especificações definidas no Scaled Agile Framework.

Metas Estratégicas

Metas estratégicas são afirmações do contexto de negócio que devem ser satisfeitas nos produtos do projeto. Para o contexto da primeira entrega, as metas estratégicas são:

  • ME-1: Suportar as deliberações do CPA e a gestão do conhecimento e seu diálogo com SNDCA e CONANDA;
  • ME-2: Estimular e suportar a articulação do CPA com adolescentes engajados e interessados em pautas temáticas, aprofundando debates, constituindo comunidades permanentes e mais duradouras de diálogo;
  • ME-3: Estimular o protagonismo da maior quantidade e da maior diversidade de crianças e adolescentes que é possível com a preocupação clara de incluir as crianças e adolescentes sem perfil de engajamento político, já que os espaços institucionais geralmente só conseguem estimular a participação de quem já está engajado e atua em movimentos e entidades.

Épicas

Épicas são definições dos produtos identificados para desenvolvimento no projeto. Para o contexto da primeira entrega, as épicas são:

E-1: Plataforma de Participação Social

Para SNDCA
que realizam projetos de participação política para crianças e adolescentes
o produto Plataforma de Participação Social
é uma rede social de pesquisas de opinião
que estimula a comunicação entre diferentes perfis de opinião
onde satisfaz as MEs 2, 3

E-2: Plataforma de Comunicação

Para SNDCA
que realizam projetos de participação política para crianças e adolescentes
o produto Plataforma de Comunicação
é uma ferramenta de comunicação para grupos de trabalho
que facilita o trabalho colaborativo virtual e a deliberação de grupos
onde satisfaz as MEs 1, 2, 3

Funcionalidades

Funcionalidades são descrições de serviços contidos em uma épica que satisfazem determinadas necessidades de negócio. Para o contexto da primeira entrega, as funcionalidades são:

E1F-1: Gerenciamento de Páginas Estáticas

Funcionalidade da Plataforma de Participação Social
o Gerenciamento de Páginas Estáticas
é um serviço que permite visualizar e modificar as páginas estáticas da PVPA
com principal benefício de apresentar as informações de relevância da PVPA
que deve ser capaz de (1) apresentar páginas em endereços pré-determinados
(2) disponibilizar painel administrativo para modificação do conteúdo das páginas
(3) com a identidade visual definida para a PVPA

E1F-2: Gerenciamento de Contas

Funcionalidade da Plataforma de Participação Social
o Gerenciamento de Contas
é um serviço que permite o cadastro e acesso de funcionalidades restritas da PVPA
com principal benefício de restringir o uso de funcionalidades para diferentes perfis de usuário
que deve ser capaz de (1) disponibilizar gerenciamento de conta pessoal
(2) disponibilizar gerenciamento de contas em um painel administrativo
(3) com a identidade visual definida para a PVPA

E1F-3: Gerenciamento de Conversas

Funcionalidade da Plataforma de Participação Social
o Gerenciamento de Conversas
é um serviço que permite a criação, modificação e uso de painéis de conversas
com principal benefício de disponibilizar um ambiente de conversação política para crianças e adolescentes
que deve ser capaz de (1) permitir a criação de conversas tematizadas
(2) permitir a criação de comentários de conversas
(3) permitir a votação em comentários
(4) com a identidade visual definida para a PVPA

E2F-1: Canais de Comunicação

Funcionalidade da Plataforma de Comunicação
o Canais de Comunicação
é um serviço que permite a criação, modificação e uso de canais de comunicação
com principal benefício de disponibilizar um ambiente para colaboração virtual
que deve ser capaz de (1) associar canais de conversação para grupos e papéis
e (2) permitir o controle de arquivos do canal
e (3) com a identidade visual definida para a PVPA

Histórias de Usuário

Histórias de usuário são descrições atômicas de uma determinada funcionalidade esperada pelo usuário do sistema. Para o contexto da primeira entrega, as histórias de usuário são:

E1F1H-01: Visualizar Página Inicial

Utilizando o Gerenciamento de Páginas Estáticas
eu, como Visitante
desejo visualizar a página inicial
para compreender o processo de participação

Critérios de Aceitação:

  1. Deve descrever os 3 espaços de interação;
  2. Deve possuir um link destacado para o Ambiente de Gestão;
  3. Deve possuir destaque para a Plataforma de Comunicação
  4. Deve seguir a identidade visual definida para a PVPA.

E1F1H-02: Visualizar Página Sobre

Utilizando o Gerenciamento de Páginas Estáticas
eu, como Visitante
desejo visualizar a página "sobre"
para compreender mais sobre o projeto PVPA

Critérios de Aceitação:

  1. Deve conter informações mais detalhadas sobre o processo participativo
  2. Deve seguir a identidade visual definida para a PVPA.

E1F1H-03: Atualizar Página Sobre

Utilizando o Gerenciamento de Páginas Estáticas
eu, como Gestor CPA
desejo atualizar informações da página "sobre"
para adaptar o conteúdo textual para o contexto atual

Critérios de Aceitação:

  1. Deve fornecer um campo editável em síntaxe Markdown;
  2. O campo acima deve atualizar o texto da página "sobre";
  3. Deve ser possível visualizar os resultados das modificações da página "sobre" antes de salvar;
  4. Deve ser possível restaurar a versão anterior da página "sobre".

E1F1H-04: Manter Perguntas Frequentes

Utilizando o Gerenciamento de Páginas Estáticas
eu, como Gestor CPA
desejo gerir as "perguntas frequentes"
para definir respostas de perguntas úteis sobre a PVPA

Critérios de Aceitação:

  1. Deve fornecer um campo editável em síntaxe Markdown;
  2. O campo acima deve atualizar o texto da página "perguntas frequentes";
  3. Deve ser possível visualizar os resultados das modificações da página "perguntas frequentes" antes de salvar;
  4. Deve ser possível restaurar a versão anterior da página "perguntas frequentes".

E1F1H-05: Visualizar Página Termos de Uso

Utilizando o Gerenciamento de Páginas Estáticas
eu, como Visitante
desejo visualizar a página "termos de uso"
para avaliar quais as condições de uso da PVPA

Critérios de Aceitação:

  1. Deve descrever os Termos de Uso da PVPA;
  2. Deve seguir a identidade visual definida para a PVPA.

E1F2H-01: Cadastrar Conta com E-mail & Senha

Utilizando o Gerenciamento de Contas
eu, como Visitante
desejo me registrar na PVPA
para utilizar os recursos da plataforma

Critérios de Aceitação:

  1. O formulário para cadastro deve possuir o campo "Nome";
  2. O campo "Nome" não pode ser menor que 5 caracteres;
  3. O campo "Nome" não pode ser maior que 80 caracteres;
  4. O campo "Nome" deve ser obrigatório;
  5. O campo "Nome" deve conter apenas caracteres alfabéticos;
  6. O formulário para cadastro deve possuir o campo "Apelido";
  7. O campo "Apelido" não pode ser menor que 5 caracteres;
  8. O campo "Apelido" não pode ser maior que 20 caracteres;
  9. O campo "Apelido" deve ser obrigatório;
  10. O campo "Apelido" deve ser único;
  11. O campo "Apelido" deve conter apenas caracteres alfanuméricos;
  12. O formulário para cadastro deve possuir o campo "E-mail";
  13. O campo "E-mail" não pode ser menor que 5 caracteres;
  14. O campo "E-mail" não pode ser maior que 50 caracteres;
  15. O campo "E-mail" deve ser obrigatório;
  16. O campo "E-mail" deve ser único;
  17. O campo "E-mail" deve possuir máscara de e-mail (ex: [email protected] é válido, [email protected] não);
  18. O formulário para cadastro deve possuir o campo "Senha";
  19. O campo "Senha" não pode ser menor que 6 caracteres;
  20. O campo "Senha" não pode ser maior que 30 caracteres;
  21. O campo "Senha" deve ser obrigatório;
  22. O conteúdo visível no campo "Senha" deve ser substituído por *;
  23. O formulário para cadastro deve possuir o campo "Confirmar Senha";
  24. O campo "Confirmar Senha" possui os critérios equivalentes ao campo "Senha";
  25. O conteúdo do campo "Confirmar Senha" é considerado válido quando equivale ao conteúdo do campo "Senha";
  26. O formulário para cadastro deve possuir o checkbox "Concordo com os Termos de Uso";
  27. O conteúdo textual "Termos de Uso" do checkbox "Concordo com os Termos de Uso" deve ser um link que abre uma nova aba para a página "Termos de Uso";
  28. O checkbox "Concordo com os Termos de Uso" é válido apenas se assinalado;
  29. Em caso de cadastro válido, o acesso aos recursos restritos da PVPA deve ser concedido;
  30. Deve seguir a identidade visual definida para a PVPA.

E1F2H-02: Logar com E-mail & Senha

Utilizando o Gerenciamento de Contas
eu, como Visitante
desejo logar na PVPA
para utilizar os recursos da plataforma

Critérios de Aceitação:

  1. O formulário para login deve possuir o campo "Apelido ou E-mail";
  2. O campo "Apelido ou E-mail" não pode ser menor que 5 caracteres;
  3. O campo "Apelido ou E-mail" não pode ser maior que 50 caracteres;
  4. O campo "Apelido ou E-mail" deve ser obrigatório;
  5. O formulário para login deve possuir o campo "Senha";
  6. O campo "Senha" não pode ser menor que 6 caracteres;
  7. O campo "Senha" não pode ser maior que 30 caracteres;
  8. O campo "Senha" deve ser obrigatório;
  9. O conteúdo visível no campo "Senha" deve ser substituído por *;
  10. Deve seguir a identidade visual definida para a PVPA.

E1F2H-03: Cadastrar/Logar através de Redes Sociais

Utilizando o Gerenciamento de Contas
eu, como Visitante
desejo Acessar a PVPA com minha conta de rede social
para utilizar os recursos da plataforma

Critérios de Aceitação:

  1. Na página de Login deve existir um botão de integração com a rede social Google;
  2. Na página de Login deve existir um botão de integração com a rede social Facebook;
  3. Na página de Login deve existir um botão de integração com a rede social Twitter.

E1F2H-04: Visualizar Perfil

Utilizando o Gerenciamento de Contas
eu, como Usuário
desejo visualizar minhas informações pessoais e dados sobre minha participação
para que acessar com facilidade os canais e as conversas em que estou participando

Critérios de Aceitação:

  1. Deve visualizar a página de perfil com as informações pessoais, as conversas e canais que participo;
  2. Deve seguir a identidade visual definida para a PVPA.

E1F2H-05: Atualizar Perfil

Utilizando o Gerenciamento de Contas
eu, como Usuário
desejo editar minhas informações pessoais
para que possa criar minha persona pública e completar os dados de perfil

Critérios de Aceitação:

  1. Os campos são editáveis quando o usário pede para editar
  2. Os campos estão salvando corretamente
  3. A informação atualizada do campo é exibida na página de perfil

E1F2H-06: Deletar Perfil

Utilizando o Gerenciamento de Contas
eu, como Usuário
desejo deletar meu perfil
para que meu perfil não seja mais visível aos demais e eu não participe mais de canais e conversas

Critérios de Aceitação:

  1. Quando deletado meu usuário não aceita mais login

E1F3H-01: Criar Conversa

Utilizando o Gerenciamento de Conversas
eu, como membro do Grupo Gestor da Plataforma
desejo criar uma nova conversa
para que usuários em geral possam participar comentando e votando em comentários dentro do tema da conversa

Critérios de Aceitação:

  1. A criação da conversa repercute com sucesso na tela de criação
  2. A conversa é exibida para os usuários

E1F3H-02: Visualizar Conversas

Utilizando o Gerenciamento de Conversas
eu, como Usuário
desejo visualizar e conhecer quais são as conversas existentes (atuais e passadas)
para que decidir em qual conversa quero participar

Critérios de Aceitação:

  1. As conversas são exibidas
  2. As informações sobre a conversa são exibidas como comentários e votos

E1F3H-03: Encerrar Conversa

Utilizando o Gerenciamento de Conversas
eu, como membro do Grupo Gestor da Plataforma
desejo encerrar uma conversa existente
para que a conversa apareça com status de encerrada, dê destaque para os resultados e não possibilite mais novos comentários ou votos

Critérios de Aceitação:

  1. O encerramento da conversa repercute com sucesso
  2. A conversa é exibida como encerrada para os outros usuários
  3. Outros usuários não conseguem inserir comentários ou votos

E1F3H-04: Criar Comentário

Utilizando o Gerenciamento de Conversas
eu, como Usuário
desejo criar um novo comentário dentro de uma conversa qualquer
para que expressar um ponto de vista através de um comentário que poderá ser visto e votado pelos demais participantes, influenciando o debate

Critérios de Aceitação:

  1. O comentário é aceito e repercute positivamente na interface
  2. O comentário aparece para os outros usuários

E1F3H-05: Visualizar Comentários

Utilizando o Gerenciamento de Conversas
eu, como Usuário`
desejo visualizar os seus comentários dentro de uma conversa
para que possibilitar que os usuários possam conhecer e ler os seus comentários já criados dentro de uma conversa

Critérios de Aceitação:

  1. Ao listar os comentários o desempenho deles na conversa é exibido

E1F3H-06: Votar em Comentário

Utilizando o Gerenciamento de Conversas
eu, como qualquer usuário
desejo votar em um comentário dentro de uma conversa
para que opinar (concordo/ discordo/ indeciso) sobre os comentários e assim influenciar a votação geral

Critérios de Aceitação:

  1. Ao votar o próximo comentário é exibido
  2. O comentário votado não é exibido novamente

E2F1-H01: Visualizar Diretório

Utilizando a Plataforma de Comunicação
eu, como Gestor CPA
desejo visualizar página informativa sobre os canais existentes
para identificar canais de comunicação nos quais eu posso participar (membros do CPA podem participar de todos e público em geral apenas dos canais públicos)

Critérios de Aceitação:

  1. Os canais são listados corretamente
  2. Eu consigo entrar nos canais clicando neles

E2F1-H02: Utilizar Canais Restritos do CPA

Utilizando a Plataforma de Comunicação
eu, como Membro do CPA
desejo utilizar os canais restritos da CPA
para conversar com outros membros do CPA e conversar com representantes do CONANDA e SNDCA

Critérios de Aceitação:

  1. Como membro do CPA eu vejo os canais restritos
  2. Usuários comuns não tem acesso a ele

E2F1-H03: Gerenciar Canais do CPA

Utilizando a Plataforma de Comunicação
eu, como Membro do CPA
desejo gerenciar canais da CPA
para criar e disponibilizar ambientes de comunicação restritos aos membros do CPA ou abertos para o público em geral de acordo com os diferentes interesses do CPA

Critérios de Aceitação:

  1. Como membro do CPA eu consigo criar ou remover canais

E2F1-H04: Acessar HOME de canais

Utilizando o Plataforma de Comunicação
eu, como usuário não membro do CPA
desejo acessar os CANAIS de diálogo disponíveis
para que conhecer mais sobre a Plataforma de Comunicação e como participar desse ambiente

Critérios de Aceitação:

  1. Usuários comuns acessam a listagem dos canais públicos

E2F1-H05: Utilizar canais públicos criados pelo CPA

Utilizando o Plataforma de Comunicação
eu, como participante
desejo utilizar os canais públicos existentes
para que participe dos debates realizados dentro dos canais

Critérios de Aceitação:

    1. Usuários comuns conseguem clicar e participar dos canais

E2F1-H06: Publicar conteúdos nos canais

Utilizando o Plataforma de Comunicação
eu, como membro do cpa ou usuário
desejo publicar conteúdos nos canais que tenho permissão
para que eu possa participar do debate

Critérios de Aceitação:

  1. mensagem publicada com sucesso

E2F1-H07: Enviar mensagem direta a outros membros da Plataforma de Comunicação

Utilizando o Plataforma de Comunicação
eu, como membro da Plataforma (participante em algum dos canais)
desejo enviar uma mensagem privada e direta para outro membro da Plataforma de Comunicação
para que estabelecer contato direto com outros membros e tornar o diálogo mais rápido e fácil, ampliando as possibilidades de comunicação

Critérios de Aceitação:

  1. mensagem enviada com sucesso