📘 API REST – user-service

Método	Endpoint	Descripción
GET	/api/v1/users	Lista todos los usuarios
GET	/api/v1/users/{id}	Obtiene un usuario por su ID
POST	/api/v1/users	Crea un nuevo usuario
PUT	/api/v1/users/{id}	Actualiza un usuario existente
DELETE	/api/v1/users/{id}	Elimina un usuario por su ID
GET	/api/v1/users/by/{id}	Obtiene un usuario por su ID - Camel
GET	/api/v1/users/getAll	Obtiene usuarios - Camel
GET	/api/v1/users/external/{id}	Obtiene usuarios externos - Camel

Ejemplo de objeto UserRequestDto (para POST/PUT):

{
  "name": "Cristian",
  "lastName": "Méndez",
  "age": 29
}

---

💪 Comandos útiles

Generar Mappers

./mvnw clean compile

Limpiar

./mvnw clean

🥪 1. Construir el JAR (Build de la app)

./mvnw clean package -DskipTests

Crea el archivo .jar del microservicio dentro de target/. Se requiere para construir la imagen Docker.

---

🐳 2. Construir la imagen Docker

docker build -t user-service .

Crea una imagen llamada user-service a partir del Dockerfile. Esta imagen puede ejecutarse en cualquier máquina con Docker.

---

🧱 3. Levantar el microservicio + MySQL con Docker Compose

docker compose up --build

Construye (si es necesario) y levanta todo el stack: base de datos + microservicio. Expone el microservicio en http://localhost:8081.

---

🚫 4. Detener los servicios (pero mantener contenedores)

docker compose stop

Detiene los contenedores pero conserva los datos, imágenes y volúmenes.

---

🛉 5. Detener y eliminar contenedores

docker compose down

Detiene y elimina todos los contenedores, redes y conexiones del docker-compose.yml.

---

🚨 6. Eliminar contenedores y volúmenes (incluye MySQL)

docker compose down -v

Detiene, elimina contenedores, redes y volúmenes de datos (como la base MySQL).

---

🔎 7. Ver logs

docker compose logs -f

Muestra logs en tiempo real de todos los servicios del docker-compose.

---

✅ Resultado final

• Tu API estará disponible en: http://localhost:8081/api/v1/users
• Puedes probar con Postman, Insomnia o curl