Roteiro de Implantação — DSBoards

0Como funciona (visão rápida)

O ERP de cada cliente fica na rede do cliente. Um túnel WireGuard liga o servidor do cliente ao nosso servidor (o hub, IP 10.8.0.1). Pelo túnel, o sincronizador lê o banco do cliente (com um usuário somente leitura) e copia os dados para a nuvem. O app do cliente lê da nuvem — nunca direto do ERP.

Cada cliente recebe um IP próprio dentro do túnel, sempre na faixa 10.8.0.x.

1Cadastrar o cliente no painel

No painel administrativo → aba Clientes → Novo cliente. Preencha o nome/identificação. Os dados de conexão (host, banco, usuário, senha) serão preenchidos no passo 6, depois que o túnel e o usuário do ERP existirem.

2Gerar o túnel WireGuard

No detalhe do cliente, clique em “Gerar túnel WireGuard”. O painel cria a configuração, registra o cliente no hub e mostra o arquivo .conf para baixar. Anote o IP do túnel gerado (algo como 10.8.0.10).

3Instalar o túnel no servidor do cliente

No servidor do cliente (onde roda o Postgres do ERP), instale o WireGuard, importe o .conf gerado no painel, ative o túnel e confirme o handshake. Siga o bloco do sistema operacional do servidor.

🐧 Servidor Linux

cat /etc/os-release     # distribuição + versão
uname -r                # versão do kernel

# baixar o instalador direto da VPS
curl -fsSLO https://apidsboards.duesoft.com.br/client-setup-linux.sh

# ERP na MESMA máquina (padrão 127.0.0.1:5434):
sudo bash client-setup-linux.sh --conf SEU_CLIENTE.client.conf

# ERP em outra máquina/porta da rede local:
sudo bash client-setup-linux.sh --conf SEU_CLIENTE.client.conf --erp-host 192.168.0.4 --erp-port 5434

Instale o WireGuard (conforme a distribuição):

# Debian / Ubuntu
sudo apt update && sudo apt install -y wireguard

# RHEL / AlmaLinux / Rocky / Fedora / CentOS
sudo dnf install -y wireguard-tools

Copie o .conf como wg0.conf, suba o túnel (e deixe subir no boot) e confirme:

sudo cp cliente.conf /etc/wireguard/wg0.conf
sudo systemctl enable --now wg-quick@wg0
sudo wg show            # tem que aparecer "latest handshake: ..." recente

Passo a passo (CentOS 7 / RHEL 7), como root:

# 1) ferramentas do WireGuard (via EPEL)
yum install -y epel-release
yum install -y wireguard-tools

# 2) instalar o Go (baixado direto do site — não depende de repositório)
cd /tmp
curl -LO https://go.dev/dl/go1.22.5.linux-amd64.tar.gz
rm -rf /usr/local/go && tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz

# 3) compilar o wireguard-go (espelho no GitHub) e pôr no PATH
cd /tmp
curl -L -o wg-go.tar.gz https://github.com/WireGuard/wireguard-go/archive/refs/heads/master.tar.gz
tar xzf wg-go.tar.gz
cd wireguard-go-*/
/usr/local/go/bin/go build -o /usr/bin/wireguard-go

# 4) instalar o .conf e subir (cai sozinho no modo usuário)
cp cliente.conf /etc/wireguard/wg0.conf
chmod 600 /etc/wireguard/wg0.conf
systemctl enable --now wg-quick@wg0
wg show          # tem que aparecer "latest handshake: ..." recente

🪟 Servidor Windows

1. Baixe e instale o WireGuard oficial: wireguard.com/install (instalador .msi).
2. Abra o WireGuard → “Import tunnel(s) from file” / “Importar túnel de arquivo” → selecione o .conf gerado no painel. (Dica: dê ao arquivo um nome simples, sem espaços — ex.: cliente.conf.)
3. Com o túnel selecionado, clique em “Activate” / “Ativar”.
4. Ao ativar, o WireGuard registra o túnel como serviço do Windows, que sobe sozinho no boot — não precisa configurar mais nada para persistir.
5. Confirme na própria janela: Status: Active e um “Latest handshake” recente.

4Criar o usuário de leitura dsboards_ro (SQL)

No Postgres do ERP do cliente (não na nuvem!), crie um usuário somente leitura. Conecte como superusuário (ex.: postgres) e, importante, no próprio banco do ERP (o mesmo do campo Banco do cadastro) — não no banco postgres.

