Roteiro de Testes para a 1a Entrega¶
Descrevemos as características e necessidades de teste para a 1a entrega referente ao projeto “Reformulação das Ferramentas Digitais de Participação - Fase 1”
Escopo¶
A prática participativa "Opine sobre projetos de lei" passa a usar a ferramenta digital “Painel de Interatividade”.
Características gerais¶
- Funcionamento via Portal
- Painel de comentários
- Cidadão logado pode comentar / curtir / descurtir / denunciar
- Cidadão deslogado só pode ver
- Painel é criado/aberto/encerrado conforme tramitação do projeto de lei via Sistema de Tramitação Legislativa (STL)
Links para as aplicações¶
- Interface do cidadão
- Portal com Painel de Interatividade
- Pesquisa: https://wwwd.almg.gov.br/apps/opiniao-projetos
- atualmente, direciona para o antigo "Opine". Será ajustado durante a semana para apontar para o novo Painel.
- temporariamente, caso desejem acessar o Painel migrado de algum projeto de lei, acessar o SGPD e identificar o id do painel (Menu "Painéis" > Pesquisar pela sigla do Opine desejado > Clicar e identificar o "id" do painel pela URL, ou acessar o link no título)
- Painel: https://wwwd.almg.gov.br/painel/13615
- Usar login e senha de usuário do Portal
- Pesquisa: https://wwwd.almg.gov.br/apps/opiniao-projetos
- Portal com Painel de Interatividade
- Interface do gestor (moderador, assessor e administrador)
- Sistema de Gestão da Participação Digital (SGPD)
- Sistema: https://sgpd-dev.almg.gov.br/
- Usar login e senha de rede/Intranet
- Sistema: https://sgpd-dev.almg.gov.br/
- Sistema de Gestão da Participação Digital (SGPD)
- Interface do gabinete (assessor parlamentar ou de comunicação)
- Sisap Web
- Sistema: https://sisapt.almg.gov.br/gabinete/ht-01/painel-interatividade
- Assessor01: usuário: mg12345 / senha: gti12345
- Assessor02: usuário: mg6789 / senha: gti12345
- Navegar pelo menu: Assessoramento -> Participação
- Sistema: https://sisapt.almg.gov.br/gabinete/ht-01/painel-interatividade
- Sisap Web
Acessos¶
- Para o Portal deve-se criar um usuário.
- Informar o e-mail da conta no Portal, pois cada um terá que ser habilitado pois por padrão não se envia e-mail no ambiente de teste.
- Para o SGPD deve-se associar algum perfil de acesso do sistema PD ao login do usuário na rede da ALMG.
- Deve-se cadastrar o acesso na Intranet e comunicar GGov para carregar o acesso no ambiente de teste.
- Para o Sisap Web usar os logins criados de assessoramento.
Objetivos dos testes¶
Os testes devem ser de uso e de conformidade.
- Verificar o controle de acesso
- Verificar a conformidade com requisitos definidos
- Verificar a usabilidade geral assim como entendimento das funcionalidades
- Verificar a necessidade de treinamento ou de recursos adicionais como wiki
- Definir necessidades de alteração
- Para o SGPD, tendo em vista a natureza da prática (moderação offline), faz sentido testar os acessos de moderador e administrador
Requisitos a serem testados¶
Os requisitos a seguir que estiverem riscados não foram implementados na 1a entrega.
Gerais¶
R03I Possuir estrutura de fórum (não tem chat).R04I Atores principais:
Ator | Site/Sistema | Descrição | Tarefas |
Cidadão logado | Portal da Assembleia | Cidadão que tem conta no Portal e se conectou via login. Quando redige um comentário no Painel vira Autor. |
login incluir/ (des)curtir / excluir / denunciar comentário recuperar painéis recuperar comentários responder comentários (apenas aqueles que não sejam respostas) receber e-mail notificando resposta a comentário do qual foi autor (exceto quando a resposta for feita pelo próprio autor) receber e-mail notificando aceite ou recusa de denúncia por ele realizada receber e-mail notificando ocultação de comentário de sua autoria devido a violações nos termos de uso do portal |
Cidadão deslogado | Portal da Assembleia | Cidadão que não tem conta no Portal ou não se conectou via login. | visualizar painéis visualizar comentários recuperar painéis recuperar comentários |
Gabinete | Sisap Web | Usuário que responde pelo gabinete/deputado(a) no Painel de Interatividade. Quando redige um comentário no Painel vira Autor. |
login incluir/ (des)curtir / excluir / denunciar comentário recuperar painéis recuperar comentários responder comentários (apenas aqueles que não sejam respostas) receber e-mail notificando resposta a comentário do qual foi autor ocultar notificação |
Moderador | SGPD | Usuário que dirige a discussão no Painel de Interatividade. Geralmente associado à GPI. | login recuperar infos pessoais visualizar painéis visualizar comentários recuperar painéis recuperar comentários responder comentários (apenas aqueles que não sejam respostas) alterar status do painel (confirmar se válido para Opine) emitir aviso (des)ocultar comentário aceitar/recusar denúncia ocultar aviso definir comentário como verificado |
Assessor | SGPD | Usuário da GCO/GCT com permissões limitadas à interação com a mesa (encaminhamento, marcação de comentário como lido, etc). | login recuperar infos pessoais visualizar painéis visualizar comentários recuperar painéis recuperar comentários marcar momento leitura comentário |
Administrador | SGPD | Usuário da GPI com permissões mais elevadas, como criação de painéis sem vínculos e suspensão de uso da ferramenta. | login recuperar infos pessoais visualizar painéis visualizar comentários recuperar painéis recuperar comentários suspender/liberar participante |
Portal da Assembleia¶
R01P O Painel de interatividade deve ser acoplável a reuniões de comissão, reuniões de plenário, Opine em projeto de lei (mas não substitui o Opine, apenas seu painel de comentários), eventos institucionais (SEA) e outros eventos sem vínculo com algum sistema .
R02P O Painel de interatividade pode receber comentários, curtidas de comentários e descurtidas de comentários, sempre por cidadãos logados no Portal.
R04P Resposta a comentário deve ser exibida aninhada e pode ser feita pelo próprio autor, por cidadão logado, por gabinete e por moderador.
R05P A ordenação dos comentários (nessa primeira entrega) será cronológica, e, dentro desses últimos, respondidos antes dos não respondidos .
R06P Qualquer cidadão logado pode denunciar comentários, citando razão, e isso deve disparar uma notificação identificada na ferramenta de gestão para análise pelo moderador.
R07P O comentário pode ser removido pelo autor (o comentário permanece na base, mas não é mais exibido no Painel - é substituído por uma mensagem).
R08P Comentários que respondem comentários ocultados ou removidos não são ocultados nem removidos.R09P Se o painel estiver com marcação de deputados habilitada, o cidadão pode marcar no comentário até X deputados (GCMD irá definir X), e isso gera uma notificação para o(s) gabinete(s) (todos os deputados ativos estarão na lista). Vide R14G.
R10P O Painel vai exibir a quantidade de comentários enviados e respondidos .R11P Deve ser possível acoplar o Painel a uma página do OpenCms, e por isso, deve existir no OpenCms um componente arrastável que faz referência ao Painel para, na renderização da página, embuti-lo.
R12P O cidadão deslogado pode apenas visualizar o Painel, sem interagir.R13P Deverá haver um diretório (índice geral) de Painéis de participação.R14P Quando um comentário responder comentário feito por gabinete, o deputado será marcado automaticamente (e portanto o gabinete será notificado).
R15P Avisos do moderador são exibidos em local destacado, fora da lista de comentários.
R16P Painel deve exibir status: aberto, ao vivo, fechado (status é alterado pelo moderador ou por critério automatizado baseado em eventos externos).
R17P Cidadão é notificado por e-mail e em tela quando um comentário seu for respondido ou citado (frequência de notificação por e-mail pode ser configurada)
Sisap Web¶
R01S Sisap Web deve mostrar os comentários que marcam o deputado e um link para a página que contém o Painel.
R02S Deve ser possível para o usuário de gabinete com acesso ao Painel de interatividade responder a comentários, em nome do gabinete.
R03S Deverá haver um diretório (índice geral) de Painéis de participação.
R04S Deve ser possível para o gabinete fazer um comentário (representando o gabinete/deputado).
Sistema de Gestão¶
R01G SGPD deve mostrar o Painel de interatividade dos eventos com essa característica.
R02G Cadastramento de usuários com papéis de assessor, moderador e administrador será feito via LDAP na Intranet.
R03G Deve ser possível para o moderador responder a comentários.R05G O assessor e o moderador devem poder marcar/desmarcar comentários que são perguntas e têm potencial de encaminhamento.
R06G O assessor e o moderador devem poder marcar/desmarcar comentários encaminhados.
R07G O assessor e o moderador devem poder marcar/desmarcar comentários como lidos durante a sessão, podendo indicar o momento específico da leitura para geração de link ancorado através da plataforma Youtube (específico para painéis que têm vídeo Youtube).
R08G O moderador deve ser notificado sobre comentários denunciados.
R09G O moderador pode ocultar/desocultar comentários.
R10G O moderador não pode reativar comentário removido pelo autor.R11G O administrador pode suspender o uso do painel por determinado cidadão, com envio de e-mail com texto genérico sugerido (e editável) e registro da ocorrência no sistema.
R12G O moderador pode enviar e ocultar avisos (mas isso fica em parte destacada do painel, fora da lista de comentários).
R13G Deverá haver um diretório (índice geral) de painéis de participação.
R14G O moderador pode mudar manualmente o status da sala. (confirmar se essa RN é válida para Opine)R15G A funcionalidade de marcação de deputados nos comentários pode ser habilitada/desabilitada pelo administrador.
R16G Comentários devem ser mostrados em ordem cronológica.R17G Deverá existir uma funcionalidade que permita filtrar os comentários de um Painel de Interatividade pela data de postagem.
R18G Deverá ser possível exportar os comentários de um Painel de Interatividade (filtrados ou não) para um arquivo .csv.
R19G Deverá existir uma flag no comentário que indica se esse comentário já foi verificado pelo moderador.
R20G Comentários postados em painéis de status “aberto” deverão ser criados com a flag “verificado pelo moderador” com valor “não verificado”.R21G Comentários postados em painéis de status “aberto ao vivo” deverão ser criados com a flag “verificado pelo moderador” com valor “verificado” (será armazenado registro de que a verificação foi feita pelo sistema).
R22G O moderador poderá alterar a flag “verificado pelo moderador” de um comentário de “não verificado” para “verificado” (será armazenado registro do moderador que fez a verificação).
Prazos¶
ETAPAS | Abril/24 | Maio/24 | Junho/24 |
Portal/SGPD | 16 a 22 : Testes Internos | 18 : Implantação | |
Sisap Web | 22 a 26 : Testes Internos | 10 : Reunião com Gabinetes (Mundo Oficial e Testes) 25 a 29 : Testes pelos Gabinetes |
A partir de 1o : Implantação |
Pontos de atenção¶
- Os dados são "limpos" toda 2a feira com dados de produção
- Se for necessário congelar a atualização, avisar com antecedência
- O envio de e-mail referente a conta no Portal está desabilitado por padrão
- Cada e-mail de conta de um participante dos testes terá que ser habilitado
Comunicando erro ou melhoria¶
- Agrupar os achados e sugestões e enviar por e-mail indicando prioridade ( bloqueador , essencial , melhoria ) de cada um para
- ALMG Ferramentas para Participação <ferramentas.participacao@almg.gov.br>
- GID ou GTI retornam aviso de implementação de acerto ou sugestão para retestar
- Se possível, retornar que deu certo ou errado
- Prioridade de implementação:
- Até a implantação serão implementados o que for considerado bloqueador
- O que for essencial será discutido e pode ou não ser implementado até a implantação
- O que for melhoria irá para fila (backlog) de pendências após implantação