🍽️ Taller MasterChef — API de Gestión de Recetas

🛠️ Stack Tecnológico

🌟 API REST moderna para gestionar recetas de cocina con Spring Boot + MongoDB Atlas
🚀 Desplegada en Azure App Service usando Docker y GitHub Actions CI/CD

📑 Tabla de Contenidos

📌 Sección Principal	🔗 Enlace Directo	📌 Sección Principal	🔗 Enlace Directo
👩‍💻 Descripción	Ver	🌐 API en Azure	Ver
⚙️ Tecnologías	Ver	📘 Endpoints	Ver
🧩 Estructura	Ver	🧪 Testing	Ver
🚀 Instalación Local	Ver	☁️ CI/CD Azure	Ver
🤝 Autor	Ver

📋 Navegación Detallada:

🎯 Sección	📝 Contenido Incluido
1️⃣ Descripción	Características principales • Contexto MasterChef • Modelo de datos
2️⃣ Tecnologías	Stack completo • Uso de cada herramienta
3️⃣ Estructura	Arquitectura • Organización del código
4️⃣ Instalación	Prerequisitos • Configuración • Ejecución • Troubleshooting
5️⃣ Azure	URL de la API • Swagger en la nube
6️⃣ Endpoints	Documentación completa • Request/Response • Códigos HTTP
7️⃣ Testing	Pruebas unitarias • JaCoCo • SonarQube
8️⃣ CI/CD	Pipeline • Evidencias • Infraestructura
9️⃣ Autor	Información personal • Contacto

Descripción del Proyecto

Taller MasterChef es un backend que expone una API REST para administrar recetas de cocina.

Permite crear recetas, ver recetas existentes, actualizar información y eliminarlas.
Cada receta incluye nombre, ingredientes, pasos y autor.
La información se guarda en una base de datos MongoDB Atlas.
El servicio corre dentro de un contenedor Docker, y está desplegado en Azure App Service.
Se implementó un pipeline de CI/CD con GitHub Actions, para que cada cambio se compile, se pruebe y se despliegue automáticamente.
La API está documentada con Swagger/OpenAPI, publicada públicamente en Azure.

Este proyecto demuestra:

Conexión a base de datos en la nube (MongoDB Atlas).
Backend productivo con despliegue en la nube.
Buenas prácticas de control de errores.
Pruebas unitarias con reporte de cobertura (JaCoCo).
Pipeline de despliegue continuo.

🎯 Caso de Estudio: MasterChef Celebrity

📺 Contexto del Proyecto

🌟 Un importante programa de telerrealidad de cocina quiere lanzar su sitio web oficial donde los televidentes puedan:

📖 Consultar y aprender sobre las recetas que han aparecido a lo largo de las temporadas
🤝 Interactuar publicando sus propias recetas
🍳 Conectar con chefs, participantes y otros televidentes

📋 Modelo de Datos

🍽️ Estructura de una Receta

📊 Campo	📝 Descripción	🔧 Tipo
🏷️ Título	Nombre de la receta	`String`
🥕 Ingredientes	Lista con cantidades y unidades	`List<Ingredient>`
👨‍🍳 Autor	Chef, participante o televidente	`Author`
📅 Temporada	Solo para recetas de participantes	`Integer`
📝 Pasos	Instrucciones ordenadas de preparación	`List<Step>`

👥 Tipos de Autores

🎭 Tipo	👤 Descripción	📺 Contexto
👨‍🍳 Chef Juez	`CHEF_JUDGE`	Chefs profesionales del programa
🏆 Participante	`PARTICIPANT`	Concursantes de las temporadas
📺 Televidente	`VIEWER`	Público general del programa

⚙️ Funcionalidades de la API

📝 Gestión de Recetas por Tipo de Autor

🟢 Crear	🔵 Consultar	🟡 Gestionar
➕ Registrar receta de televidente	📋 Listar todas las recetas	🔄 Actualizar receta
➕ Registrar receta de participante	🔍 Buscar receta por ID	🗑️ Eliminar receta
➕ Registrar receta de chef	📊 Filtrar por tipo de autor