sudo -i        # pede a senha uma vez; o prompt passa a terminar em "#"

No terminal do servidor, abra o psql já conectado ao banco do ERP, na porta padrão 5434 (troque <banco> pelo nome do banco do ERP):

sudo -u postgres psql -p 5434 -d <banco>

Prefere pgAdmin? Conecte como postgres no banco do ERP (porta 5434) e rode o SQL abaixo numa aba de query.

Comece sempre com a sessão limpa e confira onde está (evita o erro permission denied por sessão presa ou banco errado):

RESET ROLE;                   -- desfaz qualquer SET ROLE anterior
SELECT current_database();    -- precisa ser o BANCO DO ERP, não "postgres"
SHOW is_superuser;            -- precisa ser "on"

Confirmado isso, crie o usuário e as permissões (troque <banco> pelo nome do banco do ERP e defina uma senha forte):

-- Usuário de leitura do DSBoards
CREATE USER dsboards_ro WITH PASSWORD 'TROQUE_POR_UMA_SENHA_FORTE';

-- Só pode ler, nunca gravar (trava extra de segurança)
ALTER ROLE dsboards_ro SET default_transaction_read_only = on;

-- Permissões de leitura no banco do ERP
GRANT CONNECT ON DATABASE <banco> TO dsboards_ro;
GRANT USAGE ON SCHEMA public TO dsboards_ro;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO dsboards_ro;

-- Garante leitura também nas tabelas criadas no futuro
ALTER DEFAULT PRIVILEGES IN SCHEMA public
  GRANT SELECT ON TABLES TO dsboards_ro;

5Liberar o acesso no pg_hba.conf

Criar o usuário não basta: o Postgres também precisa autorizar a origem da conexão. O sincronizador chega pelo túnel com o IP de origem 10.8.0.1 (o hub).

Primeiro, descubra onde está o pg_hba.conf em uso. Pergunte ao próprio Postgres, forçando a porta 5434 (padrão Duesoft) — assim você acerta a instância do ERP e não outra que exista no servidor:

sudo -u postgres psql -p 5434 -c "SHOW hba_file;"

Se o psql não conectar, procure no disco: sudo find / -name pg_hba.conf 2>/dev/null

Abra exatamente esse arquivo num editor de texto. O caminho costuma ser algo como /var/lib/pgsql/data/pg_hba.conf ou /etc/postgresql/<versão>/main/pg_hba.conf — use o que o SHOW hba_file; retornou. Com o nano (mais simples):

sudo nano /caminho/do/pg_hba.conf

No nano: role até perto das outras linhas host, cole a linha abaixo, salve com Ctrl+O e Enter, e saia com Ctrl+X. Prefere o vi/vim? sudo vi /caminho/do/pg_hba.conf (aperte i para editar, Esc e :wq para salvar e sair).

# Debian / Ubuntu
sudo apt-get update && sudo apt-get install -y nano

# CentOS 7 / RHEL 7 (yum)
sudo yum install -y nano

# RHEL 8+ / Rocky / Alma / Fedora (dnf)
sudo dnf install -y nano

Adicione esta linha antes das regras genéricas:

# DSBoards — leitura pela nuvem via WireGuard
host    <banco>    dsboards_ro    10.8.0.1/32    scram-sha-256

Depois, recarregue a configuração (não precisa reiniciar) — também na porta 5434:

sudo -u postgres psql -p 5434 -c "SELECT pg_reload_conf();"

6Preencher a conexão no cadastro

Volte ao painel → cliente → e preencha os dados de conexão:

7Criar o usuário do app (convite por e-mail)

No detalhe do cliente → Novo usuário. Marque “Enviar convite por e-mail” e informe o e-mail do usuário. O sistema envia, para o próprio usuário: a chave de ativação, o login e um link para ele criar a própria senha no primeiro acesso — você não precisa definir senha. Se o cliente ainda não tiver uma chave ativa, o convite gera uma automaticamente.

8Verificar

1. Confirme no servidor do cliente: sudo wg show mostra handshake recente.
2. O sincronizador roda a cada ~15 minutos. Na primeira vez para um cliente novo, ele faz o carregamento completo (cadastros + movimentação).
3. Peça ao cliente para abrir/reabrir o app — os dados devem aparecer.

9Solução de problemas (app zerado)

O cliente entra no app e vê os menus, mas sem dados? A ativação está OK — o problema é a sincronização não estar alcançando o ERP. Confira, nesta ordem: