====== Ecossistema PDV ======

O **PDV (Ponto de Venda)** é o sistema de frente de caixa do Ello ERP. Ele permite registrar vendas diretamente no balcão, emitir cupons fiscais (NFC-e) e integrar pagamentos — tudo sincronizado automaticamente com o estoque, financeiro e fiscal do Ello.

===== Os três componentes =====

O ecossistema é composto por três partes que trabalham juntas:

^ Componente ^ O que faz ^ Onde roda ^
| **Frente de Caixa (PDV)** | Aplicativo usado pelo operador para registrar vendas, receber pagamentos e imprimir cupons | No computador/terminal do caixa |
| **Gollum** | Serviço que fica no servidor e é o "cérebro" do PDV: recebe as vendas, emite as notas fiscais, transmite para a SEFAZ e distribui produtos e preços para os terminais | No servidor da loja |
| **Módulo PDV no Ello ERP** | Área dentro do Ello retaguarda onde o gestor configura formas de pagamento, permissões de operadores e monitora a sincronização | No computador do gestor |

===== Como os componentes se comunicam =====

<uml>
actor Operador
actor Gestor

rectangle "Terminal de Caixa" {
  component "Frente de Caixa (PDV)" as PDV
}

rectangle "Servidor" {
  component "Gollum" as G
  database "Banco de Dados\nEllo ERP" as DB
}

rectangle "Computador do Gestor" {
  component "Ello ERP\n(Retaguarda)" as ERP
}

Operador --> PDV : registra venda
PDV --> G : envia venda
PDV <-- G : recebe produtos e preços
G --> DB : salva venda e\ngrava nota fiscal
G <-- DB : lê dados do ERP
ERP --> DB : configura\nformas de pagamento
Gestor --> ERP : configura o PDV
</uml>

===== Fluxo de uma venda =====

  - O operador registra os itens na frente de caixa
  - Seleciona a forma de pagamento (dinheiro, cartão, PIX etc.)
  - O terminal solicita ao servidor a emissão do cupom fiscal (NFC-e)
  - O servidor emite a nota e retorna os dados para impressão
  - O comprovante é impresso para o cliente
  - Em segundo plano, a venda é registrada no Ello ERP (pedido, contas a receber)

===== Documentação por componente =====

  * [[ello_pdv:pdv_app|Aplicativo PDV (Frente de Caixa)]]
    * [[ello_pdv:pdv_app:operacao_de_venda|Operação de Venda]]
    * [[ello_pdv:pdv_app:sincronizacao|Sincronização de Dados]]
  * [[ello_pdv:gollum|Gollum — Serviço de Retaguarda]]
    * [[ello_pdv:gollum:processamento_vendas|Processamento de Vendas]]
    * [[ello_pdv:gollum:geracao_de_cargas|Geração de Cargas para os PDVs]]
    * [[ello_pdv:gollum:integracoes|Integrações (iFood, Scanntech, PIX etc.)]]
  * [[ello_erp:modulos:pdv|Módulo PDV no Ello ERP (Configuração)]]
    * [[ello_erp:modulos:pdv:finalizadoras|Finalizadoras (Formas de Pagamento)]]
    * [[ello_erp:modulos:pdv:replicacao|Replicação de Dados]]
    * [[ello_erp:modulos:pdv:funcoes_e_usuarios|Funções e Permissões dos Operadores]]
    * [[ello_erp:modulos:pdv:grupos_de_perguntas|Grupos de Perguntas]]
    * [[ello_erp:modulos:pdv:vendas_processadas|Acompanhamento de Vendas Processadas]]