🔍 Búsquedas Especializadas

🎯 Filtro	📋 Descripción	🔗 Endpoint
👨‍🍳 Por Chef	Solo recetas de chefs jueces	`GET /api/recetas/chefs`
🏆 Por Participante	Solo recetas de concursantes	`GET /api/recetas/participantes`
📺 Por Televidente	Solo recetas del público	`GET /api/recetas/televidentes`
📅 Por Temporada	Recetas de una temporada específica	`GET /api/recetas/temporada/{season}`
🥕 Por Ingrediente	Recetas que contienen un ingrediente	`GET /api/recetas/ingrediente/{ingredient}`

💡 Valor del Proyecto

🏗️ Para el Desarrollo Técnico

⚙️ Aspecto Técnico	✅ Implementación
🏗️ Arquitectura REST	API escalable y bien documentada
☁️ Despliegue en la Nube	Azure App Service con alta disponibilidad
🔄 CI/CD	Pipeline automatizado con GitHub Actions
🧪 Calidad	Pruebas unitarias y análisis de cobertura
📘 Documentación	Swagger UI para testing interactivo

Tecnologías Utilizadas

Tecnología / Herramienta	Uso en el proyecto
☕ Java 17	Lenguaje principal del backend
🌱 Spring Boot 3.x	Framework para crear la API REST
🔗 Spring Web	Controladores HTTP / endpoints
🍃 Spring Data MongoDB	Acceso y persistencia en MongoDB
🍃 MongoDB Atlas	Base de datos NoSQL alojada en la nube
🧠 Lombok	Reduce código repetitivo con anotaciones como `@Getter`, `@Setter`, `@Builder`
🧪 JUnit 5 / Mockito	Pruebas automatizadas
📊 JaCoCo	Reporte de cobertura de pruebas
🐳 Docker	Contenerización del servicio
☁️ Azure App Service	Hosting / despliegue en la nube
📦 Azure Container Registry (ACR)	Registry privado de imágenes Docker
🔁 GitHub Actions	CI/CD automatizado
📘 Swagger (OpenAPI 3)	Documentación interactiva de la API
🛡️ Spring Security (básico)	Seguridad del servicio (si aplica en esta versión)

Estructura del Proyecto

🏗️ Arquitectura General

📌 Patrón seguido: Controller → Service → Repository → MongoDB

🌐 Controller   ──➤   🔧 Service   ──➤   🗄️ Repository   ──➤   🍃 MongoDB Atlas
   (HTTP)              (Lógica)           (Persistencia)         (Base de Datos)

📂 Organización del Código

📁 src/main/java/edu/dosw/taller/
├── 📄 Application.java                    # 🚀 Clase principal Spring Boot
├── 📁 config/                            # ⚙️ Configuraciones globales (Swagger, seguridad, MongoDB)
├── 📁 controller/                        # 🌐 Controladores REST y manejo de excepciones
│   ├── 📁 dtos/                          # 📋 Data Transfer Objects para requests/responses
│   └── 📁 exception/                     # 🚨 Excepciones personalizadas y manejo global de errores
└── 📁 model/                             # 📊 Módulo de modelos y lógica de negocio
    ├── 📁 entities/                      # 📝 Entidades de dominio (Recipe, Author, Ingredient, etc.)
    ├── 📁 persistence/                   # 🗄️ Capa de persistencia y acceso a datos
    │   └── 📁 repository/                # 🔗 Interfaces de repositorios MongoDB
    └── 📁 services/                      # 🔧 Servicios de negocio e implementaciones

📁 src/test/java/edu/dosw/taller/
└── 📁 controller/                        # 🧪 Tests unitarios de controladores con @WebMvcTest

📁 src/main/resources/
└── 📄 application*.properties            # ⚙️ Configuraciones por ambiente (dev, prod, test)

📁 Archivos del proyecto raíz:
├── 📄 README.md                          # 📚 Documentación del proyecto
├── 📄 pom.xml                            # 🔧 Configuración Maven y dependencias
├── 📄 Dockerfile                         # 🐳 Configuración para contenerización
└── 📁 .github/workflows/                 # 🔁 Pipelines CI/CD (tests automáticos y despliegue)

