Este proyecto es una simulación de un sistema de gestión de productos para un e-commerce. Fue desarrollado como parte de un trabajo práctico, pero con un enfoque profesional: aplicando arquitectura limpia, TDD y DTOs 💡.
-
✅ Arquitectura limpia (Clean Architecture)
Separación de responsabilidades por capas: dominio, aplicación, infraestructura y adaptadores. -
✅ TDD (Test-Driven Development)
El desarrollo se guió escribiendo primero los tests unitarios con JUnit 5 y Mockito 🧪. -
✅ Uso de DTOs
Se usaron DTOs (Data Transfer Objects) para desacoplar los datos de entrada/salida del modelo de dominio. -
✅ Modelo de dominio rico
Las entidades encapsulan comportamiento y validaciones propias.
- 📌 Crear producto
- 📌 Listar productos
- 📌 Buscar producto por nombre
- 📌 Actualizar producto (precio y stock)
- 📌 Eliminar producto
- 📌 Aumentar stock
- 📌 Disminuir stock (validando disponibilidad)
- Producto duplicado
- Stock insuficiente
- Cantidad negativa
ProductoYaExistenteExceptionProductoNoEncontradoExceptionStockInsuficienteExceptionCantidadNegativaException
Estas excepciones permiten expresar reglas de negocio de forma clara y reutilizable dentro del dominio.
- ☕ Java 17
- 🧪 JUnit 5
- 🧰 Mockito
- 🔧 Maven
- 🧱 Clean Architecture
- ☕ Java 17 instalado
- 🔧 Maven 3.8+ instalado
- 💻 IDE recomendado: IntelliJ IDEA, Eclipse o VS Code con soporte para Java
Desde la línea de comandos vas a poder: 📌 Crear productos 📋 Listar productos 🔍 Buscar productos por nombre ✏️ Modificar precio y stock 🗑️ Eliminar productos ➕ Aumentar stock ➖ Disminuir stock (con validación de disponibilidad)
Todo esto sin necesidad de interfaz gráfica ni conexión a base de datos.
Se usó JUnit 5 y Mockito para validar todos los casos de uso importantes del dominio.
La cobertura incluye:
- Creación de productos
- Validación de duplicados
- Búsqueda, listado, eliminación
- Disminución y aumento de stock
- Manejo de excepciones de negocio
# Maven ./mvnw test
Este proyecto no solo cumple con los requisitos funcionales, sino que agrega valor extra al implementar principios de diseño y buenas prácticas que son estándar en el desarrollo profesional de software. Fue pensado para ser mantenible, escalable y fácil de entender.
🛠️ Entrega parcial: este repositorio está en desarrollo activo.
Próximamente se implementará: 💾 Persistencia de datos en una base de datos 🖥️ Interfaz web amigable para gestionar productos desde el navegador
Este proyecto fue realizado como práctica individual, pero se aceptan ideas, sugerencias o mejoras.
¡Todo feedback es bienvenido!