Código fonte Wiki de CORE
Última modificação por andrehyeda em 30/07/2020
Show last authors
| 1 | Devido ao fato de que a suite de aplicações da Qualirede serem separadas em softwares especialistas, surgiu a necessidade de centralizar os cadastros e funcionalidades comuns a todas essas aplicações. Para suprir esse necessidade foi criado o sistema CORE, que tem como objetivo ser esse centralizador de informações entre todas as aplicações. |
| 2 | |
| 3 | O CORE é principalmente uma aplicação de CRUD (Create, Read, Update e Delete), ou seja, baseada nas operações de criação, consulta, atualização e inativação de dados. Todos os cadastros criados no CORE são disponibilizados para as demais aplicações através de serviço REST. A documentação dos serviços do CORE encontra-se no link [[http:~~/~~/coreps.qualirede.com.br/core-api/swagger/>>url:http://coreps.qualirede.com.br/core-api/swagger/]] . |
| 4 | |
| 5 | O CORE é divido em três módulos, sendo esses: Cadastro de Domínios; Cadastros Específicos; e Aplicação de Envio de Mensagens. |
| 6 | |
| 7 | == Cadastro de Domínios == |
| 8 | |
| 9 | |
| 10 | O cadastro de domínios fica localizado no menu Domínios no canto esquerdo da aplicação. É uma funcionalidade que permite criar qualquer cadastro básico de uma lista de dados que é automaticamente disponibilizado via serviço REST, bastando que os demais sistemas consultem essa informação. |
| 11 | |
| 12 | [[image:1596117428062-282.png||height="458" width="1909"]] |
| 13 | |
| 14 | |
| 15 | Para criar um novo domínio deve-se clicar no botão [[image:1596117609940-251.png||height="90" width="75"]] |
| 16 | |
| 17 | O sistema abrirá um formulário para cadastrar o nome do novo domínio. |
| 18 | |
| 19 | |
| 20 | [[image:1596118108760-754.png||height="316" width="1358"]] |
| 21 | |
| 22 | [[image:1596118362231-972.png||height="336" width="1358"]] |
| 23 | |
| 24 | Com o domínio cadastrado, o sistema permite as seguintes ações: |
| 25 | |
| 26 | [[image:1596118401323-204.png||height="48" width="46"]] **Editar** |
| 27 | |
| 28 | Que volta a tela de cadastro do domínio e permite alterar seu nome ou seu status (ativo ou inativo). |
| 29 | |
| 30 | [[image:1596118506198-274.png||height="46" width="42"]]**Lista de Domínios** |
| 31 | |
| 32 | Que abre a tela de cadastro dos itens que compõe este domínio. |
| 33 | |
| 34 | [[image:1596118824850-604.png||height="426" width="1356"]] |
| 35 | |
| 36 | Esta tela permite as ações: |
| 37 | |
| 38 | 1 - Pesquisar itens por valor do domínio, versão e status; |
| 39 | |
| 40 | 2 - Cadastrar novos itens na listagem do domínio. |
| 41 | |
| 42 | Ao clicar na opção 2, o sistema abra tela de cadastro de um item na listagem do domínio. O cadastramento consiste em um valor para o domínio, uma descrição para o domínio, dados para controle de versão e status. O campo Valor do Domínio precisa ser único na lista. |
| 43 | |
| 44 | [[image:1596119362103-227.png||height="380" width="1360"]] |
| 45 | |
| 46 | Exemplo de itens cadastrados na listagem de domínios: |
| 47 | |
| 48 | [[image:1596119581168-277.png||height="464" width="1358"]] |
| 49 | |
| 50 | Após o cadastro o sistema CORE disponibiliza automaticamente o novo domínio e seus itens em serviço REST. A estrutura da chamada é **{endereço do CORE de cada cliente}/core-api/rest/dominios/{Nome do domínio}/** . No exemplo utilizado a chamado do serviço REST fica da seguinte forma: |
| 51 | |
| 52 | [[image:1596120353999-355.png||height="1434" width="1334"]] |
| 53 | |
| 54 | == Cadastros Específicos == |
| 55 | |
| 56 | |
| 57 | São cadastros de informações que possuem particularidades que não permitem que se use o cadastro de domínios. Atualmente os cadastros específicos que existem no sistema são os seguintes: |
| 58 | |
| 59 | [[image:image-20200714105011-1.png||height="318" width="374"]] |
| 60 | |
| 61 | Um exemplo de cadastro específico é o de Localidades, no menu CEP. Conforme imagem a seguir, são cadastros customizados para atender a necessidades específicas da informação em questão que são mais complexas que a estrutura do cadastro de domínio. |
| 62 | |
| 63 | [[image:1596120867193-740.png||height="472" width="1352"]] |
| 64 | |
| 65 | Da mesma forma que os domínios, os cadastros específicos também são disponibilizados via serviço rest. No exemplo de Localidades, o serviço REST retorna da seguinte forma: |
| 66 | |
| 67 | [[image:1596121309499-902.png||height="1812" width="1410"]] |
| 68 | |
| 69 | (% class="wikigeneratedid" %) |
| 70 | == == |
| 71 | |
| 72 | == Aplicação de Envio Mensagens == |
| 73 | |
| 74 | |
| 75 | Além da parte de cadastros unificados, o sistema CORE centraliza as aplicações de envios de mensagens de e-mail e SMS. Desta forma, sempre que uma aplicação necessita enviar e-mails ou SMS, o CORE é chamado para fazer este processo. |
| 76 | |
| 77 | O CORE recebe as requisições de e-mails e SMS via serviço chamado pelos sistemas interessados e coloca estas em uma fila para que o mecanismo de envio seja realizado. |
| 78 | |
| 79 | **SMS** |
| 80 | |
| 81 | Chamada POST (/sms) |
| 82 | |
| 83 | [[image:1596122833202-118.png||height="490" width="1280"]] |
| 84 | |
| 85 | Resposta |
| 86 | |
| 87 | [[image:1596122579982-855.png||height="98" width="1278"]] |
| 88 | |
| 89 | **E-mail** |
| 90 | |
| 91 | Chamada PUT (/emails) |
| 92 | |
| 93 | [[image:1596122723720-331.png||height="442" width="1280"]] |
| 94 | |
| 95 | Resposta |
| 96 | |
| 97 | [[image:1596122761645-493.png||height="100" width="1280"]] |