Portal do Cidadão - Cidadão realizar assinatura simples da solicitação de atendimento online
Data: 29/07/2022
Autores:
- Rafael Passos dos Santos (Assessor)
- Lucas de Souza e Souza (Assessor)
1. OBJETIVOObjetivo
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 apartira 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.
22. - INTRODUÇÃOIntroduçã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.
33. - DESENVOLVIMENTODesenvolvimento
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;
44. - CONCLUSÃOConclusã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.
55. - REFERÊNCIASReferências
https://govdoc-api.development.local/swagger/index.html
https://whimsical.com/fluxo-assinatura-NxKxdgS5tGX65WBJwi6ncq