Ir para o conteúdo principal

André - Cidadão realizar assinatura simples da solicitação de atendimento online no Portal do Cidadão


Data de elaboração 29/07/2022
Responsável pelo estudo
  1. Rafael Passos dos Santos (Assessor)
  2. Lucas de Souza e Souza (Assessor)
Equipe do estudo
  1. Gustavo Felix Gomes (Assessor)
  2. Rafael Passos dos Santos (Assessor)
  3. André Honório de Andrade Silva (Tecnico)
  4. Emanuel Rufino Alcantara de Lima (Analista)
  5. Euriane Nogueira
Alvo Portal do Cidadão
Origem

Implementação: Cidadão realizar assinatura simples da solicitação de atendimento online no Portal do Cidadão

Objetivo

Analisar a melhor abordagem para o Cidadão realizar assinatura simples da solicitação de atendimento online no projeto Portal do Cidadão conforme a User Story: “Eu como vingadores, preciso realizar um estudo para o cidadão realizar assinatura simples na solicitação de atendimento online" presente na Sprint número 102 do time Vingadores.

Existe um documento criado a partir do estudo da implementação da assinatura avançada, no qual este é baseado.

Documentação correlata

https://documentos.sistemas.ro.gov.br/books/spikes-estudos-tecnicos/page/cidadao-realizar-assinatura-avancada-da-solicitacao-de-atendimento-online-no-portal-do-cidadao

https://documentos.sistemas.ro.gov.br/books/spikes-estudos-tecnicos/page/portal-do-cidadao-cidadao-realizar-assinatura-da-solicitacao-de-atendimento-online

https://documentos.sistemas.ro.gov.br/books/assine-aqui/page/tutorial-integracao-da-assinatura-avancada-ao-seu-sistema

https://govdoc-api.development.local/swagger/index.html

https://whimsical.com/fluxo-assinatura-NxKxdgS5tGX65WBJwi6ncq

Observações O presente estudo pretende também pretende levantar as Historias dos cars para a Sprint 

1. Objetivo

Analisar a melhor abordagem para o Cidadão realizar assinatura simples da solicitação de atendimento online no projeto Portal do Cidadão conforme a User Story: “Eu como vingadores, preciso realizar um estudo para o cidadão realizar assinatura simples na solicitação de atendimento online" presente na Sprint número 102 do time Vingadores.

Existe um documento criado a partir do estudo da implementação da assinatura avançada, no qual este é baseado.

1.1 JUSTIFICATIVA

Tendo em vista que o Portal do Cidadão precisa integrar a assinatura simples do sistema assine aqui, não necessitando necessariamente de redirecionar o usuário para fora do Portal, foram estudadas as formas disponíveis para garantir uma correta integração e integridade dos sistemas envolvidos.

1.2 RESULTADOS ESPERADOS

Levantar casos de uso adequados para a realização da integração, mantendo a integridade e melhor experiencia para o usuário poder assinar suas solicitações de forma simplificada.

2. Introdução
 

O Portal do Cidadão implementará a assinatura digital do Gov.br, assim como a assinatura avançada do sistema Assine Aqui, e também a assinatura simples deste mesmo sistema. A forma idealizada será realizada dentro do Portal do Cidadão quando o mesmo solicitar um serviço.

3. Desenvolvimento

3.1 FUNCIONAMENTO

Para a devida integração e plena integridade de assinatura, o Assine Aqui API será utilizado para a assinatura simples das solicitações, em documentos gerados no sistema GOV.DOC, a partir de solicitações realizadas no Portal do Cidadão.

No sistema Alpha será definido para determinado serviço que este será assinado com a assinatura simples ou avançada. No ato de solicitar um serviço no Portal do Cidadão, um documento será criado no GOV.DOC com todas as informações necessárias da solicitação, então caso este serviço seja marcado como assinatura simples, a funcionalidade de assinatura simples será utilizada, o que fará com que o documento gerado seja assinado, garantindo assim a integridade das informações ali contidas.

Obs: Até o presente momento não houve confirmação por parte do time Tambakiss acerca da completude de implementação da funcionalidade que tornará possível a assinatura simples no Portal do Cidadão. Desta forma se faz necessária aguardar a confirmação antes de dar início à implementação.

3.2 IMPLEMENTAÇÃO

