Desenvolvimento de Pdv Offline Completo com Integração Erp Web que ja está em operação

Projeto avod – pdv offline + hub de pedidos online + integração ifood
📌 contexto

somos uma empresa saas com erp online (supabase).
Precisamos desenvolver um PDV Offline para restaurantes, que funcione como:

Sistema de caixa local

Servidor da loja

Centralizador de pedidos online

Hub de integração com iFood

Integrador com nosso Cardápio Digital

Integrador com App/WebGarçom

O sistema deve funcionar 100% offline na loja (LAN) e sincronizar com a nuvem quando houver internet.

🎯 OBJETIVO

Criar um ecossistema completo:

Servidor Local da Loja

PDV Desktop Offline

Gestor de Pedidos Online

Integração iFood

Integração Cardápio Digital próprio

Impressão inteligente por setor

Sincronização com erp online

🧠 arquitetura obrigatória
1️⃣ servidor local da loja (core)

rodando em um pc fixo da loja (mini pc ou host dedicado).

Responsável por:

Banco local

api local (http)

websocket realtime

print server

fila de sincronização (event sourcing)

hub de pedidos online

distribuição para pdvs

gestão de dispositivos

pdvs e webgarçom se conectam via lan.

🖥 2️⃣ PDV Desktop Offline (Windows – Electron)
Módulos obrigatórios
🔹 Balcão

Venda rápida

Produtos pesáveis (preparar para balança)

Múltiplos pagamentos

Cancelamentos com motivo

Sangria / Suprimento

Abertura e fechamento de caixa

🔹 Mesa

Mapa visual

Abrir mesa

Transferir

Juntar

Separar conta

Parcial / total

🔹 Comanda

Controle individual

Transferência de itens

🍔 3️⃣ gestor de pedidos online (novo módulo essencial)

este módulo roda no servidor local.

Deve centralizar pedidos de:

Cardápio Digital próprio

iFood

(futuramente Rappi / Uber Eats)

Fluxo esperado

Pedido entra via API (nuvem ou webhook iFood)

Nuvem envia para servidor local (ou servidor local consulta)

Servidor local:

grava pedido

distribui via Websocket

envia para impressão por setor

aparece no pdv

aparece no kds

interface do gestor

tela dedicada com:

lista de pedidos online

filtros por origem (ifood / cardápio)

status:

recebido

confirmado

em produção

saiu para entrega

finalizado

cancelado

sla / timer

histórico de eventos

🍟 4️⃣ integração ifood

obrigatório:

receber pedidos via webhook

confirmar pedido via api ifood

atualizar status (produção, saiu, entregue)

cancelamento

sincronização de cardápio (fase 2)

arquitetura recomendada:

webhook ifood → nuvem → servidor local

não conectar ifood direto no pdv

🌐 5️⃣ integração cardápio digital próprio

pedido online entra no supabase

supabase envia evento ao servidor local

servidor local distribui

impressão automática

aparece no pdv offline

mesmo com internet instável:

assim que reconectar, sincroniza pedidos pendentes

🖨 6️⃣ impressão inteligente

impressoras por setor

impressão automática por categoria

impressão automática de pedidos online

fila com retry

status online/offline

🧑‍🍳 7️⃣ kds (tela de produção)

recebe pedidos de:

pdv

webgarçom

ifood

cardápio digital

filtro por setor

status por pedido

timer

atualização em tempo real

🔄 8️⃣ sincronização com erp online

via eventos (outbox pattern).

Upload:

Pedidos

Pagamentos

Movimentações

Atualizações de status

Download:

Produtos

Categorias

Preços

Configurações

Sem duplicidade.
Com idempotência.

💳 9️⃣ Pagamentos

Fase 1:

Registro manual

Pix

Cartão

Fase 2:

Integração TEF Windows

Integração com adquirentes

🧾 10️⃣ Estoque Offline

Baixa automática

Ajuste manual

Sincronização

🔐 Segurança

store_id obrigatório

device_id

autenticação local

controle de permissões

logs

📦 ENTREGAS

Documento de arquitetura

Servidor Local completo

PDV Desktop

Gestor de Pedidos Online

Integração iFood funcional

Integração Cardápio Digital

Impressão por setor

KDS

Sincronização com nuvem

Teste offline total

Instalador Windows

✅ critérios de aceite

internet desligada → pdv continua vendendo

pedido ifood entra → aparece no gestor → imprime → aparece no pdv

pedido do cardápio digital entra → cai no servidor local

2 pdvs na rede → ambos atualizam

impressão por setor funciona

reconectou internet → sincroniza corretamente

⚠️ observação

este projeto exige experiência real com:

offline-first

integração ifood api

electron

esc/pos

websocket realtime

sincronização por eventos

propostas genéricas serão descartadas.

🎯 Resultado Final

Criar um PDV Offline com Hub de Pedidos Online integrado, preparado para escalar nacionalmente.