De: Joana Pires, líder de back-end, Fernhill Garden Supply
"No próximo trimestre vamos migrar o serviço de pedidos para um novo framework, e quero que antes as regras dele fiquem escritas em Java puro, com testes, para que a migração não altere o comportamento por acidente.
Construa uma classe Api que responda a linhas de requisição: listar, criar e ler pedidos, validar sku e quantidade, tornar as criações seguras para nova tentativa com uma chave de idempotência, retornar JSON e dar a todos os erros o mesmo corpo de problem details. Sem framework e sem banco de dados: um mapa basta."
Resultado esperado: cada requisição do roteiro recebe o status e o corpo corretos, do roteamento até os erros com problem details.
Este projeto constrói a parte de um serviço web que os frameworks não escrevem por você: as regras. Uma requisição chega como uma linha de texto; sua classe Api a responde com um status e um corpo. Cada passo adiciona um comportamento e mantém tudo o que veio antes, então o seu próprio código segue adiante.
Você vai rotear requisições para 200, 201, 404 e 405, validar os campos do pedido, guardar pedidos com ids, tornar o POST seguro para nova tentativa com chaves de idempotência, retornar corpos JSON e terminar com um único formato de erro para todas as falhas.
Os testes enviam roteiros curtos de requisições e comparam cada resposta, então uma mudança que quebre uma regra anterior aparece na hora.
Cada requisição é uma linha: método, rota e depois os parâmetros.