Como mencionado anteriormente, para realizar a integração com o assine aqui é necessário que a solicitação do Cidadão vire um documento, pois o assine aqui só assina documentos, diante disso só é possível realizar a assinatura depois que a Api de Solicitações estiver integrada com o Gov.doc, pois ele criará um documento da solicitação do cidadão, e poderá retornar as informações que o assine aqui precisa, sendo elas:

  • Id do documento que deseja assinar;
  • Nome do documento que deseja assinar;
  • String do corpo do documento que deseja assinar (HASH do documento)
 

Além disso, quando a solicitação for salva, ela precisa salvar essas informações de cima também na solicitação.

3.3 INTEGRAÇÃO COM O GOV.DOC

A integração com o Gov.doc foi documentada no estudo anterior, esta pode ser conferida neste trecho do estudo de assinatura avançada. Assim como na assinatura avançada, a assinatura simples deverá ser realizada no documento gerado a partir da solicitação.

3.4 ASSINATURA COM O ASSINE AQUI API

Diferentemente da forma mencionada anteriormente, que retira o usuário do portal, a assinatura simples poderá ser implementada mais facilmente, pois o próprio Portal do Cidadão consumirá nativamente a funcionalidade que estará presente no Assine Aqui API. 

Para tal, será necessário um alinhamento com o time Tambakiss, que está - no presente momento, desenvolvendo a assinatura simples para o Assine Aqui.

No Portal do Cidadão será necessária a criação de uma tela com o "resumo da solicitação" e uma opção para o mesmo assinar com o seu cpf e senha.

3.5 IMPLEMENTAÇÃO E HISTÓRIAS DE USUÁRIOS

Além da obrigatoriedade de todas as histórias de integração com o Gov.doc e o Assine Aqui, presentes no estudo anterior, foram levantadas as seguintes histórias para assinatura simples:

HISTÓRIA

PONTUAÇÃO

PRODUTO

REGRA

Gestor informar durante o cadastro se o serviço irá precisar da assinatura simples ou avançada

3

Alpha Serviços

- Ao selecionar que será serviço "online" então o gestor deverá informar se será assinatura simples ou avançada.

- Salvar

Refletir a informação se será assinatura avançada ou simples no Portal do Cidadão

3

Portal do Cidadão

Refletir no Portal do Cidadão

1 - Criação de resumo de solicitação com os dados criados no Gov.doc para o usuário verificar os dados antes de assinar

5

Portal do Cidadão 

- Obter da base de dados a solicitação e exibir o documento criado no Gov.doc.

2 - Criar formulário de assinatura simples com CPF e senha, para que este assine o documento criado no Gov.doc e movimente a solicitação.

5

Portal do Cidadão

- O formulário só será exibido ao usuário caso documento tenha sido devidamente criado no Gov.doc.

3 - Realizar a assinatura simples enviando o Id, Hash e nome do documento por parâmetro 3 Portal do Cidadão  - O campo nome do documento pode ser o Id do documento

4 - Cidadão visualizar assinatura simples

5

Portal do Cidadão

- Anonimizar CPF.

5 - Atendente  visualizar assinatura simples

5

Alpha Solicitações Web

- Anonimizar CPF.

TOTAL

29



3.6 POSSÍVEIS PROBLEMAS NA UTILIZAÇÃO

Além das preocupações levantadas anteriormente, a assinatura simples poderá sofrer com alguns problemas, sendo eles:

  • Disponibilidade e performance do sistema Gov.doc;
  • Disponibilidade e performance do sistema Assine Aqui;
4. Conclusão

A elaboração deste estudo possibilitou a investigação das necessidades do Portal do Cidadão para a utilização da assinatura simples nas solicitações de atendimento online. Tornando possível o levantamento das histórias de usuário necessárias para o desenvolvimento deste pacote de entregas. 

5. Referências

https://documentos.sistemas.ro.gov.br/books/spikes-estudos-tecnicos/page/portal-do-cidadao-cidadao-realizar-assinatura-da-solicitacao-de-atendimento-online

https://documentos.sistemas.ro.gov.br/books/assine-aqui/page/tutorial-integracao-da-assinatura-avancada-ao-seu-sistema

https://govdoc-api.development.local/swagger/index.html

https://whimsical.com/fluxo-assinatura-NxKxdgS5tGX65WBJwi6ncq