Regole e formato ricette

Template e regole obbligatorie per ogni nuova ricetta in ricette/. Servono a mantenere le schede uniformi, verificabili e ricalcolabili. Vedi anche le regole fisse (sale sempre) e il procedimento generale.

Regola zero — non inventare mai

Non si inventa niente. Mai. Nessuna affermazione, nessun numero, nessun "trucco", nessuna causa o spiegazione tecnica può essere prodotta dalla propria conoscenza o intuizione.

• Ogni informazione deve venire da una fonte verificabile (Open Food Facts, etichetta, scheda del produttore, manuale citabile) o dalla bocca dell'utente. Punto.
• Vietato fare ipotesi. Non si propongono cause, meccanismi o spiegazioni "probabili". Se non si sa: si dice "non lo so" e si cerca la fonte o si chiede.
• Vietato scrivere o memorizzare nei file qualsiasi ipotesi che non venga da una fonte o dall'utente. I file contengono solo fatti verificati o detti dall'utente.
• Cerca prima di affermare. C'è un motore di ricerca: se non sai, cerchi; se non trovi, dici «non lo so». Mai dalla memoria quando la verifica è a una ricerca di distanza.
• Verificato = citazione testuale. Per marcare qualcosa come "da fonte web" si apre la pagina e si incolla la frase esatta (tra «...»). Un riassunto del motore di ricerca non è la fonte.
• Nel dubbio: niente affermazione, niente file. Si chiede.

Frontmatter

---
type: Ricetta
title: Nome leggibile della ricetta
description: Una riga che riassume profilo e base.
tags: [vaniglia, light, ...]
status: wip            # wip | approvata | scartata
timestamp: AAAA-MM-GGT00:00:00Z
---

Il campo status è obbligatorio e vale:

• wip — in lavorazione / da testare (default per ogni nuova ricetta);
• approvata — provata e promossa (di solito dopo un test);
• scartata — provata e bocciata; si tiene la scheda per memoria, con il motivo nel diario di test collegato.

Sezioni obbligatorie, in quest'ordine

1. # Titolo + paragrafo introduttivo (profilo, base, note di volume/MAX).
2. # Ingredienti — tabella | Ingrediente | Quantità |:
3. usa i prodotti reali (marca specifica), non generici: es. "Zymil Magro senza lattosio", non "latte scremato";
4. includi sempre il sale (~1 g, regola fissa);
5. includi lo stabilizzante 5CF (~2,5 g, a freddo) come default in ogni nuova ricetta (nota, fino al futuro test 5CF vs Xantano);
6. ultima riga in grassetto | **Totale miscela** | **NNN g** |, somma esatta.
7. # Note — riga sintetica con **Calorie totali pint:**, **Proteine:**, **Programma:** (Ice Cream / Lite Ice Cream) + eventuali accorgimenti.
8. # Calcolo calorico — tabella | Ingrediente | Qtà | Base | kcal | con la fonte di ogni valore in nota a piè di pagina; ultima riga **Totale pint**.
9. # Valori nutrizionali — tabella | Valori | per pint (NNN g) | per 100 g | con: Energia, Grassi (di cui saturi), Carboidrati (di cui zuccheri), Proteine, Sale.
10. Footer con cross-link a procedimento e regole fisse.

Regole di calcolo

• Fonti: ogni valore nutrizionale va da Open Food Facts (cita il barcode) o dall'etichetta del prodotto. Mai inventare numeri: se un prodotto non è su OFF, usa l'etichetta; se manca anche quella, segnala il dato come mancante.
• Eritritolo: 0 kcal; i suoi polioli danno volume ma non si contano in "carboidrati / di cui zuccheri" (annotalo sotto la tabella nutrizionale).
• Sale: il sale aggiunto va sommato al totale "Sale" (1 g di sale = 1 g).
• per 100 g: dividi i totali pint per i grammi di "Totale miscela".
• Arrotonda le kcal alla decina (~) nelle intestazioni; nelle tabelle di calcolo mostra la somma puntuale.

Citazioni (nota a piè di pagina)

[^prodotto]: [Open Food Facts — Nome, barcode XXXXXXX](https://world.openfoodfacts.org/product/XXXXXXX) — per 100 g: kcal · grassi (saturi) · carboidrati (zuccheri) · proteine · sale.

Per prodotti non su OFF, cita l'etichetta:

[^prodotto]: Valori dall'etichetta di <prodotto> — per 100 g/ml: ...

Diari di test

Le prove vanno registrate in tests/ (un file = una prova). Sono i "diari" che giustificano il passaggio di una ricetta da wip a approvata / scartata.

Frontmatter:

---
type: Test
title: Test N — titolo sintetico
description: Una riga su cosa confronta/verifica.
tags: [test, ...]
status: in-corso       # in-corso | concluso
timestamp: AAAA-MM-GGT00:00:00Z
---

Struttura minima del diario:

1. # Titolo + link alle ricette coinvolte.
2. ## Ricette in prova — riepilogo autosufficiente delle ricette testate (ingredienti + macro chiave: kcal, proteine, grassi, zuccheri), come snapshot dalle schede, così il diario si legge senza aprire altri file.
3. ## Ipotesi — cosa ci aspettiamo e perché.
4. ## Setup — parametri, evidenziando la variabile isolata (cosa cambia, cosa resta costante).
5. ## Cosa osservare — i criteri da valutare.
6. ## Osservazioni — dati/note raccolti durante la prova (mai inventati: si compila solo dopo aver provato).
7. ## Esito — conclusione e ricaduta sullo status delle ricette.

Quando un test si conclude: aggiorna lo status del test (concluso) e quello delle ricette coinvolte, aggiungi la voce in tests/index.md e una riga in log.md.

Checklist prima di salvare

• [ ] Frontmatter con status (wip per le nuove).
• [ ] Prodotti reali con marca, sale incluso, Totale miscela corretto.
• [ ] # Calcolo calorico e # Valori nutrizionali presenti e coerenti.
• [ ] Ogni valore ha una citazione (OFF o etichetta).
• [ ] Voci aggiunte in ricette/index.md e nell'index.md principale.
• [ ] Riga in log.md sotto la data odierna.
• [ ] Bundle validato: validate.sh wiki → conformant.