Conveyor

Arquitetura de pastas

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.

Toda pasta tem um único trabalho e a regra é pelo que a classe é, não pelo que é conveniente. É a parte que mais protege o código de apodrecer.

Decisões e por quê

Controller faz quatro coisas
Lê a requisição, chama um caso de uso, loga e responde. Regra de negócio no controller é regra que ninguém acha.
Um caso de uso, um execute()
Cada ação do produto é uma classe. O nome da classe é a documentação e o teste é óbvio.
Sem pasta service/
service/ vira depósito de tudo. Ação do produto é use_case/, borda de saída é client/, consulta é repository/.
OpenAPI fora do controller
documentation/ guarda as anotações; o controller fica legível.
Sem try/catch
Exceção própria e um RestExceptionHandler moldam toda resposta de erro do mesmo jeito.

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