Skip to content

11 – Controlador REST de Estudiantes

Descripción

Exponer el módulo de estudiantes como API REST con rutas semánticas, códigos HTTP correctos y documentación Swagger completa.

Owner sugerido: Dev C | Branch: feature/estudiantes-controller | Depende de: #10 (closed), #6 (closed)

Tareas

  • Crear EstudianteController en controller/ con @RestController y @RequestMapping("/api/v1/estudiantes").
  • Métodos: POST / (alta), GET / (listado paginado), GET /{id} (detalle), PUT /{id} (modificación), DELETE /{id} (baja lógica).
  • Códigos HTTP: 201 alta, 200 lectura/edición, 204 baja, 400 validación, 404 no encontrado, 409 conflicto.
  • Anotar con @Tag, @Operation, @ApiResponse para Swagger.
  • @Valid activo en @RequestBody del POST y PUT.
  • Sin lógica de negocio en el controller — solo delegación al servicio.

Commits sugeridos

feat(estudiantes): agregar EstudianteController con rutas REST v1
docs(swagger): anotar endpoints de estudiantes con operation y responses
chore(http): mapear códigos de respuesta 201/204 según semántica REST

Criterios de aceptación

  • Endpoints en /api/v1/estudiantes con verbos HTTP correctos.
  • Códigos HTTP semánticos.
  • Swagger muestra los 5 endpoints con descripciones.
  • Sin lógica de negocio en el controller.

Referencia del curso: Módulo 1 – PDF 5; Módulo 2 – PDFs 1, 2, 3, 9