Instalación y Ejecución Local

💡 Para ejecutar esta API localmente, seguir estos pasos paso a paso.

📋 Prerequisitos

Antes de comenzar, verificar que se tengan instalados:

Herramienta	Versión Mínima	Verificar instalación
☕ Java	17 o superior	`java -version`
🔧 Maven	3.6+	`mvn -version`
🐳 Docker (opcional)	20.10+	`docker --version`

📥 Paso 1: Descargar el proyecto

# Clonar el repositorio
git clone https://github.com/tu-usuario/Taller_MasterChef.git

# Entrar al directorio
cd Taller_MasterChef

🔧 Paso 2: Configurar la base de datos

Esta aplicación usa MongoDB Atlas (MongoDB en la nube). Es necesario configurar la conexión:

Opción A: Usar la base de datos del proyecto (para pruebas rápidas)

En Windows (PowerShell):

$env:MONGODB_URI="mongodb+srv://elizabethcorreas_db_user:WdbDQsGH6JYgkonX@masterchef.71qa5j4.mongodb.net/?appName=MasterChef"

En Windows (CMD):

set MONGODB_URI=mongodb+srv://elizabethcorreas_db_user:WdbDQsGH6JYgkonX@masterchef.71qa5j4.mongodb.net/?appName=MasterChef

En Linux/Mac:

export MONGODB_URI="mongodb+srv://elizabethcorreas_db_user:WdbDQsGH6JYgkonX@masterchef.71qa5j4.mongodb.net/?appName=MasterChef"

Opción B: Crear una base de datos MongoDB Atlas propia

Ir a MongoDB Atlas
Crear una cuenta gratuita
Crear un cluster gratuito
Obtener el connection string
Configurar la variable de entorno con la URL propia

▶️ Paso 3: Ejecutar la aplicación

Método 1: Con Maven (recomendado)

# Compilar y ejecutar
mvn spring-boot:run

Método 2: Con Docker

# Construir la imagen
docker build -t masterchef-api .

# Ejecutar el contenedor
docker run -p 8080:8080 \
  --env MONGODB_URI="el-connection-string-aquí" \
  masterchef-api

✅ Paso 4: Verificar funcionamiento

Si todo salió bien, se debería ver este mensaje en la consola:

Started Application in X.XXX seconds (JVM running for X.XXX)

Servicios disponibles:

🌐 Servicios	URL	Descripción
🏠 API Principal	`http://localhost:8080`	Página de inicio
📘 Documentación Swagger	`http://localhost:8080/swagger-ui/index.html`	Interfaz para probar la API
🍽️ Lista de Recetas	`http://localhost:8080/api/recetas`	JSON con las recetas
❤️ Health Check	`http://localhost:8080/actuator/health`	Estado: `{"status":"UP"}`

🧪 Paso 5: Probar la API

Opción A: Usar Swagger UI (más fácil)

Ir a http://localhost:8080/swagger-ui/index.html
Expandir cualquier endpoint (ej: POST /api/recetas/chef)
Hacer click en "Try it out"
Llenar los datos y presionar "Execute"

Opción B: Usar curl (línea de comandos)

# Crear una receta de prueba
curl -X POST "http://localhost:8080/api/recetas/chef" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Pasta Carbonara",
    "author": {
      "name": "Chef Mario",
      "type": "CHEF_JUDGE"
    },
    "ingredients": [
      {
        "name": "pasta",
        "quantity": "200 gramos",
        "unit": "gramos"
      }
    ],
    "steps": [
      {
        "order": 1,
        "description": "Hervir agua con sal"
      }
    ]
  }'

# Ver todas las recetas
curl http://localhost:8080/api/recetas

🆘 Problemas comunes

Problema	Posible causa	Solución
Error: Cannot connect to MongoDB	Variable de entorno mal configurada	Revisar el Paso 2
Error: Port 8080 already in use	Otro programa usa el puerto 8080	Detener proceso: `lsof -ti:8080 \| xargs kill -9`
Error: Java version	Versión incorrecta de Java	Instalar Java 17+
Maven not found	Maven no instalado	Instalar Maven o usar `./mvnw`

