De: Joana Pires, responsable de back-end, Fernhill Garden Supply
"El próximo trimestre vamos a pasar el servicio de pedidos a un framework nuevo, y quiero que antes sus reglas queden escritas en Java puro, con pruebas, para que el cambio no pueda alterar el comportamiento por accidente.
Construye una clase Api que responda líneas de petición: listar, crear y leer pedidos, validar el sku y la cantidad, hacer que las creaciones se puedan reintentar con seguridad con una clave de idempotencia, devolver JSON y dar a todos los errores el mismo cuerpo de problem details. Sin framework y sin base de datos: un mapa basta."
Resultado esperado: cada petición del guion recibe el estado y el cuerpo correctos, desde el enrutamiento hasta los errores con problem details.
Este proyecto construye la parte de un servicio web que los frameworks no escriben por ti: las reglas. Una petición llega como una línea de texto; tu clase Api la responde con un estado y un cuerpo. Cada paso añade un comportamiento y conserva todo lo anterior, así que tu propio código sigue adelante.
Vas a enrutar peticiones a 200, 201, 404 y 405, validar los campos del pedido, guardar pedidos con ids, hacer que un POST se pueda reintentar con seguridad mediante claves de idempotencia, devolver cuerpos JSON y terminar con un único formato de error para todos los fallos.
Las pruebas envían guiones cortos de peticiones y comparan cada respuesta, así que un cambio que rompa una regla anterior se nota enseguida.
Cada petición es una línea: método, ruta y después los parámetros.