🛠️ 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_newgera 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
fontSizeemodelsão lidos doprinter_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.