🔧 Ejecutar tests (opcional)

# Ejecutar todas las pruebas
mvn test

# Ver reporte de cobertura
mvn jacoco:report
# El reporte estará en: target/site/jacoco/index.html

🎉 Al completar estos pasos se tendrá la API de MasterChef ejecutándose localmente.

API Desplegada en Azure

🚀 ¡La API ya está funcionando en la nube!

📍 URL

🌐 Servicio	🔗 URL
📘 Swagger UI	`https://masterchef-container-gjeybrc4bqcpddhw.eastus2-01.azurewebsites.net/swagger-ui.html`

Endpoints (Request / Response)

📊 Documentación completa de todos los endpoints disponibles en la API

📸 Vista General de Endpoints

📋 Resumen de Endpoints

Método	Endpoint	Descripción
🟢 POST	`/api/recetas/chef`	Crear receta de chef juez
🟢 POST	`/api/recetas/participante`	Crear receta de participante del concurso
🟢 POST	`/api/recetas/televidente`	Crear receta de televidente
🔵 GET	`/api/recetas`	Obtener todas las recetas
🔵 GET	`/api/recetas/{id}`	Obtener receta específica por ID
🔵 GET	`/api/recetas/chefs`	Obtener recetas de chefs jueces
🔵 GET	`/api/recetas/participantes`	Obtener recetas de participantes
🔵 GET	`/api/recetas/televidentes`	Obtener recetas de televidentes
🔵 GET	`/api/recetas/temporada/{season}`	Obtener recetas por temporada
🔵 GET	`/api/recetas/ingrediente/{ingredient}`	Buscar recetas por ingrediente
🟡 PUT	`/api/recetas/{id}`	Actualizar receta existente
🔴 DELETE	`/api/recetas/{id}`	Eliminar receta por ID

📝 Detalles de cada Endpoint

🟢 POST /api/recetas/chef - Crear Receta de Chef

Request

{
  "title": "Pasta Carbonara Gourmet",
  "author": {
    "name": "Chef Mario Batali",
    "type": "CHEF_JUDGE"
  },
  "ingredients": [
    {
      "name": "pasta",
      "quantity": "200 gramos",
      "unit": "gramos"
    }
  ],
  "steps": [
    {
      "order": 1,
      "description": "Hervir agua con sal"
    }
  ]
}

Response

{
  "id": "507f1f77bcf86cd799439011",
  "title": "Pasta Carbonara Gourmet",
  "author": {
    "name": "Chef Mario Batali",
    "type": "CHEF_JUDGE"
  },
  "ingredients": [...],
  "steps": [...],
  "createdAt": "2023-12-15T10:30:00Z",
  "updatedAt": "2023-12-15T10:30:00Z"
}

🟢 POST /api/recetas/participante - Crear Receta de Participante

Request

{
  "title": "Tacos al Pastor Caseros",
  "author": {
    "name": "Ana García",
    "type": "PARTICIPANT"
  },
  "season": 3,
  "ingredients": [
    {
      "name": "carne de cerdo",
      "quantity": "500 gramos",
      "unit": "gramos"
    }
  ],
  "steps": [
    {
      "order": 1,
      "description": "Marinar la carne"
    }
  ]
}

Response

{
  "id": "507f1f77bcf86cd799439012",
  "title": "Tacos al Pastor Caseros",
  "author": {
    "name": "Ana García",
    "type": "PARTICIPANT"
  },
  "season": 3,
  "ingredients": [...],
  "steps": [...],
  "createdAt": "2023-12-15T11:00:00Z",
  "updatedAt": "2023-12-15T11:00:00Z"
}

🟢 POST /api/recetas/televidente - Crear Receta de Televidente

Request

{
  "title": "Galletas de Chocolate",
  "author": {
    "name": "María Rodríguez",
    "type": "VIEWER"
  },
  "ingredients": [
    {
      "name": "harina",
      "quantity": "300 gramos",
      "unit": "gramos"
    }
  ],
  "steps": [
    {
      "order": 1,
      "description": "Mezclar ingredientes"
    }
  ]
}

