====== Foods Mobile ======

//Aplicativo de gestão de pedidos para restaurantes, disponível para smartphones Android e maquininhas Stone.//

O **Foods Mobile** é o aplicativo da Ello para lançar e fechar pedidos sem precisar de um computador. Ele funciona em smartphones Android e maquininhas Stone, e atende três formas de operação — **Mesa**, **Ficha** e **Cartão de consumo** — aceitando pagamento em **PIX**, **Crédito/Débito**, **Dinheiro** e **Outros**, com a opção de emitir **NFC-e** ao final.

Para configurar e usar o módulo Foods no ERP, veja [[ello_erp:modulos:foods|Módulo Foods]].

===== Os componentes do ecossistema =====

O Foods Mobile faz parte de um ecossistema com três partes que trabalham juntas:

^ Componente ^ O que faz ^ Onde roda ^
| **Foods Mobile** | Aplicativo usado pelo garçom ou atendente para lançar pedidos, fechar contas e receber pagamentos | Smartphone Android ou maquininha Stone |
| **Serviço Foods** | Programa instalado no servidor da loja que processa os pedidos, distribui o cardápio para os dispositivos e registra as vendas no Ello | No servidor da loja |
| **Módulo Foods no Ello ERP** | Área dentro do Ello onde o gestor configura o cardápio, mesas, fichas e acompanha os pedidos em tempo real | No computador do gestor |

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

<uml>
actor "Garçom / Atendente" as G
actor Gestor

rectangle "Dispositivo Móvel" {
  component "Foods Mobile" as App
}

rectangle "Servidor" {
  component "Serviço Foods" as SVC
  database "Banco de Dados\nEllo ERP" as DB
}

rectangle "Computador do Gestor" {
  component "Ello ERP\n(Módulo Foods)" as ERP
}

G --> App : lança pedido /\nfecha conta
App --> SVC : envia pedido
App <-- SVC : recebe cardápio\ne configurações
SVC --> DB : salva pedido e\nregistra pagamento
ERP --> DB : configura cardápio,\nmesas e fichas
Gestor --> ERP : acompanha pedidos\ne faz configurações
</uml>

===== Formas de operação =====

O aplicativo atende três modos de trabalho, dependendo do tipo de estabelecimento:

  * **Mesa** — os pedidos ficam vinculados a uma mesa física. Vários garçons podem lançar itens na mesma mesa ao longo do atendimento.
  * **Ficha** — o cliente recebe um número de ficha na entrada. Os pedidos ficam associados à ficha e a conta é fechada ao final. Comum em bares, eventos e espaços com consumo livre.
  * **Cartão de consumo** — semelhante à ficha, mas com um cartão individual por cliente. O saldo consumido é controlado pelo sistema ao longo do evento ou da visita.

===== Fluxo de um pedido =====

  - O atendente abre o aplicativo e seleciona a mesa, ficha ou cartão do cliente
  - Registra os itens do pedido navegando pelo cardápio (por nome ou categoria)
  - O pedido é enviado para o servidor e fica disponível para a cozinha ou bar
  - Ao fechar a conta, o sistema exibe o resumo completo do consumo
  - O atendente seleciona a forma de pagamento: PIX, crédito/débito, dinheiro ou outros
  - Opcionalmente, é emitido um cupom fiscal (NFC-e) para o cliente
  - A venda é registrada automaticamente no Ello ERP

===== Conteúdo desta seção =====

^ Página ^ Conteúdo ^
| [[ello_foods_mobile:instalacao|Instalação]] | Pré-requisitos técnicos: criação do usuário e permissões no banco de dados. Destinado à equipe de TI e implantação. |
| [[ello_foods_mobile:configuracao|Configuração]] | Parâmetros do Ello ERP (habilitar Mobile, conta PIX, NFC-e automática) e configurações do dispositivo (conexão, credenciais, terminal e modo de operação). |
| [[ello_foods_mobile:operacao|Guia de operação]] | Passo a passo do uso diário: login, mesas, pedidos, pagamentos (PIX e cartão), comprovante, NFC-e e modo Ficha. |
| [[:integracoes:stone|Onboarding Stone]] | Instruções para ativação na maquininha da Stone. |