A ação de automação devolvia ‘enviado’ sem enviar: um TODO que retorna sucesso é pior que um erro
[!NOTE] Resumo Executivo (DEV-2026-114): As automações ofereciam enviar e-mail, enviar WhatsApp e criar tarefa, e o registro dizia que tudo tinha dado certo. As três ações eram um TODO que devolvia uma frase de sucesso.
🚨 O Desafio Técnico / Contexto
O método tinha só o comentário TODO e um return com ‘E-mail enviado’. A execução terminava como concluída e o formulário nem tinha campo para assunto ou texto. Falha real de webhook e ação desconhecida também terminavam como concluídas.
💡 Principais Lições Aprendidas & Descobertas
- 💡 Enquanto não existe, o código deve falhar ou nem ser oferecido. Registro falso de sucesso esconde o problema de quem depende dele.
- 💡 A execução só conclui se todas as ações rodaram. Cada ação devolve se deu certo e o motivo, e o status final sai disso, e não de uma exceção que nunca é lançada.
- 💡 A falta de campo no formulário era a pista: ninguém conseguiria ter configurado aquele envio. Confira se a tela permite usar o que ela oferece.
- 💡 Tirar a opção da tela não basta. A validação do servidor também precisa recusá-la, e o que já está salvo com ela termina como falha.
- 💡 Enviar de verdade a clientes depende de consentimento, textos e custo. Por isso a correção parou na honestidade, e o envio real ficou para quem decide o produto.
🛠️ Especificação Técnica & Código-Chave
// Antes
protected function sendEmail(array $action, $entity): string
{
// TODO: Implementar envio de e-mail
return 'E-mail enviado';
}
// Depois
default => ['ok' => false, 'message' => "Ação {$type} não executada: não está disponível"],
📈 Impacto no Ecossistema & Valor Prático
O registro de execução passou a dizer o que aconteceu, e a tela só oferece o que o sistema faz.
- Projetos Relacionados:
sistema-de-atendimento - Registro de Origem:
_data/daily.dev-19.yml
Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.