Sothis/snglpi
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Rotina de sincronismo de chamados entre ServiceNow e GLPI
70 Commits 3 Branches 4 Tags 514 KiB
JavaScript 87.2%
PLpgSQL 8.8%
Python 4%
cc17d957c7
Go to file
Rafael Lopes cc17d957c7 PERF: Reduz verbosidade de logs em nivel info no ciclo do cron 
Rebaixa para debug uma serie de logs "heartbeat" que disparavam todo ciclo
(a cada 1 minuto) independente de qualquer mudanca real, competindo com os
logs de acao/erro que realmente importam: buscas por watermark, contagem
de tickets pendentes/monitorados, checagens de comentario ja sincronizado,
abertura de conexao GLPI/PostgreSQL, e o resumo de sincronizacao do SN
(que a margem de seguranca de 6h do watermark sempre retorna nao-vazio,
mesmo sem mudanca real de campo).

Corrige tambem um bug real encontrado em teste: no fluxo GLPI -> SN, todo
comentario historico de um ticket era sanitizado e checado contra a API do
SN a cada ciclo antes mesmo de verificar se ja tinha sido sincronizado
(ticket_updates.destiny_id). Em tickets com historico longo isso
significava dezenas de chamadas desnecessarias por minuto. Agora a
checagem local (barata) roda primeiro, e so sanitiza/consulta o SN quando
o comentario realmente ainda nao foi sincronizado.

Corrige tambem o log de configuracao do pool PostgreSQL, que imprimia
"[object Object]" por passar o objeto de config como mensagem em vez de
metadado.

LOG_LEVEL default muda de debug para info em .env.example e
.env.production, unica forma do rebaixamento acima ter efeito pratico.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-10 16:00:29 -03:00
.gitea/workflows FEAT: Motor de regras único de status/fechamento + mandante configurável 2026-07-10 09:45:34 -03:00
config FIX: Correções de sincronização SN<->GLPI 2026-02-24 17:42:33 -03:00
docs FEAT: Motor de regras único de status/fechamento + mandante configurável 2026-07-10 09:45:34 -03:00
src PERF: Reduz verbosidade de logs em nivel info no ciclo do cron 2026-07-10 16:00:29 -03:00
.env.example PERF: Reduz verbosidade de logs em nivel info no ciclo do cron 2026-07-10 16:00:29 -03:00
.gitignore FEATURE: Chamados reabertos possuem uma nova coloração 2026-03-04 18:15:53 -03:00
cron.js REFACTOR/BUG: Correção de bugs e alteção de run 2025-11-19 16:01:37 -03:00
ecosystem.config.js REFACTOR/BUG: Correção de bugs e alteção de run 2025-11-19 16:01:37 -03:00
package-lock.json CHORE: Unificando versoes 2026-02-19 11:05:52 -03:00
package.json REFACTOR/BUG: Correção de bugs e alteção de run 2025-11-19 16:01:37 -03:00
README.md FEAT: Motor de regras único de status/fechamento + mandante configurável 2026-07-10 09:45:34 -03:00

README.md

Sistema de Integracao ServiceNow <-> GLPI

Middleware Node.js para integrar chamados entre ServiceNow e GLPI, usando PostgreSQL como banco intermediario e acesso ao banco do GLPI.

Estado atual

  1. Coleta de tickets SN por watermark.
  2. Criacao/vinculo de tickets no GLPI (grava external_id no GLPI com o numero do ticket SN).
  3. Sincronizacao de comentarios e tasks em duas direcoes.
  4. Preenchimento do campo "Ticket Externo" no SN com o ID GLPI.
  5. Motor de regras unico (processTicketLifecycleController) para status/fechamento/reabertura: status=5 (resolver SN), status=6 (encerrar definitivamente no SN), nota no GLPI quando o SN resolve/encerra por conta propria (com aviso e troca de fila no SN), reabertura automatica e regra de fora de escopo.

Fluxo do ciclo

Executado pelo main():

  1. processErrorController
  2. processTicketsController
  3. processTicketLifecycleController (quando ENABLE_GLPI_CLOSE_CRON=true)
  4. processCommentsController

Documentacao detalhada

  1. Fluxo tecnico: docs/fluxo.md
  2. Regras de negocio completas: docs/regrasdenegocio.md
  3. Casos de uso: docs/casosdeuso.md
  4. Plano e checklist de rollout: docs/checklist.md

Variaveis de ambiente importantes

Feature flags

  1. ENABLE_GLPI_CLOSE_CRON
    • true: liga o motor de regras de status/fechamento/reabertura (processTicketLifecycleController)
    • false: desliga o motor inteiro

ServiceNow

  1. SERVICENOW_TABLE_INCIDENT_URL
  2. SERVICENOW_TABLE_REQUEST_URL
  3. SERVICENOW_TABLE_JOURNAL_URL
  4. SERVICENOW_SC_ITEM_OPTION_URL
  5. SERVICENOW_DEFAULT_USER
  6. SERVICENOW_IGNORE_DEFAULT_USER_JOURNAL
  7. SERVICENOW_EXTERNAL_TICKET_FIELD (default: u_external_ticket)

GLPI e banco intermediario

  1. GLPI_DB_*
  2. SNGLPI_DB_*
  3. GLPI_OOS_SOLUTION_TYPE_ID

Desenvolvimento

  1. Instalar dependencias:
npm install
  1. Criar env:
copy .env.example .env.development
  1. Executar:
npm run dev

Producao

Deploy manual na VM

git pull origin master
npm ci --omit=dev
pm2 start ecosystem.config.js --env production
pm2 save

Se o processo ja estiver rodando:

pm2 restart sn-glpi-sync-cron --update-env

Deploy via Gitea Actions

O workflow .gitea/workflows/deploy-production.yml roda no runner com rotulo vm-prod.

  1. Configure a variavel do repositorio PROD_DEPLOY_PATH com o caminho da aplicacao na VM de producao. Se nao configurar, o workflow usa /opt/sn-glpi-sync-new.
  2. Garanta que o arquivo .env.production exista nesse caminho na VM e contenha SERVICENOW_CAOA_TI_GROUP_ID preenchido.
  3. Faça push na branch master ou execute o workflow manualmente em Actions.
  4. Acompanhe pelo Gitea Actions ou na VM:
pm2 list
pm2 logs sn-glpi-sync-cron

Observacoes

  1. O projeto ainda nao tem suite automatizada robusta.
  2. O rollout recomendado e por fases com feature flags.
  3. Nao remover schema legado antes de estabilizar o fluxo novo.
  4. Consulte docs/checklist.md antes de cada deploy para validar pre e pos-subida.