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"]] |