12 – Endpoint: alta de estudiantes

Descripción

Implementar POST /api/v1/estudiantes completo. Es evidencia obligatoria del video.

Owner sugerido: Dev C | Branch: feature/estudiantes-alta | Depende de: #11 (closed), #16, #17, #18

Tareas

• Implementar el método crear en el controller delegando al servicio.
• Devolver 201 Created con header Location: /api/v1/estudiantes/{id} y body EstudianteResponseDTO.
• Casos cubiertos: datos válidos → 201; validación falla → 400 por campo; cédula UY inválida → 400; edad insuficiente → 400; cédula duplicada → 409.
• Probar con curl o Postman/Insomnia.
• Crear colección Postman/Insomnia en docs/api/ con requests: alta válida + cédula inválida + cédula duplicada.
• Verificar fila en Postgres: SELECT * FROM estudiante;

Commits sugeridos

feat(estudiantes): implementar endpoint POST alta con 201 + Location
docs(api): agregar colección postman con request de alta

Criterios de aceptación

• Alta exitosa persiste y devuelve 201 + Location + DTO.
• Cédula duplicada → 409 con mensaje claro.
• Errores de validación → 400 con detalle por campo.
• Documentado en Swagger.

Referencia del curso: Módulo 2 – PDFs 1, 2, 3, 4; Módulo 1 – PDFs 5, 7