Conveyor

E-mail

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
EsteiraPTGM
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