🎯 Estudo de Caso: Sistema de Cadastro de Usuários
🧩 Problema:
Precisamos de um sistema que permita cadastrar novos usuários com nome e e-mail. O sistema deve garantir que:
- O e-mail seja único.
- O nome e e-mail sejam obrigatórios.
- O e-mail tenha um formato válido.
Vamos construir isso passo a passo.
✅ 1. Requisitos Funcionais
- O sistema deve expor uma rota HTTP POST para cadastro de usuário.
- O sistema deve persistir os dados no banco de dados.
- O sistema deve retornar:
201 Created se o cadastro for bem-sucedido.
400 Bad Request se houver erro de validação.
409 Conflict se o e-mail já estiver cadastrado.
- O sistema deve validar os dados antes de salvar.
📜 2. Regras de Negócio
- Nome é obrigatório — não pode ser nulo ou vazio.
- E-mail é obrigatório — não pode ser nulo ou vazio.
- E-mail deve ser válido — deve seguir o padrão de e-mail (ex:
[email protected]).
- E-mail deve ser único — não pode haver outro usuário com o mesmo e-mail cadastrado.