Requisitos Servidor Comandas

AVANÇO INFORMÁTICA

Servidor Comandas

Guia de Requisitos para Implantação

Este documento descreve os requisitos de hardware, sistema operacional e infraestrutura de rede necessários para a instalação e operação do Servidor Comandas em ambiente do cliente.

1. Visão Geral da Solução

O Servidor Comandas é o componente central responsável por intermediar a comunicação entre os dispositivos do ambiente do cliente. Ele recebe e processa requisições provenientes de:

• App de Comandas / PDV Mobile (dispositivos SmartPOS) — comunicação via API REST sobre Wi-Fi.

• PDV Legado Desktop (Linux) — comunicação via rede cabeada.

Além disso, o Servidor Comandas precisa ter acesso ao servidor do Sistema Integral (ERP Linux), que é a máquina responsável pela gestão central dos dados do cliente.

Para que toda a solução funcione corretamente, é fundamental que a infraestrutura de rede e a máquina do Servidor Comandas atendam integralmente aos requisitos descritos neste documento.

2. Topologia de Comunicação e Requisitos de Rede

A ilustração abaixo representa a topologia de comunicação entre os componentes da solução:

Componente	Tipo de Conexão	Requisito de Rede
SmartPOS (App Comandas / PDV Mobile)	Wi-Fi	Deve estar conectado à rede Wi-Fi que permita acesso ao Servidor Comandas e também a internet.
PDV Legado Desktop (Linux)	Cabo de rede (Ethernet)	Deve estar conectado via cabo na rede que permita acesso ao Servidor Comandas e ao servidor do Sistema Integral (ERP) e também a internet.
Servidor Comandas (Windows)	Cabo de rede (Ethernet)	Deve estar na rede que permita comunicação com: SmartPOS (Wi-Fi), PDV Linux (cabeado) e servidor do Sistema Integral (ERP Linux) como também a internet.
Servidor do Sistema Integral (ERP Linux)	Cabo de rede (Ethernet)	Deve estar acessível pelo Servidor Comandas e pelo PDV Legado Linux.

2.1 Requisitos Detalhados de Rede

⚠ Atenção: A comunicação entre todos os componentes ocorre pela rede local (LAN) do cliente. O Servidor Comandas deve conseguir se comunicar simultaneamente com os SmartPOS via Wi-Fi e com o PDV Linux e o servidor do ERP via cabo.

Requisito	Descrição
Padrão de rede	Ethernet 10/100/1000 Mbps (Gigabit Ethernet recomendado).
Topologia	Todos os dispositivos devem estar na mesma rede local (LAN) ou com roteamento adequado entre sub-redes.
IP estático — Servidor Comandas	É obrigatório configurar um endereço IP fixo (estático) na máquina do Servidor Comandas, para que os SmartPOS e o PDV Linux sempre consigam localizá-lo.
Firewall / Bloqueios	As portas utilizadas pela aplicação Servidor Comandas devem estar liberadas no firewall da rede e no firewall do Windows da máquina. As portas específicas serão informadas pela equipe de implantação.
Wi-Fi (SmartPOS)	O roteador ou access point Wi-Fi deve estar na mesma rede ou ter roteamento para o Servidor Comandas. Sinal estável e sem isolamento de cliente (AP Isolation desativado).
Cabo de rede (PDV Linux)	Conexão física obrigatória via cabo Ethernet entre o PDV Linux e o switch ou roteador da rede do cliente.
Velocidade mínima recomendada	Rede local com pelo menos 100 Mbps entre os dispositivos.

3. Requisitos de Hardware — Máquina do Servidor Comandas

A máquina destinada a operar o Servidor Comandas deve atender às especificações mínimas a seguir. Recomendamos fortemente o uso das configurações recomendadas para garantir estabilidade e desempenho adequados.

Componente	Especificação Mínima	Especificação Recomendada
Sistema Operacional	Windows 11 — 64 bits	Windows 11 — 64 bits
Processador	Intel Core i3 (ou equivalente), clock mínimo de 2,3 GHz, pelo menos 4 núcleos.	Intel Core i5 ou superior, 4+ núcleos, clock ≥ 2,5 GHz.
Memória RAM	8 GB DDR3	12 GB DDR3 ou DDR4
Placa de Rede	Padrão 10/100/1000 Mbps (Gigabit Ethernet)	Padrão 10/100/1000 Mbps (Gigabit Ethernet)
Armazenamento	SSD SATA ou NVMe de no mínimo 240 GB (Kingston ou similar)	SSD SATA ou NVMe de no mínimo 240 GB (Kingston ou similar)

4. Requisitos de Sistema Operacional e Configuração da Máquina

4.1 Sistema Operacional

• Windows 11 — 64 bits

• A conta de usuário do Windows utilizada pela aplicação deve ter permissões de Administrador Local.

4.2 Configurações Importantes

• IP estático configurado na placa de rede (obrigatório — veja seção 2.1).

• Atualizações automáticas do Windows: recomendamos que reinicializações automáticas fora do horário de funcionamento sejam configuradas para evitar interrupções no serviço.

• Antivírus: caso haja antivírus instalado, os diretórios e processos do Servidor Comandas devem ser adicionados como exceção para evitar bloqueios indesejados.

• Firewall do Windows: as portas da aplicação devem ser liberadas (a equipe de implantação orientará sobre quais portas configurar).

• Ideal que essa máquina nunca seja desligada, já que ela realiza o envio das vendas ao servidor integral. Ou seja, ela precisa estar sempre em execução contínua.

5. Checklist de Pré-Implantação

Antes da visita de implantação, o cliente deve confirmar que todos os itens abaixo estão atendidos:

#	Item	Status
1	Máquina com Windows 11 — 64 bits disponível e ligada.	☐ Confirmado
2	Processador com pelo menos 4 núcleos e 2,3 GHz.	☐ Confirmado
3	Mínimo de 8 GB de RAM instalados.	☐ Confirmado
4	SSD de no mínimo 240 GB disponível.	☐ Confirmado
5	Placa de rede Gigabit (10/100/1000 Mbps).	☐ Confirmado
6	IP estático configurado (ou a ser configurado pela equipe Avanço).	☐ Confirmado
7	Cabo de rede conectando a máquina ao switch/roteador.	☐ Confirmado
8	SmartPOS com acesso à rede Wi-Fi que alcança o Servidor Comandas.	☐ Confirmado
9	PDV Linux (legado) com acesso via cabo à mesma rede do Servidor Comandas.	☐ Confirmado
10	Servidor do Sistema Integral (ERP Linux) acessível na rede.	☐ Confirmado
11	Firewall e antivírus configurados para permitir a aplicação (ou a configurar com apoio Avanço).	☐ Confirmado

6. Suporte e Contato

Em caso de dúvidas sobre os requisitos ou durante o processo de implantação, entre em contato com a equipe da Avanço Informática:

Avanço Informática — Suporte Técnico

Site: www.avancoinfo.com.br

Telefone: (31) 3025-1188

— Documento gerado pela equipe Avanço Informática —