Response

{
  "id": "507f1f77bcf86cd799439013",
  "title": "Galletas de Chocolate",
  "author": {
    "name": "María Rodríguez",
    "type": "VIEWER"
  },
  "ingredients": [...],
  "steps": [...],
  "createdAt": "2023-12-15T12:00:00Z",
  "updatedAt": "2023-12-15T12:00:00Z"
}

🔵 GET /api/recetas - Obtener Todas las Recetas

Request

GET /api/recetas

Response

[
  {
    "id": "507f1f77bcf86cd799439011",
    "title": "Pasta Carbonara Gourmet",
    "author": {
      "name": "Chef Mario Batali",
      "type": "CHEF_JUDGE"
    },
    "ingredients": [...],
    "steps": [...],
    "createdAt": "2023-12-15T10:30:00Z",
    "updatedAt": "2023-12-15T10:30:00Z"
  },
  {
    "id": "507f1f77bcf86cd799439012",
    "title": "Tacos al Pastor",
    "author": {...},
    "season": 3,
    "ingredients": [...],
    "steps": [...]
  }
]

🔵 GET /api/recetas/{id} - Obtener Receta por ID

Request

GET /api/recetas/507f1f77bcf86cd799439011

Response (200 OK)

{
  "id": "507f1f77bcf86cd799439011",
  "title": "Pasta Carbonara Gourmet",
  "author": {
    "name": "Chef Mario Batali",
    "type": "CHEF_JUDGE"
  },
  "ingredients": [...],
  "steps": [...],
  "createdAt": "2023-12-15T10:30:00Z",
  "updatedAt": "2023-12-15T10:30:00Z"
}

Response (404 Not Found)

{
  "status": 404,
  "error": "Not Found",
  "message": "Receta no encontrada con ID: ...",
  "timestamp": "2023-12-15T15:30:00Z"
}

🔵 GET /api/recetas/temporada/{season} - Recetas por Temporada

Request

GET /api/recetas/temporada/3

Response

[
  {
    "id": "507f1f77bcf86cd799439012",
    "title": "Tacos al Pastor Caseros",
    "author": {
      "name": "Ana García",
      "type": "PARTICIPANT"
    },
    "season": 3,
    "ingredients": [...],
    "steps": [...],
    "createdAt": "2023-12-15T11:00:00Z",
    "updatedAt": "2023-12-15T11:00:00Z"
  }
]

🔵 GET /api/recetas/ingrediente/{ingredient} - Buscar por Ingrediente

Request

GET /api/recetas/ingrediente/pasta

Response

[
  {
    "id": "507f1f77bcf86cd799439011",
    "title": "Pasta Carbonara Gourmet",
    "author": {
      "name": "Chef Mario Batali",
      "type": "CHEF_JUDGE"
    },
    "ingredients": [
      {
        "name": "pasta",
        "quantity": "200 gramos",
        "unit": "gramos"
      }
    ],
    "steps": [...],
    "createdAt": "2023-12-15T10:30:00Z",
    "updatedAt": "2023-12-15T10:30:00Z"
  }
]

🟡 PUT /api/recetas/{id} - Actualizar Receta

Request

PUT /api/recetas/507f1f77bcf86cd799439011

{
  "title": "Pasta Carbonara Actualizada",
  "author": {
    "name": "Chef Mario Batali",
    "type": "CHEF_JUDGE"
  },
  "ingredients": [
    {
      "name": "pasta integral",
      "quantity": "250 gramos",
      "unit": "gramos"
    }
  ],
  "steps": [
    {
      "order": 1,
      "description": "Usar pasta integral"
    }
  ]
}

Response

{
  "id": "507f1f77bcf86cd799439011",
  "title": "Pasta Carbonara Actualizada",
  "author": {
    "name": "Chef Mario Batali",
    "type": "CHEF_JUDGE"
  },
  "ingredients": [...],
  "steps": [...],
  "createdAt": "2023-12-15T10:30:00Z",
  "updatedAt": "2023-12-15T16:45:00Z"
}

