Squad Front

Appearance

Erros de Aplicação (Nível Global) ​

Erros de aplicação são eventos que afetam a experiência do usuário como um todo, independentemente da funcionalidade específica que ele está tentando acessar. Eles geralmente estão ligados à infraestrutura, segurança ou disponibilidade do serviço.

O que são? ​

São erros que impedem o uso normal da plataforma e exigem uma ação corretiva global ou apenas paciência do usuário.

  • Sessão expirada ou Token inválido.
  • Servidor em manutenção.
  • Falha catastrófica no banco de dados (500).
  • Usuário sem conexão com a internet.
  • App desatualizado (versão obrigatória).

Como pensar o Design? ​

Para erros globais, o design deve ser intrusivo o suficiente para que o usuário entenda que não adianta tentar continuar na tela atual, mas amigável o suficiente para não gerar pânico.

1. Mensagens de Sistema (Full Screen) ​

Quando o erro impede totalmente o uso (ex: manutenção ou sem internet), use uma tela cheia dedicada.

  • Ilustração: Ajuda a reduzir a frustração.
  • Título Claro: Diga o que aconteceu de forma direta.
  • Ação Primária: Diga ao usuário o que ele deve fazer (ex: "Tentar novamente" ou "Fazer Login").

2. Modais de Alerta (Interrupção) ​

Quando a sessão expira, por exemplo, o usuário deve ser notificado imediatamente para não perder dados inseridos em formulários.

Exemplos Práticos ​

✅ Como fazer ​

  • Sem internet: Mostre um indicador de "Offline" no topo da tela ou uma tela cheia se for uma ação crítica.
  • Sessão Expirada: "Sua sessão expirou por segurança. Por favor, faça login novamente para continuar seu atendimento."
  • Manutenção: "Estamos em manutenção preventiva para melhorar sua experiência. Previsão de retorno: 14:00."

❌ Como não fazer ​

  • Código Técnico: Nunca mostre "Error 500: Internal Server Error" ou "NullPointerException".
  • Sem Saída: Nunca mostre um erro sem um botão de ação (Tentar novamente, Voltar, Suporte).
  • Inconsistência: Usar um Toast (que some rápido) para um erro crítico de sessão expirada. O usuário pode não ver e continuar tentando salvar dados que serão perdidos.

O Impacto no Produto ​

Tratar erros de aplicação corretamente reduz o número de chamados no suporte. Se o usuário sabe que o sistema está em manutenção e quando volta, ele não tentará ligar reclamando que o sistema "está quebrado".