integrador-client¶
Status: Rascunho · Responsável: Gustavo Madruga · Atualizado em: 2026-09-10
Pedidos, clientes e produtos criados na nuvem (plataforma de integração X-Adm) precisam entrar
no ERP — e hoje param na fronteira: as tabelas-espelho ficam pendentes no banco do cliente sem
ninguém que as grave no X-Adm. O integrador-client fecha esse último trecho: é um programa
que roda na máquina do cliente, junto ao ERP, recebe os dados da nuvem automaticamente
(sincronização PowerSync, offline-first) e os grava no X-Adm chamando o próprio runtime ZIM
(zimrtmu.exe), devolvendo para a nuvem o resultado de cada registro — gravado, erro de dado ou
tentar de novo.
Por que importa¶
- Fim da redigitação — o que nasce na nuvem entra no ERP sozinho, com rastro de status por registro.
- Feito para a equipe do ERP — código Java propositalmente simples e explícito, mantível por
quem desenvolve em ZIM; instala como um único
.jar+ arquivo de configuração, rodando no Java 8 que já existe na máquina do ERP. - Robusto por construção — se a rede cai, a sincronização continua de onde parou; se o ZIM está ocupado ou sem licença, o lote tenta de novo sozinho.
- Visível de longe — cada instalação avisa que está viva: a X-Adm vê a versão e os fluxos de cada cliente sem acesso remoto à máquina, e é alertada quando uma instalação para — antes de o cliente reclamar.
Estado atual e desenho completo: Documentação Completa.
Etapas¶
O que já foi entregue:
- O que nasce na nuvem entra no ERP sozinho, com status por registro.
- A mesma instalação atende várias origens de dado do ERP, não só uma.
- Falha transitória deixa de virar martelada no ERP, e a crítica do X-Adm chega a alguém.
- O X-Adm passa a receber os componentes do kit, não só o pedido do kit.
- Pedido não chega mais ao ERP sem o cliente — o que depende viaja junto ou não viaja.
O que está planejado:
- Instalação parada deixa de ser descoberta pelo cliente: a plataforma vê versão e fluxos de cada uma e alerta quando alguma some.