Vingadores - Integração com o SGA (Serviços e unidades) para o atendimento presencial
OBJETIVO
Avaliar como será feita a integração dos serviços e unidades do Alpha com o SGA, quais serão as histórias para essa implementação, quais as mudanças necessárias e possíveis impedimentos.
JUSTIFICATIVA
Atualmente existem serviços e unidades no SGA que precisam ser sincronizados com o Alpha.
RESULTADOS DA PESQUISA
Identificar a Solução, as Histórias de Usuários, Débitos Técnicos e quais possíveis impedimentos podem dificultar a integração com o SGA.
ENVOLVIDOS:
Gustavo Felix Gomes (DEV Team)
Rafael Passos dos Santos (DEV Team)
Emanuel Rufino Alcantara de Lima (DEV Team)
Lucas de Souza e Sousa (DEV Team)
André Honório (DEV Team)
Euriane Nogueira Frota (Product Owner)
Edson Masami Hiraçaka (Scrum Master)
Lucas Tavares Viana de Souza (Estagiário Scrum Master)
1. CENÁRIO ATUAL
No Alpha, existe a funcionalidade agendamento, onde o cidadão irá selecionar um serviço e em qual unidade será atendido. Ao gerar a senha, é necessário identificar para qual unidade e serviço será gerada a senha.
UNIDADES
As unidades cadastradas no Alpha provém de uma integração com a API de Organograma.
As unidades cadastradas no SGA são de estabelecimentos, ex: Tudo Aqui Porto Velho Centro, Tudo Aqui Porto Velho Shopping,
SERVIÇOS
Os serviços do SGA são cadastrados manualmente.
RELACIONAMENTO
Tanto no SGA, quanto no Alpha, o relacionamento entre serviços e unidades é NxN, ou seja, cada serviço pode se relacionar com 0..N unidades e cada unidade pode ser relacionada com 0..N serviços.
FLUXO DE CADASTRO DE SERVIÇO NO ALPHA
DADOS BÁSICOS -> FORMA DE ATENDIMENTO -> ETAPAS
2. SOLUÇÃO
2.1 - ADICIONAR O SERVIÇO NO SGA
Novos campos da tabela serviço.
integracaoComOSGA do tipo boolean.
codigoDoServicoNoSGA do tipo integer.
2.1.1 - ADICIONAR FORMA DE ATENDIMENTO
Ao adicionar a forma de atendimento e houver atendimento presencial, será utilizada a rota de adição de serviço no SGA.
Parâmetros:
- Nome do serviço
- Descrição do serviço
- Ids das unidades do serviço
Retorno:
- O retorno deverá ser o código do serviço criado. Esse Id será salvado no campo codigoDoServicoNoSGA. Salvar o campo integracaoComOSGA como true.
EDITAR FORMA DE ATENDIMENTO
Ao editar a forma de atendimento, será verificado se o serviço possui integracaoComOSGA e se a formaDeAtendimento possui atendimento presencial.
3. HISTÓRIAS DE USUÁRIO
As Histórias de usuário e débitos técnicos abaixo são referentes a segunda solução apresentada.
|
História |
Pontuação |
|
Integrar os locais de atendimento do Alpha com os do SGA |
8 pontos |
|
Integrar os serviços do Alpha com os do SGA |
8 pontos |
|
Integrar os atendentes do Alpha com os do SGA |
8 pontos |
|
Gerenciar locais de atendimentos |
8 pontos |
|
Criar rotas para gerenciamento de locais de atendimentos |
8 pontos |
|
Gerenciar horários de atendimentos |
8 pontos |
|
Criar rotas para gerenciamento de horários de atendimentos |
8 pontos |
|
Mostrar tela de agendamento com locais de atendimento e horários para o agendamento do serviço |
5 pontos |
|
Criar rota para trazer os locais de atendimentos e horários para o agendamento do serviço |
5 pontos |
|
Gerar senha de atendimento no SGA e mostrar para o usuário |
13 pontos |
4. POSSÍVEIS IMPEDIMENTOS
Uma possível impedimento que pode ocorrer e uma das rotas da nova API não retornar um dos dados que precisamos em nossos sistemas impedindo uma utilização dessa API. Mas é pouco provável que isso aconteça.
CONCLUSÃO
Não será tão trabalhoso realizar essa alteração para a nova API do E-Estado mas também é possível realizarmos manutenção na API atual em C# evitando assim a realização das Histórias de Usuários acima.