O problema
Uma operação de home equity passa por muitas mãos (parceiro, análise, jurídico, pagamento) e cada etapa exige documentos e checagens. Sem um lugar só, a operação parava e ninguém sabia em que etapa estava nem o que faltava para avançar.
O e-mail é um serviço sem tabela. Quem precisa mandar usa o MailClient da libs/mail: ele monta o texto a partir do template no idioma da pessoa e faz um POST /emails assíncrono com token de serviço. O serviço mail só transforma isso em SMTP.
Decisões e por quê
- @Async no cliente
- "Esqueci minha senha" responde na hora; o envio acontece depois e nunca derruba a requisição.
- Templates na biblioteca, por idioma
- password-reset_pt.txt e password-reset.txt: o texto mora num arquivo, não no código, e cai para o padrão quando falta o idioma.
- Token de serviço
- Só serviços com o escopo certo mandam e-mail; o mail não aceita chamada de usuário.
- mail não tem tabela
- Ele só traduz HTTP em SMTP. Menos estado, nada para migrar, Mailpit no lugar do SMTP em dev.
requisiçãoresposta
Escolha um cenário acima para ver a mensagem percorrendo a arquitetura.
Como ficou
Réplica da esteira com dados fictícios (sistema interno) esteira.evilrabbit.com.br/lines/triage
Triagem
Conferência de dados2
Marina SouzaGMR$ 480 mil 1 d
Paulo HenriqueR$ 1,2 mi hoje
Combate à fraude1
Ricardo AlvesAPR$ 750 mil 4 d
Validação dos documentos2
Carla PradoGMR$ 610 mil 2 6 d
João ReisR$ 295 mil 2 d
Aguardando aprovação0
Nada aqui