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