> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.haddock.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Generación de platos con IA

La herramienta de generación de platos con IA lee tus cartas, fichas de receta o exportaciones de TPV y las convierte en platos y preparaciones dentro de haddock. Extrae el nombre del plato, su tipo, el precio, los ingredientes, cantidades y unidades y, cuando es posible, asocia cada ingrediente a un producto que ya tienes en tu cuenta.

Este artículo explica qué hace la herramienta, cómo funciona internamente y cómo utilizarla.

## Qué hace

A partir de una sola subida, la herramienta genera platos en borrador que incluyen:

- **Nombre del plato, tipo** (plato, preparación, modificador o combo), **sección/etiqueta** y **precio de venta** cuando aparece en el documento.
- **Lista de ingredientes** con nombre, cantidad, unidad (g, kg, ml, l, uds) y un producto sugerido del catálogo de tu cuenta.
- **Información de rendimiento** (masa total y número de porciones) en las recetas.
- **Subpreparaciones**, ordenadas para que cualquier preparación referenciada por otra se cree primero.
- **Slots de combo** para platos combinados con opciones.
- **Alérgenos**, heredados de los productos asociados.
- **Una imagen del plato generada automáticamente** en segundo plano.
- **Una puntuación de confianza** (alta, media, baja) y la acción prevista (crear nuevo o actualizar existente) para cada borrador.

## Formatos admitidos

| Tipo | Formatos | Caso de uso |
|------|----------|-------------|
| Imágenes | PNG, JPEG, WebP | Fotos de cartas impresas o fichas de receta |
| Documentos | PDF, DOCX | Cartas digitales, recetarios, fichas de proveedor |
| Hojas de cálculo | XLSX | Matrices de receta y fichas de coste |

**Límites**

- Tamaño máximo por archivo: 25 MB.
- Tamaño máximo agregado: 100 MB por trabajo de importación.
- Máximo de archivos por trabajo: 10.
- Idiomas: multilingüe. La extracción funciona de forma nativa en español, inglés, francés y otros idiomas.
- Tiempo de procesado: las cartas pequeñas (hasta ~25 platos) suelen estar listas en 2–4 minutos. Los archivos más grandes tardan aproximadamente 1 minuto por cada 10 platos: unos 100 platos rondan los 10–15 minutos, y varios cientos de platos pueden acercarse a una hora. El trabajo se ejecuta de forma asíncrona, así que puedes cerrar la pantalla y volver más tarde. Si tienes un Excel muy grande, dividirlo en lotes más pequeños facilita la revisión posterior.

## Cómo funciona

1. **Subida.** Los archivos se envían en una única petición multipart y se validan contra los límites de formato y tamaño.
2. **Extracción.** Cada archivo se procesa en paralelo (hasta tres a la vez) con Google Gemini. Las imágenes y los PDF pasan por una pipeline de visión, las hojas de cálculo se analizan hoja por hoja y los documentos de Word se leen como texto. El modelo devuelve un borrador JSON estructurado por cada plato detectado.
3. **Asociación de ingredientes.** Para cada ingrediente extraído, el sistema realiza una búsqueda difusa contra los productos de tu cuenta y contra el catálogo global. Las coincidencias por encima del umbral de similitud se asocian automáticamente; las más débiles se ofrecen como sugerencia para que las confirmes.
4. **Generación de imagen.** Se genera una foto del plato en una tarea en segundo plano y se adjunta al borrador cuando está lista.
5. **Revisión.** Todos los borradores se presentan en una pantalla de revisión. Puedes editar cualquier campo, cambiar las asociaciones, eliminar borradores o aceptarlos tal cual.
6. **Confirmación.** Al confirmar, cada borrador se guarda aplicando la lógica de upsert que se describe a continuación.

## Cómo funciona el guardado (upsert)

Los platos nunca se sobrescriben. Para cada borrador, haddock busca un plato existente con el mismo nombre (sin distinguir mayúsculas y eliminando espacios) y decide si crearlo o actualizarlo.

- Si no existe ningún plato con ese nombre, se **crea** uno nuevo con los ingredientes y los datos extraídos.
- Si ya existe un plato con ese nombre, se **actualiza** con la nueva información.

La actualización es puramente **aditiva** sobre los ingredientes:

- Los ingredientes nuevos detectados por la IA se **añaden** al plato existente.
- Si un ingrediente ya existente se detecta de nuevo con una **cantidad** o **unidad** distinta, ambos campos se **actualizan**.
- Si un ingrediente que ya estaba en el plato **no** aparece en la nueva extracción, se **mantiene**. Reimportar nunca elimina ingredientes.

Este comportamiento protege las ediciones manuales, los ingredientes personalizados y las cantidades que tu equipo haya configurado. Cualquier ingrediente que quieras eliminar debe borrarse explícitamente desde el plato.

## Paso a paso

1. Abre la sección de **Platos** o **Preparaciones**. Desde el estado vacío, la barra de herramientas del listado o el checklist de activación, pulsa **Importar con IA**. Si hay un trabajo anterior en curso, el botón lo retoma.
2. En la pantalla del generador, **arrastra los archivos** a la zona de subida o usa **Examinar** o **Hacer foto** para añadirlos. Puedes mezclar imágenes, PDF y hojas de cálculo en el mismo trabajo.
3. Confirma la subida. El trabajo arranca y muestra el progreso por archivo. Puedes salir de la pantalla; la URL incluye un `jobId` al que puedes volver.
4. Cuando la extracción termina, la **pantalla de revisión** muestra cada plato en borrador con sus ingredientes, las sugerencias de asociación, la puntuación de confianza y la acción prevista (crear o actualizar).
5. Edita los campos que necesiten ajuste: nombre del plato, tipo, precio, cantidad o unidad de cada ingrediente, producto asociado, alérgenos.
6. Pulsa **Confirmar** para guardar los borradores seleccionados en tu cuenta. Los platos creados aparecen en el listado; los actualizados muestran el conjunto de ingredientes resultante de la fusión.

## Resultados parciales y errores

- Si la extracción produce resultados parciales (por ejemplo, se reconocen tres de cinco platos), los borradores reconocidos se muestran junto a un aviso que indica qué se ha omitido y por qué.
- Si un archivo no se puede leer o su salida es inválida, se omite y se notifica en los avisos.
- Si el trabajo falla por completo, puedes volver a lanzar la importación; los borradores ya confirmados no se ven afectados.

## Buenas prácticas

- Sube imágenes **claras y en alta resolución**. Las fotos frontales, con la carta completa visible y buena iluminación, dan los mejores resultados.
- Divide las cartas muy grandes en lotes de hasta diez archivos para respetar los límites del trabajo.
- Revisa la **puntuación de confianza** antes de confirmar. Los borradores de baja confianza merecen una segunda mirada.
- Para platos que ya tienes creados manualmente, la importación los **actualizará** en lugar de duplicarlos. Verifica los ingredientes fusionados después de la primera ejecución.

---