🎠 🏮 👩🏽‍🤝‍👨🏾 Organização da intranet (automação da produção de TI). Parte 1

Mais cedo ou mais tarde, qualquer empresa de TI (terceirização ou mercearia) deseja organizar seu próprio espaço onde você pode armazenar informações sobre projetos, funcionários e vendas. Manter correspondência de trabalho e discutir tarefas / estratégias / documentos. Na maioria das vezes, essas empresas começam a codificar tudo por conta própria ou viram algo para o Bitrix24 etc. Nesta série de artigos, falarei sobre nossos~~uma bicicleta~~- experiência em automação de processos. Como esperado, quase todos auto-hospedados, de código aberto e tentam fazer quase sem codificação.

Disclamer

Uma série de artigos descreve um exemplo da implementação de infraestrutura: o autor não deseja repetir e não finge estar "correto" nessas abordagens. Algumas partes do sistema descrito são usadas com êxito em várias organizações por 3 anos. O autor aceita de bom grado sugestões para melhorar o sistema ou sugerir soluções alternativas. Não crie discussões como "quem precisa disso" e "que muletas", quem não precisa, não lê e não interfere nos comentaristas

Portanto, o que uma empresa de terceirização média pode querer de um sistema semelhante:

Banco de dados de funcionários com distribuição de direitos de acesso à informação
GIT , , 1
Chat-Server (Messenger ) 1
, 1
/ HR
-
( )

– . - , - .

, " GIT ?", " ?" . .

, . , , LDAP . LDAP , , . 3 LDAP OpenLDAP , , , .

, RESTapi. , LDAP .

, OpenSource ERP/CRM (Odoo, Axellor ), OpenProject . , . - PHP, .

, EspoCRM. , " " , . , , CMS, .

.

, Espo :

HR
-
(CRM :))

PHP .

CRM. .
( , ).

-> -> User ().
. ( ) :

, Skype, Telegram, VK, Facebook . (, ), , , , , ( ).

, .
/ .

-> -> -> .

- :

, , . , .
, - " " .

EspoCRM, . , - , - .

, . .

— . , . , — email.

— self-hosted . , , . .. 1000 , web- RESTapi. , — .

, , espo.

, , Node-RED.

Node-RED

, , .
Node-RED , : , - . , , , , .

Node-RED . , , API ..

API Token.

"-" - " URL ".

, .

. Directory API, , , :

( )

- :

, . , .
https://oauth.yandex.ru/authorize?response_type=token&client_id=<ID>,

, , Node-RED.

http://localhost:1880, Flow 1
inject function
inject "Inject once after 0.1 seconds, then"
function

global.set('YaConnectToken', 'AgAAAA......');
return msg;

global.get() .

Inject , Flow 1. , . ,

Node-RED + .

Flow : inject, function, http request

inject, , , JSON

{
"userName":"testuser",
"firstName":"Test",
"lastName":"User",
"emailAddress":"testuser@mydomain.ru",
"dob":"1988-01-01",
"gender":"male",
"passwordConfirm":"12345678Eiru",
"isActive":true
}

function :

const TOKEN = global.get('YaConnectToken');
const user = msg.payload; //       
const body = {
'department_id': 1, // ID   .,    1
'is_admin': false, //    
'nickname': user.userName,
'name': {
'first': user.firstName,
'last': user.lastName
},
'birthday': user.dob, // 'YYYY-MM-DD',
'gender': user.gender, //'male/female/null'
'password': user.passwordConfirm,
'is_dismissed': user.isActive,
'position': user.title // 
}
return {
headers: {
'Authorization': 'OAuth ' + TOKEN,
//'X-Org-ID': 1234 //       .  : https://wilix.org/l/wlwrtj
},
payload: body
}

http request, POST, url https://api.directory.yandex.net/v6/users/
Deploy inject ( JSON inject function )
, http request , msg statusCode 200 201 payload:

! !

EspoCRM Node-RED

( CRM) Node-RED .
PHP, .
UserSaved.php EspoCRM custom/Espo/Custom/Hooks/User :

<?php
namespace Espo\Custom\Hooks\User;

use Espo\ORM\Entity;

class UserSaved extends \Espo\Core\Hooks\Base {
  public function afterSave(Entity $entity, array $options = []) {
    $entityValues = $entity->getValues();
    unset($entityValues['password']);
    $entityValues['isNew'] = $entity->isNew();
    $data = array(
      'event' => 'afterSave',
      'entity' => $entityValues,
    );
    $this->_callRed($data);
  }

  public function afterRemove(Entity $entity, array $options = []) {
    $entityValues = $entity->getValues();
    unset($entityValues['password']);
    $data = array(
      'event' => 'afterRemove',
      'entity' => $entityValues
    );
    $this->_callRed($data);
  }

  private function _callRed($data) {
    $data_string = json_encode($data);
    $ch = curl_init('__NODE_RED_ENDPOINT__');
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);
    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        'Content-Type: application/json',
        'Content-Length: ' . strlen($data_string))
    );
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
  }
}

Hook . ( ) , - // Espo, Node-RED. , Node-RED EspoCRM ( ) , localhost .
NODE_RED_ENDPOINT — .

Node-RED : http in, http response, debug
http in
UserSaved.php NODE_RED_ENDPOINT _NODE_RED/user-event
Deploy Node-RED
EspoCRM ->
EspoCRM, ""

, Node-RED ( ) JSON

{
id: "5e430b3c59783cb41"
name: "User Test"
deleted: false
isAdmin: false
userName: "usertest"
type: "regular"
password: "GVhrB......"
passwordConfirm: "oRM1..."
authMethod: null
salutationName: "Mr."
firstName: "User"
lastName: "Test"
isActive: true
isPortalUser: false
isSuperAdmin: false
title: "Frontend developer"
emailAddress: null
phoneNumber: null
sendAccessInfo: false
gender: "Male"
createdAt: "2020-02-11 20:14:52"
modifiedAt: "2020-02-11 20:14:52"
dob: null
inn: null
emailAddressIsOptedOut: null
phoneNumberIsOptedOut: null
emailAddressData: array[0]
phoneNumberData: array[0]
defaultTeamId: null
defaultTeamName: null
teamsIds: array[0]
teamsNames: object
teamsColumns: object
rolesIds: array[0]
rolesNames: object
portalsIds: array[0]
portalsNames: object
portalRolesIds: array[0]
portalRolesNames: object
createdById: "1"
isNew: true
}

isNew ,
passwordConfirm , .
, .

( 2 )

function 2

const user = msg.payload.entity;
if (msg.payload.event != 'afterSave') { //      ,   
return null
}

Deploy
Espo ( )
, Node-RED JSON
:)

Node-RED. , . Flow, . ( ).

EspoCRM , , , .

self-hosted GIT ( GitLab :))
self-hosted Slack
HR .
.

FAQ:
P: Por que o Node-RED é de todo, se a solicitação pode ser feita diretamente do PHP para o Yandex?
R: Tendo a integração no lado Node-RED, podemos alterar a configuração, adicionar novos serviços e ganchos às alterações do usuário, sem codificação adicional (sem contar as pequenas funções no Node-RED). O processo de implantação de atualizações se resume a um botão.

Organização da intranet (automação da produção de TI). Parte 1 - Usuários e Correio

Disclamer

.

Node-RED

Node-RED + .

EspoCRM Node-RED

More articles: