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:

Deve descrever os 3 espaços de interação;
Deve possuir um link destacado para o Ambiente de Gestão;
Deve possuir destaque para a Plataforma de Comunicação
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:

Deve conter informações mais detalhadas sobre o processo participativo
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:

Deve fornecer um campo editável em síntaxe Markdown;
O campo acima deve atualizar o texto da página "sobre";
Deve ser possível visualizar os resultados das modificações da página "sobre" antes de salvar;
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:

Deve fornecer um campo editável em síntaxe Markdown;
O campo acima deve atualizar o texto da página "perguntas frequentes";
Deve ser possível visualizar os resultados das modificações da página "perguntas frequentes" antes de salvar;
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:

Deve descrever os Termos de Uso da PVPA;
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:

O formulário para cadastro deve possuir o campo "Nome";
O campo "Nome" não pode ser menor que 5 caracteres;
O campo "Nome" não pode ser maior que 80 caracteres;
O campo "Nome" deve ser obrigatório;
O campo "Nome" deve conter apenas caracteres alfabéticos;
O formulário para cadastro deve possuir o campo "Apelido";
O campo "Apelido" não pode ser menor que 5 caracteres;
O campo "Apelido" não pode ser maior que 20 caracteres;
O campo "Apelido" deve ser obrigatório;
O campo "Apelido" deve ser único;
O campo "Apelido" deve conter apenas caracteres alfanuméricos;
O formulário para cadastro deve possuir o campo "E-mail";
O campo "E-mail" não pode ser menor que 5 caracteres;
O campo "E-mail" não pode ser maior que 50 caracteres;
O campo "E-mail" deve ser obrigatório;
O campo "E-mail" deve ser único;
O campo "E-mail" deve possuir máscara de e-mail (ex: [email protected] é válido, [email protected] não);
O formulário para cadastro deve possuir o campo "Senha";
O campo "Senha" não pode ser menor que 6 caracteres;
O campo "Senha" não pode ser maior que 30 caracteres;
O campo "Senha" deve ser obrigatório;
O conteúdo visível no campo "Senha" deve ser substituído por *;
O formulário para cadastro deve possuir o campo "Confirmar Senha";
O campo "Confirmar Senha" possui os critérios equivalentes ao campo "Senha";
O conteúdo do campo "Confirmar Senha" é considerado válido quando equivale ao conteúdo do campo "Senha";
O formulário para cadastro deve possuir o checkbox "Concordo com os Termos de Uso";
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";
O checkbox "Concordo com os Termos de Uso" é válido apenas se assinalado;
Em caso de cadastro válido, o acesso aos recursos restritos da PVPA deve ser concedido;
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:

O formulário para login deve possuir o campo "Apelido ou E-mail";
O campo "Apelido ou E-mail" não pode ser menor que 5 caracteres;
O campo "Apelido ou E-mail" não pode ser maior que 50 caracteres;
O campo "Apelido ou E-mail" deve ser obrigatório;
O formulário para login deve possuir o campo "Senha";
O campo "Senha" não pode ser menor que 6 caracteres;
O campo "Senha" não pode ser maior que 30 caracteres;
O campo "Senha" deve ser obrigatório;
O conteúdo visível no campo "Senha" deve ser substituído por *;
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:

Na página de Login deve existir um botão de integração com a rede social Google;
Na página de Login deve existir um botão de integração com a rede social Facebook;
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:

Deve visualizar a página de perfil com as informações pessoais, as conversas e canais que participo;
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:

Os campos são editáveis quando o usário pede para editar
Os campos estão salvando corretamente
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:

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:

A criação da conversa repercute com sucesso na tela de criação
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:

As conversas são exibidas
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:

O encerramento da conversa repercute com sucesso
A conversa é exibida como encerrada para os outros usuários
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:

O comentário é aceito e repercute positivamente na interface
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:

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:

Ao votar o próximo comentário é exibido
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:

Os canais são listados corretamente
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:

Como membro do CPA eu vejo os canais restritos
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:

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:

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:

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:

mensagem enviada com sucesso