🔴 DELETE /api/recetas/{id} - Eliminar Receta

Request

DELETE /api/recetas/507f1f77bcf86cd799439011

Response (204 No Content)

(No Content - Eliminación exitosa)

Response (404 Not Found)

{
  "status": 404,
  "error": "Not Found",
  "message": "No se puede eliminar. Receta no encontrada con ID: ...",
  "timestamp": "2023-12-15T17:00:00Z"
}

📊 Códigos de Estado HTTP

Código	Descripción	Cuándo ocurre
200	✅ OK	Operación exitosa (GET, PUT)
201	✅ Created	Receta creada exitosamente (POST)
204	✅ No Content	Receta eliminada exitosamente (DELETE)
400	❌ Bad Request	Datos inválidos en el request
404	❌ Not Found	Receta no encontrada
500	❌ Internal Server Error	Error interno del servidor

Testing y Calidad

🎯 Garantizando la calidad del código mediante pruebas automatizadas y análisis de cobertura.

🔬 Tipos de Pruebas Implementadas

🧪 Tipo de Prueba	📂 Capa	🛠️ Herramientas	📋 Qué se prueba
🎯 Unitarias	Controladores	JUnit 5 + Mockito + @WebMvcTest	Endpoints HTTP, validaciones, respuestas
🔧 Unitarias	Servicios	JUnit 5 + Mockito	Lógica de negocio, manejo de excepciones

✅ Evidencia de Pruebas logradas

📊 Cobertura con JaCoCo

📈 Medición de cobertura de código para asegurar que las pruebas cubren la funcionalidad implementada.

🎯 Métricas de Cobertura

📊 Métrica	🎯 Objetivo	✅ Alcanzado	📈 Estado
Líneas de Código	> 80%	92%	✅ Excelente
Branches	> 70%	66%	⚠️ Cerca del objetivo
Métodos	> 80%	100%	✅ Perfecto
Clases	> 90%	100%	✅ Perfecto

📊 Cobertura General: 92% - Excelente calidad de pruebas

Despliegue y CI/CD en Azure

🚀 Despliegue automatizado usando GitHub Actions + Azure App Service con contenedores Docker.

🔄 Flujo de CI/CD

graph LR
    A[📝 Push to main] --> B[🔄 GitHub Actions]
    B --> C[🔨 Build Maven]
    C --> D[🧪 Run Tests]
    D --> E[📊 JaCoCo Report]
    E --> F[🐳 Build Docker]
    F --> G[📦 Push to ACR]
    G --> H[🚀 Deploy to Azure]
    H --> I[✅ Production Ready]

📋 Pipeline Detallado

🔢 Paso	🛠️ Acción	⏱️ Duración	📋 Descripción
1	📥 Checkout	~10s	Descarga código fuente
2	☕ Setup JDK 17	~20s	Configura entorno Java
3	🔨 Maven Build	~2m	Compila y empaqueta aplicación
4	🧪 Run Tests	~1m	Ejecuta pruebas unitarias
5	📊 JaCoCo Report	~15s	Genera reporte de cobertura
6	🐳 Docker Build	~3m	Construye imagen Docker
7	🔐 ACR Login	~5s	Autenticación en Azure Container Registry
8	📦 Docker Push	~2m	Publica imagen en ACR
9	🚀 Azure Deploy	~1m	Despliega contenedor en Azure App Service

✅ Evidencia de Despliegue Exitoso

🔄 GitHub Actions - Pipeline Exitoso

☁️ Azure App Service - Aplicación Desplegada

📦 Azure Container Registry - Imagen Publicada

🏗️ Infraestructura en Azure

🧩 Componente	📋 Servicio Azure	💰 Tier	🎯 Función
🌐 Web App	Azure App Service (Linux)	B1 Basic	Hosting de la aplicación Spring Boot
🍃 Base de Datos	MongoDB Atlas	M0 Free	Almacenamiento de recetas
📦 Container Registry	Azure Container Registry	Basic	Registry privado de imágenes Docker
🔄 CI/CD	GitHub Actions	Free	Pipeline de despliegue automático

