| Data de elaboração | 23/10/2023 |
| André Honório de Andrade Silva (Tecnico), Alef Carvalho da Silva (Analista) | |
| Equipe do estudo | Gustavo Felix Gomes (Assessor), André Honório de Andrade Silva (Tecnico), Emanuel Rufino Alcantara de Lima (Analista), Alef Carvalho da Silva (Analista), Gezinéia Paula da Costa (Product Owner) |
| Alvos | Portal do Servidor, Alpha Serviços (web/api), Alpha Solicitações (web/api), Portal do Cidadão. |
| Origem | Implementação: Criação de funcionalidades para possibilitar agendamentos de serviços presenciais no Portal do Servidor |
| Objetivo | Realizar estudo técnico de alterações necessárias nos sistemas Portal do Servidor e Alpha (Serviços/Solicitações em suas partes web/api), para a devida implementação de funcionalidades que permitam o agendamento de atendimentos presenciais de serviços pelo Portal do Servidor. |
| Documentação correlata | |
| Observações | O presente estudo pretende também levantar as Historias dos cards para a Sprint |
¶ 1. Objetivo
Os objetivos deste estudo são:
- Analisar o código fonte do Alpha Solicitações Web;
- Analisar o código fonte do Alpha Solicitações API;
- Analisar o código fonte do Alpha Serviços Web;
- Analisar o código fonte do Alpha Serviços API;
- Fazer levantamento de alterações necessárias no Portal do Servidor;
- Fazer levantamento de alterações necessárias no Portal do Cidadão;
- Fazer levantamento do funcionamento do Agendamento;
¶ 2. Introdução
A crescente necessidade da evolução do Portal do Servidor para atender as diferentes realidades e cenários no ambito de possibilidades de atendimento de solicitações realizadas pelo servidor, levaram a urgência no levantamento de funcionalidades a serem implementadas e/ou modificadas nos sistemas pertinentes. O presente estudo discorre sobre o cenário atual, bem como o que deve ser realizado para que esta necessidade se torne realidade.
¶ 3. Desenvolvimento - Modificações Necessárias Para a Implementação do Agendamento de Serviços no Portal do Servidor
Para o desenvolvimento das funcionalidades que integram o agendamento de atendimento de serviços no Portal do Servidor, foram identificadas os seguintes passos:
¶ 3.1. Portal do Servidor
O Portal do Servidor já possui uma estrutura que possibilita a solicitação de atendimento online, logo faz-se necessário implementar as mesmas funcionalidades de agendamento que existem no Portal do Cidadão. Tendo como base este último, o Portal do Servidor deverá apresentar:
¶ 3.1.1. Exibir horários de atendimento de serviço
O Portal do Cidadão apresenta os horários juntamente com o endereço e a quantidade máxima diária.
¶ 3.1.2. Exibir opção de atendimento Online ou Presencial
Exbir as opções disponíveis de atendimento de determinado serviço, bem como no Portal do Cidadão.
¶ 3.1.3. Exibir dias disponíveis para agendamento
Para o Presencial exibir dias disponíveis para agendamento, levando em consideração o número limite de agendamentos diários, feriados e dias de excessão. O Portal do Cidadão também conta com esta funcionalidade.
¶
3.1.4. Detalhes do Agendamento
Ao confirmar agendamento, redirecionar para tela de detalhes do agendamento, esta deverá conter informações pertinentes ao agendamento, assim como ocorre no Portal do Cidadão.
¶ 3.1.5. Ação de Cancelar Agendamento
Na tela de detalhes de agendamento, exibir botão com a opção de cancelamento de agendamento.
¶ 3.1.6. Imprimir Comprovante
Ao lado do protocolo, exibir botão de imprimir comprovante, abrindo uma tela com a visualização de impressão.
¶ 3.1.7. Inserir menu e listar agendamentos
Na tela de Acompanhamentos, inserir menu de Agendamentos e listar agendamentos do Servidor.
¶ 3.2. Alpha Solicitações Web
O Alpha Solicitações Web também necessita de modificações para atender as funcionalidades de agendamento.
¶
3.2.1. Criar filtragem de agendamentos por Servidor ou Cidadão
Na listagem de agendamentos, criar um filtro para exibir apenas agendamentos advindos do Portal do Servidor ou Portal do Cidadão.
¶ 3.2.2. Criar tela de detalhes de agendamentos (opcional)
Caso seja necessário, exibir as informações do servidor solicitante do serviço: cargo, matrícula e lotação nos detalhes do agendamento. Caso contrário, estas informações deverão ser inseridas na listagem.
¶ 3.3. Alpha Solicitações API
Durante a análise do código fonte, foi identificado que para o atendimento às funcionalidades apresentadas, sertão necessárias algumas modificações no Alpha Solicitações API. Atualmente toda a parte de Agendamento é utilizada apenas para o Portal do Cidadão, logo será necessário realizar algumas adaptações em suas rotas existentes - o que pode variar de acordo com as necessidades apresentadas pelos clientes. Porém neste momento, o melhor caminho estimado é o de aproveitar o máximo do código fonte existente, para que possa atender estes cenários propostos:
¶
3.3.1. Modificar rota de Cadastrar Agendamento
Atualmente a rota de cadastrar agendamentos só comporta dados advindos do Portal do Cidadão, logo se faz necessário realizar modificações internas para que seja adequado ao novo fluxo de regras.
¶ 3.3.2. Criar ou modificar rota existente para obter agendamentos para o Servidor/Cidadão
Ao analisar as rotas existentes quanto a obtenção dos agendamentos do cidadão, foi identificado que será necessário modificá-las ou recriá-las separadamente (servidor/cidadão) para que tenham todas as regras e informações advindas de suas devidas integrações.
¶
3.3.3. Criar ou modificar rota existente para cancelar agendamentos para o Servidor/Cidadão
Serão necessárias algumas modificações nas regras e validações do cancelamento de agendamentos, para que haja mais segurança.
¶
3.3.4. Criar ou modificar rota existente para verificar permissão de acesso e ou modificação de agendamentos para o Servidor/Cidadão
Para maior segurança no acesso existem mecanismos para verificação de permissão de determinado usuário, este deverá ser adaptado para atender esta funcionalidade.
¶ 3.3.5. Modificar e utilizar rota para obter dias disponíveis para o agendamento do serviço
A API do Alpha Solicitações utiliza uma estratégia para se obter os dias disponíveis para agendamento para cada departamento. Serão necessários alguns ajustes para que este código valioso seja aproveitado.
¶ 3.3.6. Inserir campos Discriminator, Unidade Orçamentária e Matrícula para a tabela Agendamentos
A tabela Agendamentos na base de dados do Alpha Solicitações API necessita de campos adicionais para comportar os dados advindos do Portal do Servidor.
¶
3.3.7. Criar e rodar script para atualizar dados existentes de Agendamentos advindos do Portal do Cidadão
Os dados existentes do Portal do Cidadão deverão ser atualizados de acordo com os campos novos que serão criados na tabela de Agendamentos.
¶ 3.4. Portal do Cidadão
Como serão alteradas algumas rotas do Alpha Solicitações API, será necessário modificar o consumo de pelo menos uma rota:
¶ 3.4.1. Modificar consumo de rota de criação de agendamentos
Será necessário realizar modificações no consumo da rota de criação de agendamentos, adequando aos novos parametros necessários para identificar o sistema que está solicitando.
¶ 3.5. Alpha Carta de Serviços Web
Durante a análise, foi identificado que nenhuma alteração será necessária no Alpha Serviços Web;
¶ 3.6. Alpha Carta de Serviços API
Durante a análise - bem como no Alpha Serviços Web, foi identificado que nenhuma alteração será necessária no Alpha Serviços API
¶ 3.7. Histórias
De acordo com os pontos de modificações necessárias, foram estimadas e sugeridas as seguintes histórias:
| Sistema | História | Pontuação |
| Portal do Servidor | Na tela de detalhes do serviço, exibir horários de atendimento do departamento | 8 |
| Ao clicar em Solicitar, exibir opção de atendimento Online ou Presencial | 5 | |
| Ao clicar na opção Presencial, exibir dias disponíveis para agendamento | 5 | |
| Criar tela Detalhes do Agendamento | 8 | |
| Criar Ação de Cancelar Agendamento | 3 | |
| Criar botão Imprimir Comprovante de agendamento | 5 | |
| Na tela de acompanhamentos, inserir menu e lista de agendamentos | 5 | |
| Alpha Solicitações WEB | Criar filtragem de agendamentos por Servidor ou Cidadão | 5 |
| Criar tela de detalhes de agendamentos (opcional) | 5 | |
| Alpha Solicitações API | Modificar rota de criação de Agendamento, inserindo campos necessários para identificar o servidor ou o cidadão | 13 |
| Criar ou modificar rota existente para obter agendamentos para o Servidor/Cidadão | 8 | |
| Criar ou modificar rota existente para cancelar agendamentos para o Servidor/Cidadão | 3 | |
| Criar ou modificar rota existente para verificar permissão de acesso e ou modificação de agendamentos para o Servidor/Cidadão | 3 | |
| Modificar e utilizar rota para obter dias disponíveis para o agendamento do serviço | 3 | |
| Inserir campos Discriminator, Unidade Orçamentária e Matrícula para a tabela Agendamentos | 5 | |
| Criar e rodar script para atualizar dados existentes de Agendamentos advindos do Portal do Cidadão | 2 | |
| Portal do Cidadão | Modificar consumo de rota de criação de agendamentos, adequando aos novos parametros necessários para identificar o sistema que está solicitando | 2 |
¶ 3.8. Possíveis Impedimentos
O estudo atual é uma estimativa, os cenários e testes que serão apresentados pelos P.O.s - bem como os usuários, podem elevar a complexidade do desenvolvimento e necessitar de mais histórias para a conclusão do desenvolvimento.
¶ 4. Conclusão
Após o levantamento de modificações necessárias para a adequação dos sistemas para a inclusão da funcionalidade de agendamentos de serviços pelo Portal do Servidor, foi considerado o melhor caminho possível, no qual será possível reaproveitar o máximo das funcionalidades existentes, evitando a necessidade de se recriar outras funcionalidades que realizam a mesma operação nos dois portais.