Sistema de Ativação Remota

Arquitetura de Segurança e Bloqueio PDVSouza

🚀
Visão Geral do Fluxo

Delphi PDV

Envia HVID + Nome

➜

Traefik (Proxy)

Criptografia SSL

➜

API Next.js

Valida no SQLite

➜

Resposta

ACTIVE / BLOCKED

O sistema funciona como um "Gatekeeper" (Porteiro). Sempre que o PDV inicia (ou em intervalos), ele pergunta ao servidor se aquele computador específico (HVID) tem permissão para rodar.

🧩
1. O Lado do Cliente (Delphi)

O Delphi faz uma requisição GET para a URL do seu servidor.

Endpoint Utilizado:

https://server-ativacaoremota.devsouza.online/api/check-hvid

Parâmetros Enviados:

Parâmetro	Tipo	Descrição
`hvid`	String	Identificador único do Hardware (ID do processador ou placa mãe).
`company`	String	Nome da empresa que aparece no seu Dashboard.

Exemplo de Resposta (JSON):

{
  "id": "1713100000000",
  "name": "Panificadora Central",
  "status": "ACTIVE"
}

🖥️
2. O Servidor (Next.js + SQLite)

Ao receber o HVID, o servidor executa os seguintes passos:

Busca o HVID na tabela clients.
Se não existir: Cria um novo registro automaticamente como ACTIVE.
Se existir: Verifica se o campo status é 'ACTIVE' ou 'BLOCKED'.
Registra um log na tabela logs com o IP e horário do acesso.

Estrutura do Banco de Dados:

CREATE TABLE clients (
  id TEXT PRIMARY KEY,
  name TEXT,      -- Nome da Empresa
  status TEXT,    -- 'ACTIVE' ou 'BLOCKED'
  hvid TEXT,      -- Digital do Hardware
  lastCheck TEXT  -- Data do último acesso
);

🛡️
3. Por que o Firewall travava?

O Firewall do Windows por padrão desconfia de programas que tentam "falar" com a internet sem uma assinatura digital conhecida.

O Problema: O comando IdHTTP.Get no Delphi é síncrono. Se o Firewall bloqueia a saída, o programa fica travado esperando o Windows liberar, o que nunca acontece.
A Solução: O script liberar_firewall.bat cria uma regra de exceção explícita para o seu executável, permitindo que ele acesse as portas 80 (HTTP) e 443 (HTTPS) sem interrupções.

⚙️
4. Segurança no Easypanel

O Easypanel utiliza Docker para isolar a sua aplicação. Isso garante que:

O banco de dados SQLite fique protegido em um Volume (ativacao_data).
Mesmo que o servidor reinicie, os dados de quem está bloqueado não se perdem.
O SSL (HTTPS) é renovado automaticamente, garantindo que ninguém intercepte a comunicação entre o Delphi e o Site.

🚀 Visão Geral do Fluxo

🧩 1. O Lado do Cliente (Delphi)