🔧 Variables de Entorno en Producción

🌍 Variable	📋 Descripción	🔒 Configurada en
`MONGODB_URI`	Conexión a MongoDB Atlas	Azure App Service Settings
`SPRING_PROFILES_ACTIVE`	Perfil activo (prod)	Azure App Service Settings
`ACR_LOGIN_SERVER`	URL del Container Registry	GitHub Secrets
`ACR_USERNAME`	Usuario ACR	GitHub Secrets
`ACR_PASSWORD`	Contraseña ACR	GitHub Secrets

Autor y Créditos

👩‍💻 Desarrollado por:

Elizabeth Correa Suárez
🎓 Estudiante de Ingeniería de Sistemas
🏛️ Escuela Colombiana de Ingeniería Julio Garavito
📚 Curso: Desarrollo y Operaciones de Software (DOSW) – 2025-1

Name		Name	Last commit message	Last commit date
Latest commit History 22 Commits
.github/workflows		.github/workflows
.mvn/wrapper		.mvn/wrapper
docs/imagenes		docs/imagenes
src		src
target		target
.gitattributes		.gitattributes
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
docker-compose.yml		docker-compose.yml
pom.xml		pom.xml

Eliza-05/Taller_MasterChef

Folders and files

Latest commit

History

Repository files navigation

🍽️ Taller MasterChef — API de Gestión de Recetas

🛠️ Stack Tecnológico

📑 Tabla de Contenidos

📋 Navegación Detallada:

Descripción del Proyecto

🎯 Caso de Estudio: MasterChef Celebrity

📺 Contexto del Proyecto

📋 Modelo de Datos

🍽️ Estructura de una Receta

👥 Tipos de Autores

⚙️ Funcionalidades de la API

📝 Gestión de Recetas por Tipo de Autor

🔍 Búsquedas Especializadas

💡 Valor del Proyecto

🏗️ Para el Desarrollo Técnico

Tecnologías Utilizadas

Estructura del Proyecto

🏗️ Arquitectura General

📂 Organización del Código

Instalación y Ejecución Local

📋 Prerequisitos

📥 Paso 1: Descargar el proyecto

🔧 Paso 2: Configurar la base de datos

Opción A: Usar la base de datos del proyecto (para pruebas rápidas)

Opción B: Crear una base de datos MongoDB Atlas propia

▶️ Paso 3: Ejecutar la aplicación

Método 1: Con Maven (recomendado)

Método 2: Con Docker

✅ Paso 4: Verificar funcionamiento

🧪 Paso 5: Probar la API

Opción A: Usar Swagger UI (más fácil)

Opción B: Usar curl (línea de comandos)

🆘 Problemas comunes

🔧 Ejecutar tests (opcional)

API Desplegada en Azure

📍 URL

Endpoints (Request / Response)

📸 Vista General de Endpoints

📋 Resumen de Endpoints

📝 Detalles de cada Endpoint

🟢 POST /api/recetas/chef - Crear Receta de Chef

Request

Response

🟢 POST /api/recetas/participante - Crear Receta de Participante

Request

Response

🟢 POST /api/recetas/televidente - Crear Receta de Televidente

Request

Response

🔵 GET /api/recetas - Obtener Todas las Recetas

Request

Response

🔵 GET /api/recetas/{id} - Obtener Receta por ID

Request

Response (200 OK)

Response (404 Not Found)

🔵 GET /api/recetas/temporada/{season} - Recetas por Temporada

Request

Response

🔵 GET /api/recetas/ingrediente/{ingredient} - Buscar por Ingrediente

Request

Response

🟡 PUT /api/recetas/{id} - Actualizar Receta

Request

Response

🔴 DELETE /api/recetas/{id} - Eliminar Receta

Request

Response (204 No Content)

Response (404 Not Found)

📊 Códigos de Estado HTTP

Testing y Calidad

🔬 Tipos de Pruebas Implementadas

✅ Evidencia de Pruebas logradas

📊 Cobertura con JaCoCo

🎯 Métricas de Cobertura

Packages