Generazione Ricetta con AI per Prodotti Finiti

Panoramica

Implementata funzionalità di generazione automatica di ricette per prodotti finiti usando intelligenza artificiale, basata su pattern di prodotti simili e ingredienti disponibili.

Funzionalità

Pulsante “Crea ricetta con AI”

• Posizione: Card “Ricetta AI” nella sidebar destra delle pagine di aggiunta e modifica prodotto finito
• Requisiti: Categoria e nome prodotto devono essere selezionati/inseriti
• Icona: Sparkles (✨)

Logica di Generazione

1. Pattern Matching (con prodotti simili)

Quando esistono prodotti nella stessa categoria:

• Analizza fino a 5 prodotti simili nella categoria selezionata
• Estrae pattern comuni (numero ingredienti, proporzioni, metodi cottura)
• Genera ricetta seguendo il pattern usando SOLO ingredienti disponibili nel magazzino
• Calcola automaticamente i food cost basandosi sui prezzi degli ingredienti

2. Fallback (senza prodotti simili)

Quando NON esistono prodotti simili:

• Genera ricetta da zero basandosi sul nome del prodotto
• Usa creatività dell’AI ma mantiene realismo professionale
• Seleziona ingredienti appropriati dal magazzino
• Include nota che la ricetta è stata generata senza riferimenti

Dettagli Implementazione

API Endpoint

Route: /api/ai/generate-recipe

• Metodo: POST
• Parametri:
  • categoryId: ID della categoria del prodotto
  • productName: Nome del prodotto da creare
• Risposta:
  • recipe: Array di ingredienti con quantità, unità, food cost, dettagli cottura
  • reasoning: Spiegazione delle scelte fatte dall’AI
  • hasSimilarProducts: Indica se sono stati trovati prodotti simili
  • similarProductsCount: Numero di prodotti simili analizzati

Componente UI

File: src/components/RecipeAIButton/RecipeAIButton.tsx

• Dialog di conferma con preview della ricetta generata
• Mostra spiegazione dell’AI
• Mostra tutti gli ingredienti con quantità e dettagli cottura
• Distintivo visivo se generato con/senza pattern

Integrazione Pagine

Pagine modificate:

1. src/app/(dashboard)/prodotti-finiti/aggiungi/page.tsx
2. src/app/(dashboard)/prodotti-finiti/[product]/edit/page.tsx

Funzionalità aggiunte:

• Nuova card “Ricetta AI” nella sidebar
• Handler handleRecipeGenerated che:
  • Popola automaticamente gli ingredienti
  • Configura dettagli di cottura
  • Aggiorna food cost totale
  • Salva reasoning per riferimento

Informazioni Incluse nella Ricetta

Per ogni ingrediente:

• product_id: ID del prodotto dal magazzino
• product_name: Nome ingrediente
• quantity: Quantità necessaria
• unit: Unità di misura
• foodCost: Costo calcolato automaticamente
• requiresCooking: Se richiede cottura
• cookingMethod: Metodo di cottura (es. “Frittura”)
• cookingTime: Tempo in minuti
• equipment: Attrezzatura da usare (opzionale)
• employee: Dipendente assegnato (opzionale)

Modello AI Utilizzato

• OpenAI GPT-4o per generazione ricette
• Temperature bassa (0.3) per pattern matching - maggiore precisione
• Temperature media (0.5) per generazione da zero - più creatività

Esperienza Utente

1. Utente seleziona categoria e inserisce nome prodotto
2. Clicca “Crea ricetta con AI”
3. Sistema:
   • Cerca prodotti simili nella categoria
   • Raccoglie ingredienti disponibili
   • Genera ricetta con AI
4. Mostra dialog di conferma con:
   • Indicazione se usato pattern o generato da zero
   • Spiegazione delle scelte
   • Lista completa ingredienti
5. Su conferma:
   • Popola automaticamente la form ricetta
   • Configura dettagli cottura
   • Mostra messaggio di successo con reasoning

Note Tecniche

• Calcolo Food Cost: Automatico basato su quantità e costo unitario dal magazzino
• Validazione: Solo ingredienti effettivamente disponibili nel magazzino
• Limite Prodotti Simili: Massimo 5 prodotti per analisi pattern
• Limite Ingredienti Disponibili: Primi 100 mostrati nel prompt (ottimizzazione token)
• Gestione Errori: Toast di errore e log dettagliati

Possibili Miglioramenti Futuri

1. Cache Pattern: Memorizzare pattern comuni per categoria
2. Apprendimento: Migliorare suggerimenti basandosi su ricette confermate
3. Varianti: Generare multiple varianti tra cui scegliere
4. Costi: Ottimizzazione automatica per target food cost
5. Stagionalità: Considerare disponibilità stagionale ingredienti
6. Allergeni: Gestione automatica allergeni e preferenze dietetiche