feat: piano sensibile al protocollo digiuno (PRD §5.6 + §9.4)

Finora il fastingProtocol era una preferenza salvata ma ignorata dal
planner — ogni giorno generava 4 pasti. Ora cambia struttura per protocollo
e per giorno della settimana.

@ketopath/shared/planner
- protocolPlanForDay(protocol, dayOfWeek) → { share, kcalMultiplier }
- 14:10  → tutti e 4 i pasti, share default
- 16:8   → niente colazione: pranzo 50%, spuntino 10%, cena 40%
- 18:6   → niente colazione: pranzo 55%, spuntino 5%, cena 40%
- 20:4   → solo spuntino+cena (10/90)
- ESE 24h → mercoledì kcalMultiplier=0 (giorno saltato), altri default
- 5:2    → lunedì + giovedì kcalMultiplier=0.25, share 100% cena
- 7 unit test in protocol.test.ts

apps/api/plan
- POST /me/meal-plans: legge preferences.fastingProtocol, deriva il piano
  per ogni giorno, salta MealSlot con share=0 e giorni a kcalMultiplier=0
- GET /me/meal-plans/current: include fastingProtocol nella risposta
- baseDailyTarget restituito invariato per il client

apps/web
- /plan mostra "Finestra alimentare 16:8" sotto il titolo della settimana
- plan-week distingue i giorni "fasting" (digiuno completo) e "leggeri"
  (5:2 fasting day) con copy dedicato; rimuove totali calorici inappropriati
- i18n: Plan.protocolLabel + Plan.fastingDay/lightDay

Smoke tested: settato 16:8 da /profile, rigenerato il piano, verificato
che l'etichetta appaia e che ogni giorno abbia esattamente 3 pasti
(Pranzo / Spuntino / Cena, niente Colazione).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

packages/shared/src/planner/matchmaking.ts

@@ -91,10 +91,91 @@ export function matchMeals(opts: MatchOptions): MatchResult[] {
   return results.slice(0, opts.topN ?? 5);
 }
 
+export type MealShare = MatchOptions['mealShare'];
+
 // Default share per pasto (somma 1.0). Può essere sovrascritta dall'utente.
-export const DEFAULT_MEAL_SHARE = {
+export const DEFAULT_MEAL_SHARE: MealShare = {
   COLAZIONE: 0.25,
   PRANZO: 0.35,
   SPUNTINO: 0.1,
   CENA: 0.3,
-} as const;
+};
+
+export type FastingProtocolKey =
+  | 'FOURTEEN_TEN'
+  | 'SIXTEEN_EIGHT'
+  | 'EIGHTEEN_SIX'
+  | 'TWENTY_FOUR'
+  | 'ESE_24'
+  | 'FIVE_TWO';
+
+/**
+ * Piano del singolo giorno per un certo protocollo IF.
+ * - `share`: quote per pasto (sommano a `kcalMultiplier`, non a 1, perché un
+ *   giorno di digiuno completo ha tutto a 0).
+ * - `kcalMultiplier`: moltiplicatore sul TDEE/kcalTarget del giorno.
+ *   - 1.0 → giorno normale
+ *   - 0.0 → giorno di digiuno completo (il piano salta il giorno intero)
+ *   - 0.25 → giorno "fasting day" del 5:2 (~500 kcal su 2000)
+ */
+export interface ProtocolDayPlan {
+  share: MealShare;
+  kcalMultiplier: number;
+}
+
+const ALL_ZERO: MealShare = { COLAZIONE: 0, PRANZO: 0, SPUNTINO: 0, CENA: 0 };
+
+// PRD §5.6 + §9.4 — finestra alimentare per protocollo, declinata per giorno
+// della settimana. `dayOfWeek` è Mon-anchored: 0=Lunedì … 6=Domenica.
+//
+// 14:10  → 10h, tutti i pasti, ogni giorno.
+// 16:8   → 8h, niente colazione (brunch + cena + spuntino), ogni giorno.
+// 18:6   → 6h, niente colazione, pranzo grande + cena + spuntino piccolo.
+// 20:4   → 4h, un solo pasto sostanzioso a cena + spuntino opzionale.
+// ESE 24h → mercoledì digiuno completo (kcalMultiplier=0), altri giorni
+//           default. Variante "una volta a settimana" del classico Eat-Stop-Eat.
+// 5:2    → lunedì + giovedì giorni "magri" (~500 kcal, un solo pasto a cena),
+//          gli altri 5 giorni default.
+export function protocolPlanForDay(
+  protocol: FastingProtocolKey | null | undefined,
+  dayOfWeek: number,
+): ProtocolDayPlan {
+  switch (protocol) {
+    case 'SIXTEEN_EIGHT':
+      return {
+        share: { COLAZIONE: 0, PRANZO: 0.5, SPUNTINO: 0.1, CENA: 0.4 },
+        kcalMultiplier: 1,
+      };
+    case 'EIGHTEEN_SIX':
+      return {
+        share: { COLAZIONE: 0, PRANZO: 0.55, SPUNTINO: 0.05, CENA: 0.4 },
+        kcalMultiplier: 1,
+      };
+    case 'TWENTY_FOUR':
+      return {
+        share: { COLAZIONE: 0, PRANZO: 0, SPUNTINO: 0.1, CENA: 0.9 },
+        kcalMultiplier: 1,
+      };
+    case 'ESE_24':
+      // Mercoledì (dayOfWeek === 2) digiuno completo, altrimenti normale.
+      return dayOfWeek === 2
+        ? { share: ALL_ZERO, kcalMultiplier: 0 }
+        : { share: DEFAULT_MEAL_SHARE, kcalMultiplier: 1 };
+    case 'FIVE_TWO':
+      // Lunedì (0) e giovedì (3) "fasting days": un solo pasto a cena con
+      // kcal complessive ridotte (~25% di TDEE, target classico ~500 kcal).
+      // Nota: la share somma comunque a 1 (è la quota del *giorno ridotto*),
+      // mentre la riduzione totale viene applicata via kcalMultiplier.
+      return dayOfWeek === 0 || dayOfWeek === 3
+        ? {
+            share: { COLAZIONE: 0, PRANZO: 0, SPUNTINO: 0, CENA: 1 },
+            kcalMultiplier: 0.25,
+          }
+        : { share: DEFAULT_MEAL_SHARE, kcalMultiplier: 1 };
+    case 'FOURTEEN_TEN':
+    case null:
+    case undefined:
+    default:
+      return { share: DEFAULT_MEAL_SHARE, kcalMultiplier: 1 };
+  }
+}

