Requisitos
O que o servidor da loja precisa ter antes de instalar o agente.
O agente é um executável único, sem instalador gráfico, sem runtime para instalar junto e sem banco próprio. Os requisitos são curtos de propósito: ele roda num servidor que já está fazendo outra coisa — o ERP — e não pode atrapalhar.
Sistema operacional
| Windows Server | 64 bits |
| Linux | 64 bits, com systemd |
Windows Server é o caso comum numa loja; Linux existe e é minoria. Não há versão para 32 bits nem para ARM.
Acesso ao banco do ERP
O agente precisa alcançar o Postgres do ERP e ter um usuário de leitura criado nele.
O caso mais simples é o agente rodar na mesma máquina do banco, e é o que o instalador presume. Se o Postgres estiver em outro servidor, isso se resolve com uma variável na instalação — mas o agente precisa alcançar a porta do Postgres naquela máquina.
Rede
Só saída. Nenhuma porta precisa ser aberta para a internet, e nada de fora alcança o servidor da loja.
| Necessário | HTTPS (porta 443) de saída |
| Não necessário | porta de entrada, IP fixo, VPN, DNS dinâmico |
Se a rede da loja restringe destinos, o endereço a liberar é
api.assessoriaplenus.com. Havendo proxy ou inspeção de TLS no caminho,
avise a equipe Plenus antes da instalação — é mais rápido combinar antes do que
diagnosticar depois.
Permissões e recursos
Na instalação
Administrador no Windows, root no Linux. É o que permite registrar o serviço do sistema.
Em disco
Poucos megabytes: o executável e um arquivo de configuração. O histórico não fica na loja.
O agente sobe com a máquina e roda continuamente, mas só lê o banco dentro da janela de horário combinada — normalmente fora do expediente, para não disputar o banco com os caixas. Como o dado chega
Nada que o agente exige do ERP
Vale dizer o que não entra na lista, porque costuma ser a primeira preocupação de quem administra o servidor:
- não é preciso parar, reiniciar ou reconfigurar o ERP;
- não é preciso instalar nada dentro do banco — nem função, nem gatilho, nem extensão;
- não é preciso alterar tabela nenhuma;
- não é preciso janela de manutenção.
A instalação acontece com o ERP rodando e ninguém percebe.