# PlayForEat — Guida alla Revisione Clinica & Scientifica per Nutrizionisti e Dietisti *Autore: Senior Clinical Bioinformatician & Nutritional Biochemist, Team PlayForEat* *Versione Specifica: v6.0 Alignment — Standard di Validazione Clinica e Bioinformatica* --- ## 1. Executive Summary — Il Nuovo Paradigma del Meal Planning Clinico Nel panorama contemporaneo delle tecnologie per la nutrizione e la dietetica applicata, la generazione di piani alimentari personalizzati si scontra storicamente con un trilemma insoluto: **precisione analitica dei nutrienti**, **fattibilità culinaria reale** e **sicurezza clinico-allergologica assoluta**. I paradigmi tradizionali e le recenti applicazioni basate sull'Intelligenza Artificiale generativa falliscono sistematicamente nel soddisfare simultaneamente questi tre requisiti: 1. **Grandi Modelli Linguistici (LLM generativi puri)**: I modelli linguistici operano su distribuzioni probabilistiche di token linguistici e non possiedono un modello di computazione aritmetica né la nozione di conservazione della massa. Quando un LLM genera una dieta, inventa valori calorici o grammature per conformità sintattica (*allucinazione nutrizionale*). Un errore tipico consiste nel dichiarare 500 kcal per una ricetta i cui singoli ingredienti sommati ammontano a 780 kcal, oppure nell'omettere la presenza di tracce di allergeni per compiacere il prompt dell'utente, introducendo **gravi rischi anafilattici e tossicologici**. 2. **Algoritmi Genetici ed Euristici (Metaeuristiche continue)**: Gli algoritmi evolutivi o le discese di gradiente operano su spazi di ricerca continui. Essi tendono a bloccarsi in minimi locali e non possono fornire alcuna **garanzia di ottimalità globale** né una **certificazione formale di infattibilità (*infeasibility proof*)**. Inoltre, generano grammature matematicamente continue ma biologicamente e gastronomicamente assurde (es. $13.7\text{ g}$ di uovo, $0.23$ spicchi d'aglio, $1.4\text{ g}$ di petto di pollo), distruggendo l'aderenza del paziente. 3. **Template Statici e Menu Fissi a Rotazione**: I classici schemi dietetici cartacei o software basati su tabelle fisse risultano totalmente anelastici. Non tengono conto dell'inventario domestico reale, della spesa commerciale a confezioni discrete, delle fluttuazioni glicemiche/energetiche e provocano un tasso di abbandono (*dietary drop-out*) superiore al 70% entro i primi 30 giorni a causa della monotonia sensoriale e dello spreco economico. ``` CONFRONTO DEI PARADIGMI COMPUTAZIONALI IN DIETETICA CLINICA Paradigma Precisione Nutrizionale Sicurezza Allergeni Fattibilità Culinaria Spiegabilità ────────────────────────────────────────────────────────────────────────────────────────────────────────── LLM Generativi Bassa (Allucinazioni) Inaffidabile Variabile Bassa (Black-box) Algoritmi Genetici Media (Approssimata) Probabilistica Scarsa (Frazioni assurde) Media Template Statici Rigida/Teorica Manuale Rigida (Abbandono) Alta PlayForEat (CP-SAT) 100% Deterministica Certificata (Hard) Ottimale (Discreta) Totale (Matematica) ``` ### La Scelta Architetturale di PlayForEat: Programmazione a Vincoli Discreti (OR-Tools CP-SAT) PlayForEat adotta un approccio rigorosamente bioinformatico, fondato sul solutore a vincoli interi **Google OR-Tools CP-SAT** (*Constraint Programming with Boolean Satisfiability*). In questo modello: * **La Nutrizione è Matematica Deterministica**: Nessun calcolo calorico o di micronutrienti viene delegato a modelli stocastici. Ogni valore deriva da database composizionali accreditati (**Ciqual 2025 ANSES** e **USDA FoodData Central**). * **Lo Spazio delle Decisioni è Discreto**: Il motore seleziona combinazioni discrete di candidati culinari precompilati ($x_{d,s,c} \in \{0, 1\}$), dove ogni variante di porzione rispetta le regole di consistenza chimico-fisica degli alimenti e il formato reale di vendita degli ingredienti. * **I Vincoli Fisiologici e di Sicurezza sono Rigidi (*Hard Constraints*)**: Se il fabbisogno impone una tolleranza massima di sodio, l'esclusione del glutine, o il limite settimanale su carni rosse e pesce, il solutore esplora l'intero spazio combinatorio fornendo una soluzione matematicamente certificata o dimostrando l'incompatibilità dei vincoli, indicando al clinico la causa esatta del conflitto. --- ## 2. Principi Clinici Garantiti al 100% PlayForEat è ingegnerizzato attorno a cinque postulati biochimici e clinici non negoziabili: ### 2.1 Conservazione Deterministica dei Nutrienti ($\sum$ Lineare Esatta) L'energia metabolizzabile totale e i macronutrienti di ogni pasto corrispondono esattamente alla somma ponderata dei nutrienti dei singoli ingredienti allo stato crudo di riferimento: $$ \text{Energia Pasto (kcal)} = \sum_{i=1}^{n} \left( \frac{W_{\text{raw}, i}}{100} \cdot \text{Kcal}_{100\text{g}, i} \right) $$ Nessun fattore di scala arbitrario viene applicato a posteriori. La somma dei macronutrienti rispetta la consistenza dei fattori di Atwater standard ($4\text{ kcal/g}$ per proteine e carboidrati disponibili, $9\text{ kcal/g}$ per i lipidi, $2\text{ kcal/g}$ per le fibre alimentari solubili fermentescibili). ### 2.2 Eliminazione degli Errori di Scalatura Continua (*Zero Continuous Scaling Errors*) Nella dietetica classica, moltiplicare una ricetta per un coefficiente arbitrario (es. $1.38\times$) produce anomalie culinarie che compromettono la biochimica della preparazione (es. quantità eccessive di sale, alterazione dell'attività dell'acqua $a_w$, bruciatura dei grassi di conduzione o diluizione enzimatica). PlayForEat introduce le **Scaling Policies**: * **`FIXED`**: Ingredienti a massa costante (sale, spezie, emulsionanti). * **`BOUNDED`**: Ingredienti continui ma con limiti rigidi e scatti di pesata realistici (es. $\Delta = 10\text{g}$ per la pasta o il riso). * **`DISCRETE`**: Ingredienti vincolati alle unità indivisibili naturali (es. uova intere con $\Delta = 55\text{g}$, fette di pane da $30\text{g}$, confezioni monouso). ### 2.3 Sicurezza Allergene Assoluta (Zero-Tolerance Allergen Containment) La protezione del paziente atopico o celiaco è implementata come un predicato booleano nel compilatore e nel solutore. Indicando con $\mathcal{A}_{\text{user}}$ l'insieme degli allergeni diagnosticati al paziente e con $\mathcal{A}_{\text{recipe}}$ l'unione di tutti gli allergeni presenti negli ingredienti di un candidato: $$ \mathcal{A}_{\text{candidate}} = \bigcup_{i \in \text{Ingredients}} \mathcal{A}(\text{Food}_i) $$ $$ \text{Vincolo Hard}: \quad \mathcal{A}_{\text{candidate}} \cap \mathcal{A}_{\text{user}} = \emptyset \quad \forall \text{ candidate selezionato} $$ Se un candidato viola anche solo per un ingrediente secondario l'intersezione nulla, esso viene escluso a monte (*pruning deterministico*) prima della formulazione del modello di ottimizzazione. ### 2.4 Dinamica Energetica "Rolling" Non Compensatoria I protocolli dietetici tradizionali spesso impongono restrizioni caloriche drastiche nel giorno successivo a un eccesso alimentare spontaneo del paziente. Dal punto di vista neuroendocrino, una restrizione compensatoria acuta stimola la secrezione di grelina e cortisolo, deprime la leptina circolante e innesca abbuffate compulsive (*binge-eating cycle*). PlayForEat implementa un **Rolling Energy Balance** a finestra mobile su $10$ giorni: il recupero di un eventuale surplus o deficit non avviene in 24 ore, ma viene distribuito in modo asintotico e impercettibile ($\le 5-10\%$ del TDEE giornaliero), preservando il tasso metabolico basale e l'aderenza psicologica. ### 2.5 Tracciabilità e Provenienza del Dato (*Data Provenance & Traceability*) Ogni microgrammo di micronutriente e grammo di macro è mappato sul codice identificativo univoco della banca dati di origine: * **Ciqual 2025** (Agence nationale de sécurité sanitaire de l'alimentation, de l'environnement et du travail — ANSES, Francia). * **USDA FoodData Central** (Agricultural Research Service, USA). --- ## 3. Mappa della Suite Documentale per Nutrizionisti La documentazione clinica di PlayForEat è strutturata in 4 trattati specialistici interconnessi. ```mermaid graph TD INDEX["Indice Generale
(index.md)"] --> DATA["Modalità e Modello Dati
(data_model.md)"] INDEX --> OPT["Ottimizzazione CP-SAT
(optimization_model.md)"] INDEX --> CLIN["Crononutrizione e Fisiologia
(clinical_features_and_heuristics.md)"] DATA --> D1["Architettura a 3 Layer"] DATA --> D2["Ciqual 2025 e USDA FDC"] DATA --> D3["Tassonomia 8 Famiglie Proteiche"] DATA --> D4["Tassonomia 9 Fonti Carboidrati"] DATA --> D5["Tassonomia ~35 Subcategorie Alimentari"] DATA --> D6["Pacchetti Nutrizionali e Budget Grammi"] DATA --> D7["Target DRV Micronutrienti EFSA"] OPT --> O1["13 Hard Constraints Clinici"] OPT --> O2["24 Termini Funzione Obiettivo"] OPT --> O3["Budget Categoria Constraint"] OPT --> O4["Incompatibilità Giornaliera"] OPT --> O5["DRV Floor e Ceiling Penalty"] OPT --> O6["5-Tier Relaxation Cascade"] CLIN --> C1["5 Finestre Circadiane Pasti"] CLIN --> C2["Modulazione Glicemica"] CLIN --> C3["Biodiversità Microbiota"] CLIN --> C4["Sinergie Assorbimento DRV"] CLIN --> C5["Feedback Calorico da Trend Peso"] ``` 1. [`docs/nutritionist/index.md`](file:///c:/Users/aless/Desktop/manera/ilstudio-playforeat/docs/nutritionist/index.md): Panoramica clinica, postulati non negoziabili e checklist formale per l'audit specialistico. 2. [`docs/nutritionist/data_model.md`](file:///c:/Users/aless/Desktop/manera/ilstudio-playforeat/docs/nutritionist/data_model.md): Trattato sul modello dati a 3 Layer, convenzione Null-Means-Unknown, tassonomia delle 8 famiglie proteiche, 9 fonti di carboidrati e ~35 subcategorie alimentari, fattori di resa ($Y_f$) e ritenzione ($R_{f,m}$), scaling policies, EFSA 14 allergen system, pacchetti nutrizionali e marketplace. 3. [`docs/nutritionist/optimization_model.md`](file:///c:/Users/aless/Desktop/manera/ilstudio-playforeat/docs/nutritionist/optimization_model.md): Formulazione matematica rigorosa del solutore CP-SAT, 13 Vincoli Clinici Hard (inclusi cap pesce, quote legumi/pollame, collisioni intra-giornaliere, budget categoria, incompatibilità giornaliera e DRV floor) e Funzione Obiettivo Multi-Criterio a 24 Termini ($\Phi_1 \dots \Phi_{24}$). 4. [`docs/nutritionist/clinical_features_and_heuristics.md`](file:///c:/Users/aless/Desktop/manera/ilstudio-playforeat/docs/nutritionist/clinical_features_and_heuristics.md): Fisiologia metabolica applicata, crononutrizione dei 5 pasti (colazione, spuntino mattina, pranzo, merenda pomeriggio, cena), controllo del carico glicemico, dinamica energetica rolling post-deviazione, sinergie e antagonismi per assorbimento DRV micronutrienti, e feedback calorico dal trend ponderale. --- ## 4. Checklist Operativa di Audit Clinico (Clinical Audit Checklist) Questa checklist è concepita per consentire al medico dietologo, biologo nutrizionista o dietista clinico di revisionare, validare o sottoporre ad audit formale i piani generati dal motore PlayForEat prima della somministrazione al paziente. ### Sezione 1: Sicurezza Tossicologica e Reattività Immunologica - [ ] **Esclusione Allergeni EFSA 14**: Verificare che l'intersezione tra gli allergeni censiti nel profilo utente e gli ingredienti di ciascun pasto sia rigorosamente nulla ($\mathcal{A}_{\text{cand}} \cap \mathcal{A}_{\text{user}} = \emptyset$). - [ ] **Cross-Reattività e Tracce Nascoste**: Nei pazienti con celiachia o allergie severe alle IgE, assicurarsi che i cibi trasformati abbiano certificazione di assenza di contaminazione crociata industriale. - [ ] **Tossicità da Sovradosaggio di Micronutrienti**: Verificare che l'apporto settimanale cumulativo di micronutrienti liposolubili (Vitamina A, D, E) o minerali pesanti (Zinco, Selenio, Ferro) non superi i Limiti Massimi Tollerabili di Assunzione (*Tolerable Upper Intake Levels* — UL stabiliti da EFSA/SINU). ### Sezione 2: Fisiologia Energetica e Distribuzione dei Macronutrienti - [ ] **Bilancio Calorico e TDEE**: Verificare che il target calorico medio sulle 24 ore e sulla finestra mobile dei 10 giorni sia coerente con l'indice di massa corporea (BMI), la massa magra (FFM) e il livello di attività fisica (PAL). - [ ] **Apporto e Qualità Proteica**: Controllare che il fabbisogno proteico sia distribuito uniformemente tra i pasti principali ($0.3 - 0.4\text{ g/kg peso corporeo per pasto}$ per massimizzare la sintesi proteica muscolare m-TOR) con adeguata presenza di amminoacidi ramificati (BCAA/Leucina). - [ ] **Densità e Tipologia dei Carboidrati**: Accertarsi che la quota di zuccheri semplici liberi (*free sugars*) non ecceda il 10% (o 5% per pazienti dismetabolici) dell'energia totale giornaliera e che la fibra alimentare rispetti i $\ge 25-35\text{ g/die}$ con opportuno rapporto solubile/insolubile ($1:3$). - [ ] **Composizione Lipidica**: Verificare che gli acidi grassi saturi (SFA) siano $< 10\%$ dell'introito calorico totale ($< 7\%$ in dislipidemie), favorendo acidi grassi monoinsaturi (MUFA, acido oleico da olio EVO) e polinsaturi essenziali (PUFA $\omega-3/\omega-6$). ### Sezione 3: Micronutrienti, Ritenzione Termica e Biodisponibilità - [ ] **Applicazione Fattori di Ritenzione ($R_{f,m}$)**: Verificare che le vitamine idrosolubili termolabili (Vitamina C, Acido Folico, Tiamina) siano state decurtate in base al metodo di cottura applicato (bollitura vs vapore vs forno). - [ ] **Sinergie di Assorbimento**: Verificare la presenza di acido ascorbico (Vitamina C) o acidi organici in concomitanza con fonti di ferro non-eme (es. legumi, verdure a foglia scura) per favorire la riduzione da $\text{Fe}^{3+}$ a $\text{Fe}^{2+}$. - [ ] **Antagonismi Nutrizionali**: Monitorare che pasti ad elevato contenuto di fitati/ossalati non siano somministrati in combinazione massiva con fonti primarie di calcio e zinco senza adeguati processi di ammollo o cottura prolungata. ### Sezione 4: Fattibilità Gastronomica, Cronobiologia e Aderenza - [ ] **Rotazione e Distanziamento Pasti ($G_{\text{rep}}$)**: Accertarsi che il gap temporale tra ricette identiche o fonti proteiche primarie omologhe sia rispettato ($G_{\text{rep}} \ge 3\text{ giorni}$) per evitare ipersensibilizzazioni o noia alimentare. - [ ] **Complessità nei Giorni Feriali**: Verificare che nei giorni lavorativi indicati dal paziente il tempo di preparazione sia $\le \text{max\_weekday\_prep\_min}$ e il livello di difficoltà culinaria sia compatibile con la routine domestica. - [ ] **Gestione degli Avanzi e Sicurezza Igienica (*Leftover Logistics*)**: Verificare che la rigenerazione di cibi cotti in anticipo (*meal prep*) rispetti le norme di conservazione refrigerata ($4^\circ\text{C}$ per massimo 48-72 ore) o congelata. ### Sezione 5: Budget Categorie Alimentari e Conformità Pacchetto Nutrizionale - [ ] **Aderenza ai Budget Grammi per Subcategoria**: Verificare che i grammi giornalieri e settimanali di ogni subcategoria alimentare (es. carne rossa $\le 100\text{g/settimana}$, ortaggi $\ge 400\text{g/giorno}$, pesce grasso $\ge 200\text{g/settimana}$) siano conformi al pacchetto nutrizionale sottoscritto dall'utente. - [ ] **Incompatibilità Giornaliere**: Accertarsi che nessun giorno contenga coppie di subcategorie mutualmente esclusive (es. carne rossa + pesce grasso nello stesso giorno, carne bianca + pesce magro). - [ ] **Compliance DRV Micronutrienti**: Verificare che l'assunzione settimanale media di ciascun micronutriente tracciato (ferro, calcio, zinco, vitamina C, folati, B12, vitamina D, sodio, magnesio) raggiunga $\ge 80\%$ del DRV EFSA per l'età e il sesso del paziente. Segnalare carenze critiche ($< 60\%$) con priorità medica. - [ ] **Limiti Superiori Tollerabili (UL)**: Verificare che il sodio giornaliero non superi i $2000\text{mg}$ e che i grassi saturi non superino il $10\%$ dell'introito calorico totale. Segnalare eccessi sopra UL EFSA. - [ ] **Validatore a 10 Fasi**: Il validatore deterministico `validator.py` esegue 10 controlli di sicurezza indipendenti, includendo Check 9 (DRV Micronutrient Sufficiency) e Check 10 (Category Budget Compliance). Accertarsi che tutti e 10 i check siano verdi prima dell'erogazione al paziente. --- ## 5. Piattaforma Pacchetti Nutrizionali PlayForEat integra una piattaforma di **Pacchetti Nutrizionali** — set completi di regole cliniche configurabili dal nutrizionista: ```mermaid graph LR NUT["Nutrizionista"] --> PKG["Pacchetto Nutrizionale"] PKG --> BDG["Budget Grammi per Categoria
(~30 subcategorie × 15 tier calorici)"] PKG --> INC["Regole Incompatibilità
(coppie giornaliere vietate)"] PKG --> PAR["Regole Accoppiamento
(coppie sinergiche con bonus)"] PKG --> DRV["Target DRV Micronutrienti
(per età/sesso, soglie EFSA)"] PKG --> PUB["Pubblicazione Marketplace"] PUB --> PAZ["Paziente/Utente"] PAZ --> SOL["Solver CP-SAT"] SOL --> PLAN["Piano Personalizzato
con compliance clinica"] ``` - **Pannello Nutrizionista** (`/nutrizionista`): CRUD completo per pacchetti, editor matrice budget, editor regole incompatibilità/pairing, editor target DRV, e preview piano generato. - **Dashboard Contatori** (`/oggi`, `/statistiche`): Ring radiali SVG per il progresso giornaliero e barre settimanali per il consumo per subcategoria vs. budget. - **Registra Pasto Potenziato**: Editing per-ingrediente con ricalcolo macro reale live, food search per pasti off-plan. - **Feedback Calorico**: Tracking peso settimanale con raccomandazione automatica di aggiustamento calorico basata sul trend ponderale. - **Conversioni Unità**: Cucchiai, bicchiere, porzione accanto ai grammi per ogni ingrediente. - **Stagionalità**: Badge "Di Stagione" sulle ricette e bonus solver per ingredienti stagionali. --- ## 6. Sintesi e Raccomandazioni per il Team di Nutrizione PlayForEat non sostituisce l'anamnesi e il giudizio clinico del professionista della salute. Al contrario, esso funge da **motore bioinformatico ad altissima precisione** che libera il clinico dal calcolo combinatorio manuale, garantendo che ogni piano generato soddisfi in maniera matematicamente provabile i vincoli prescritti per la salute e il benessere del paziente.