packages/shared/src/planner/protocol.test.ts

@@ -0,0 +1,73 @@
+import { describe, expect, it } from 'vitest';
+
+import { DEFAULT_MEAL_SHARE, protocolPlanForDay } from './matchmaking.js';
+
+describe('protocolPlanForDay', () => {
+  it('ritorna il default quando il protocollo non è impostato', () => {
+    const r = protocolPlanForDay(null, 0);
+    expect(r.share).toEqual(DEFAULT_MEAL_SHARE);
+    expect(r.kcalMultiplier).toBe(1);
+  });
+
+  it('14:10 lascia tutti i quattro pasti uguali al default', () => {
+    for (let day = 0; day < 7; day++) {
+      const r = protocolPlanForDay('FOURTEEN_TEN', day);
+      expect(r.share).toEqual(DEFAULT_MEAL_SHARE);
+      expect(r.kcalMultiplier).toBe(1);
+    }
+  });
+
+  it('16:8 azzera la colazione e mantiene 8h di alimentazione', () => {
+    const r = protocolPlanForDay('SIXTEEN_EIGHT', 0);
+    expect(r.share.COLAZIONE).toBe(0);
+    expect(r.share.PRANZO + r.share.SPUNTINO + r.share.CENA).toBeCloseTo(1, 5);
+    expect(r.kcalMultiplier).toBe(1);
+  });
+
+  it('18:6 azzera la colazione e tiene lo spuntino piccolo', () => {
+    const r = protocolPlanForDay('EIGHTEEN_SIX', 0);
+    expect(r.share.COLAZIONE).toBe(0);
+    expect(r.share.SPUNTINO).toBeLessThan(0.1);
+    expect(r.share.PRANZO + r.share.SPUNTINO + r.share.CENA).toBeCloseTo(1, 5);
+  });
+
+  it('20:4 lascia praticamente solo la cena', () => {
+    const r = protocolPlanForDay('TWENTY_FOUR', 0);
+    expect(r.share.COLAZIONE).toBe(0);
+    expect(r.share.PRANZO).toBe(0);
+    expect(r.share.CENA).toBeGreaterThan(0.8);
+  });
+
+  it('ESE_24 mette il mercoledì a digiuno completo, gli altri normali', () => {
+    const wed = protocolPlanForDay('ESE_24', 2);
+    expect(wed.kcalMultiplier).toBe(0);
+    expect(wed.share).toEqual({ COLAZIONE: 0, PRANZO: 0, SPUNTINO: 0, CENA: 0 });
+
+    for (const day of [0, 1, 3, 4, 5, 6]) {
+      const r = protocolPlanForDay('ESE_24', day);
+      expect(r.kcalMultiplier).toBe(1);
+      expect(r.share).toEqual(DEFAULT_MEAL_SHARE);
+    }
+  });
+
+  it("5:2 segna lunedì e giovedì come 'fasting day' a kcal ridotte", () => {
+    for (const day of [0, 3]) {
+      const r = protocolPlanForDay('FIVE_TWO', day);
+      expect(r.kcalMultiplier).toBeCloseTo(0.25, 5);
+      // Share somma a 1 sul giorno-ridotto: la riduzione kcal è già nel multiplier.
+      expect(r.share.COLAZIONE + r.share.PRANZO + r.share.SPUNTINO + r.share.CENA).toBeCloseTo(
+        1,
+        5,
+      );
+      expect(r.share.CENA).toBe(1);
+      expect(r.share.COLAZIONE).toBe(0);
+      expect(r.share.PRANZO).toBe(0);
+      expect(r.share.SPUNTINO).toBe(0);
+    }
+    for (const day of [1, 2, 4, 5, 6]) {
+      const r = protocolPlanForDay('FIVE_TWO', day);
+      expect(r.kcalMultiplier).toBe(1);
+      expect(r.share).toEqual(DEFAULT_MEAL_SHARE);
+    }
+  });
+});