🛠️ Serviços e Interface

Esta seção detalha os serviços auxiliares e a arquitetura da interface moderna do gestor.

🖥️ Modern TUI (Interface de Usuário)

A interface é construída sobre o framework Textual, fornecendo uma experiência de terminal rica em cores e interatividade.

Componentes da Dashboard

• Sidebar Esquerda: Informações do merchant, status do polling e contador de vendas. Inclui botão de Saída Limpa.
• Painel Central: Lista de cartões (OrderCard) ordenada cronologicamente (novos primeiro).
• Painel de Detalhes: Exibição completa do pedido selecionado com botões de ação dinâmicos.

Navegação por Teclado

• Up/Down: Percorre a lista de pedidos.
• Enter: Seleciona e foca nos detalhes.
• r: Dispara atualização manual imediata.
• q: Fecha o aplicativo com segurança.

🖨️ Sistema de Impressão

O gestor possui integração com impressoras térmicas ESC/POS.

• Formatação: O serviço make_invoice_new gera um template otimizado para bobinas de 48/80 colunas.
• Protocolo: Envio via Socket ou HTTP para um servidor de impressão local na porta 4013.
• Configuração: Parâmetros como fontSize e model são lidos do printer_settings.

🔄 Resiliência de Conexão

Implementamos uma camada de proteção para ambientes de rede instáveis:

• Connection Retry: No início da sessão, o sistema tenta conectar até 5 vezes com timeout de 15s cada.
• Visual Feedback: O usuário acompanha o progresso das tentativas diretamente no dashboard.
• Graceful Failure: Caso a conexão não seja possível, o sistema exibe uma mensagem clara e encerra as tentativas para poupar recursos.

🔊 Notificações Externas

O sistema pode ser configurado via .env para disparar webhooks em caso de novos pedidos:

• Telegram: Via Bot API.
• Slack/Discord: Via Webhooks nativos.

---

Voltar para a Página Inicial.