Springboot-gestion-clientes es una aplicación RESTful desarrollada con Spring Boot. Esta API está diseñada para gestionar clientes, permitiendo operaciones CRUD (Crear, Leer, Actualizar, Eliminar) de manera eficiente y segura.
- ✅ Gestión de Clientes: Permite crear, leer, actualizar y eliminar clientes.
- ✅ API RESTful: Endpoints bien definidos para interactuar con el servicio de gestión de clientes.
- ✅ Documentación OpenAPI: Interfaz Swagger UI para explorar y probar los endpoints.
- ✅ Excepciones Personalizadas: Respuestas claras y detalladas para errores comunes.
- ✅ Pruebas Unitarias: Pruebas realizadas con JUnit para garantizar la calidad del código.
Aquí están los principales endpoints de la API:
| Método | Endpoint | Descripción |
|---|---|---|
| POST | /api/v1/clientes | Crea un nuevo cliente |
| GET | /api/v1/clientes | Obtiene la lista de clientes |
| GET | /api/v1/clientes/{id} | Obtiene un cliente por ID |
| PUT | /api/v1/clientes/{id} | Actualiza un cliente por ID |
| DELETE | /api/v1/clientes/{id} | Elimina un cliente por ID |
Este proyecto sigue una arquitectura bien definida:
┌─────────────────────────────────────┐
│ Controllers │
│ (REST API Endpoints) │
└──────────────┬──────────────────────┘
│
┌──────────────▼──────────────────────┐
│ Services │
│ (Lógica de Negocio) │
└──────────────┬──────────────────────┘
│
┌──────────────▼──────────────────────┐
│ Repository Layer │
│ (Acceso a Información con JPA) │
└──────────────┬──────────────────────┘
│
┌──────────────▼──────────────────────┐
│ Configuration Layer │
│ (Configuración de base de datos) │
└─────────────────────────────────────┘
Todas las capas tienen tareas específicas, asegurando una clara separación entre cada una. Esto permite un fácil mantenimiento y escalabilidad del proyecto.
- Clona el repositorio:
git clone <https://github.com/matepore/springboot-gestion-clientes> cd springboot-gestion-clientes
- Ejecuta la aplicación usando Maven:
mvn spring-boot:run
- Accede a la documentación de la API en
http://localhost:8080/db_clientes/swagger-ui/index.html#/. - Usa los endpoints para gestionar clientes según sea necesario.
- Ejecuta las pruebas unitarias:
mvn test
Este proyecto está licenciado para uso personal o educativo bajo la licencia MIT.
Mateo Calcagno
- 📧 Email: [email protected]
- 📱 Celular: +54 9 11 3119-1742
- 🌎 Nacionalidad: Argentina
- 🎓 Educación: Técnico Universitario en Desarrollo de Software
- 🏛️ Institución: Universidad de Ezeiza