Ir para o conteúdo principal

Integração com o SGA (Serviços e unidades) para o atendimento presencial

Data de elaboração  23/02/22
Responsável pelo estudo


  1. Rafael Passos dos Santos (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. Lucas de Souza e Sousa (Estagiario)
  6. Euriane Nogueira (Product Owner)
Alvo Alpha
Origem

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. 
Documentação correlata
Observações O presente estudo pretende também levantar as Historias dos cars para a Sprint 


1. 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. 

2. Introdução

Atualmente existem serviços e unidades no SGA que precisam ser sincronizados com o Alpha.

Identificar as soluções, as histórias de usuários, débitos técnicos e quais possíveis impedimentos podem dificultar a integração com o SGA.

3. Desenvolvimento - Integração com o SGA (Serviços e unidades) para o atendimento presencial

3.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. São os departamentos cadastrados no Organograma. 

As unidades cadastradas no SGA são de estabelecimentos, ex: Tudo Aqui Porto Velho Centro, Tudo Aqui Porto Velho Shopping, O SGA deve ter as unidades cadastradas com o código do departamento do organograma.

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.

image-1645706132518.png

MACROS

Os serviços no SGA estão organizados por MACROS. O Macro é um serviço que define qual órgão atende determinado serviço.

Ex:

SEFIN (serviço macro)

  • Impressão do IPVA (serviço)
  • Pagamento de Tributos (serviço)

IICC (serviço macro)

  • Solicitação de RG (serviço)

TRIAGEM

As senhas são distribuídas por MACRO, conforme abaixo:

image-1646312523462.png


ATENDIMENTO

O atendimento chama uma senha.


image-1646314317780.png


image-1646314337540.png



3.2. SOLUÇÃO 1 - RETIRAR OS SERVIÇOS DO SGA E BUSCAR DO ALPHA

Alterar a estrutura do SGA para se adequar ao Alpha

Atualmente, a estrutura do SGA não é compatível com o organograma.

- Criar uma entidade local específica pra representar os locais de atendimento. (3 PONTOS)

- Remover o CRUD de serviços. (13 PONTOS)

- Alterar rota de distribuir senha para funcionar conforme o item 2.2 (13 PONTOS)

Distribuir senha

Parâmetros:

- Id do departamento

- Nome e documento do Cidadão

- Id e nome do serviço

- Id da Prioridade do atendimento

Triagem no Alpha

Objetivo: Gerar senhas locais 

- Listar os serviços presenciais por unidade

- Gerar senha para o cidadão, utilizando a funcionalidade de distribuir senhas (2.2).

Problemas

  • 2 sistemas
  • Atendimento no SGA
  • Integração com o SGA mais complexa
    • Seriam necessárias muitas alterações no SGA
    • Ao executar essa solução foi detectado que não seria possível executar a Triagem

3.3. SOLUÇÃO 2 - MANTER AS BASES DE SERVIÇOS DO ALPHA E DO SGA

- Obter as unidades do SGA (PVH Shopping, PVH Centro, Tudo Aqui Ariquemes, Tudo Aqui Rolim de Moura) para serviços presenciais, no alpha, atribuir a unidade ao serviço.

- Obter os serviços MACRO de cada unidade, pois as senhas são geradas por MACRO.

- Ao criar o serviço, criar no SGA informando as unidades.

- Ao editar o serviço, editar no SGA.

- Ajuste de prioridades na hora de distribuir a senha.

- Retirar a opção de excluir as unidades

Problemas

  • 2 sistemas
  • Atendimento no SGA
  • Dificuldade em sincronizar os serviços do alpha e do SGA

3.4. SOLUÇÃO 3 - Trazer as funcionalidades para o Alpha

  • Cadastros Gerais
    • Cadastro de locais de atendimento (ex: Tudo Aqui PVH, Tudo Aqui PVH Shopping, Tudo Aqui Ariquemes), pode ser direto na base.
    • Cadastro de Prioridades (normal online, normal presencial, prioridade online e prioridade presencial)
  • Geração de senha online
    • Estou aqui
    • Fila de atendimento (em tempo de execução)
    • Ao gerar a senha, é criado um atendimento relacionado ao agendamento.
  • Geração de senha local (TRIAGEM)
    • Cadastro de atendimentos
      • Informar Nome e Documento (opcional)
      • Prioridades
        • Prioridade ou não
    • Listar Fila de atendimentos
    • Rotina de geração de senha (necessário departamentoId)
    • Imprimir uma senha local
  • Painéis
    • Utilizar o painel do SGA consumindo a API do Alpha
      • Criar rota para o painel do SGA
  • Atendimento
    • Criar rota de "próxima senha" para o painel
    • Visualizar filas de senhas
    • Atender o próximo da fila (prioridade ou normal)
    • Selecionar o guichê que está atendendo
    • Encerrar Atendimento


3.5. HISTÓRIAS DE USUÁRIO

As Histórias de usuário e débitos técnicos abaixo são referentes a terceira solução apresentada.

História

Regras

Pontuação

Alpha Serviços
-
Criar locais de atendimento (modelagem e inclusão de dados na base)
5
Vincular departamentos com locais de atendimento Cada departamento só pode ter um local de atendimento 5
Mostrar o vinculo nos detalhes do departamento
3
Cadastro de Prioridades (normal online, normal presencial, prioridade online e prioridade presencial)

2
Portal do Cidadão
-
Geração de senha online (tela e modelagem) Quando for gerar a senha, criar um atendimento 8
Triagem
-
Criar Tela para Geração de senha local

- Escolher o local de atendimento

- Escolher o departamento

- Escolher o serviço

- Escolher se é prioridade ou não

- Obter a sigla do organograma

8
Débito técnico - Gerar senha

- Obter todas as senhas geradas para aquele departamento naquele dia

- Gerar senha sequencial, respeitando a última gerada

- Formatar senha com a sigla + número sequencial

- Atendimento com status "Aguardando atendimento"

8
Imprimir senha local - Montar o PDF para imprimir 3
Painéis

Criar Rota Para Painel de Atendimento

- Mostrar as senhas para todos os departamentos requeridos, (parâmetro: array de departamentosId)

- Para cada departamento:

  • Verificar se tem uma senha nova (status: senha chamando)
  • Retornar a senha e o guichê
  • Retornar um array das ultimas senhas chamadas para montar o histórico
8
Criar Rota para mostrar os departamentos de um determinado local de atendimento
5
Ajustar a aplicação de painel de atendimento para consumir rota do Alpha
13
Atendimento
-

Criar Perfil de Guichê de atendimento

- Criar Perfil no sauron

- Criar Menu

3

Escolher local de atendimento


5

Listar fila de senhas por departamento

- atualizar a tela a cada 30s

5
Selecionar o guichê que está atendendo
5
Criar funcionalidade "chamar próxima senha" - Selecionar se chamará prioridade ou normal 5
Criar funcionalidade "Em Atendimento"
3
Criar Funcionalidade "Não Atendido"
3
Criar Funcionalidade "Encerrar o atendimento"
5
Listar senhas não atendidas - atualizar a tela a cada 30s 5
Chamar novamente a senha que não foi atendida
5
Débito técnico - Criar uma rota para encerrar os atendimentos do dia anterior e configurar no caveira job
5

TOTAL 117

3.6. POSSÍVEIS IMPEDIMENTOS

Tempo: Prazo apertado 30/03/2022

Férias dos colaboradores: Alef, Rafael, Lucas Souza, Lucas Tavares

A equipe vingadores não possui expertise na tecnologia em que o SGA foi construído. Necessária ajuda de um membro de fora do time para realizar o ajuste no Painel do SGA.

4. Conclusão

Foi levantada a necessidade do atendimento de cidadãos pelo Alpha e que histórias serão necessárias para realizá-la. Foi escolhida a opção 3 por acreditarmos ser a opção mais viável a longo prazo, pois utilizaríamos o SGA somente para mostrar o painel e todas as outras funcionalidades estariam no Alpha.