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>
This commit is contained in:
lucianoandClaude Opus 4.7 committed 2026-04-29 22:27:49 +02:00
1 parent ded4215664
commit feb54c1f9a
7 files changed
+258 -25

No files matched your search

+47 -17
View File
@@ -1,9 +1,10 @@
import {
DEFAULT_MEAL_SHARE,
calculateBmr,
calculateTdee,
macrosForPhase,
matchMeals,
protocolPlanForDay,
type FastingProtocolKey,
type RecipeCandidate,
} from '@ketopath/shared';
import type { FastifyPluginAsync } from 'fastify';
@@ -84,9 +85,15 @@ export const planRoutes: FastifyPluginAsync = async (fastify) => {
const tdee = calculateTdee(bmr, profile.activityLevel);
const phaseInt = phaseToInt(profile.currentPhase);
// Deficit base solo in fase 1; in fase 2/3 si avvicina a TDEE.
const kcalTarget = Math.round(phaseInt === 1 ? tdee - 500 : phaseInt === 2 ? tdee - 200 : tdee);
const dailyTarget = macrosForPhase({ kcalTarget, weightKg: weightCurrentKg, phase: phaseInt });
const baseKcal = Math.round(phaseInt === 1 ? tdee - 500 : phaseInt === 2 ? tdee - 200 : tdee);
const baseDailyTarget = macrosForPhase({
kcalTarget: baseKcal,
weightKg: weightCurrentKg,
phase: phaseInt,
});
const exclusions = profile.user.preferences?.exclusions ?? [];
const fastingProtocol =
(profile.user.preferences?.fastingProtocol as FastingProtocolKey | null | undefined) ?? null;
const weekStart = startOfWeek(new Date());
@@ -101,12 +108,26 @@ export const planRoutes: FastifyPluginAsync = async (fastify) => {
const plannedSlots: Array<{ day: number; meal: string; recipeId: string | null }> = [];
for (let day = 0; day < 7; day++) {
// Per ogni pasto, le ricette già scelte negli ultimi 2 giorni sono "recenti".
const dayPlan = protocolPlanForDay(fastingProtocol, day);
// Giorno di digiuno completo (ESE_24): salta tutto.
if (dayPlan.kcalMultiplier === 0) continue;
const dailyKcal = Math.round(baseKcal * dayPlan.kcalMultiplier);
const dailyTarget = macrosForPhase({
kcalTarget: dailyKcal,
weightKg: weightCurrentKg,
phase: phaseInt,
});
// Ricette scelte negli ultimi 2 giorni sono "recenti".
const recentlyConsumedIds: string[] = plannedSlots
.filter((s) => day - s.day <= 2 && s.recipeId)
.map((s) => s.recipeId!);
for (const meal of MEALS) {
// Pasto disabilitato dal protocollo: non creiamo proprio lo slot.
if (dayPlan.share[meal] === 0) continue;
const top = matchMeals({
candidates,
meal,
@@ -114,7 +135,7 @@ export const planRoutes: FastifyPluginAsync = async (fastify) => {
excludedTags: exclusions,
recentlyConsumedIds,
dailyTarget,
mealShare: DEFAULT_MEAL_SHARE,
mealShare: dayPlan.share,
topN: 5,
});
const selected = top[0];
@@ -135,7 +156,8 @@ export const planRoutes: FastifyPluginAsync = async (fastify) => {
plan: {
id: plan.id,
weekStart: plan.weekStart.toISOString().slice(0, 10),
dailyTarget,
dailyTarget: baseDailyTarget,
fastingProtocol,
},
});
});
@@ -174,25 +196,33 @@ export const planRoutes: FastifyPluginAsync = async (fastify) => {
);
fastify.get('/me/meal-plans/current', { preHandler: requireAuth() }, async (request, reply) => {
const plan = await fastify.prisma.mealPlan.findFirst({
where: { userId: request.user!.id, status: 'ACTIVE' },
orderBy: { weekStart: 'desc' },
include: {
slots: {
include: {
selected: { select: { id: true, name: true, kcal: true } },
alternatives: { select: { id: true, name: true, kcal: true } },
const userId = request.user!.id;
const [plan, prefs] = await Promise.all([
fastify.prisma.mealPlan.findFirst({
where: { userId, status: 'ACTIVE' },
orderBy: { weekStart: 'desc' },
include: {
slots: {
include: {
selected: { select: { id: true, name: true, kcal: true } },
alternatives: { select: { id: true, name: true, kcal: true } },
},
orderBy: [{ dayOfWeek: 'asc' }, { meal: 'asc' }],
},
orderBy: [{ dayOfWeek: 'asc' }, { meal: 'asc' }],
},
},
});
}),
fastify.prisma.preferences.findUnique({
where: { userId },
select: { fastingProtocol: true },
}),
]);
if (!plan) return reply.code(404).send({ error: 'plan_not_found' });
return {
plan: {
id: plan.id,
weekStart: plan.weekStart.toISOString().slice(0, 10),
slots: plan.slots,
fastingProtocol: prefs?.fastingProtocol ?? null,
},
};
});
+13
View File
@@ -391,6 +391,19 @@
"hideAlternatives": "Nascondi",
"swap": "Scegli",
"dayTotal": "{kcal} kcal totali",
"window": "Finestra alimentare",
"fastingDay": "Giorno di digiuno",
"fastingDayHint": "Acqua, tè e tisane. Niente cibo solido.",
"lightDay": "Giorno leggero",
"lightDayHint": "Solo cena, kcal ridotte (~25% del giornaliero abituale).",
"protocolLabel": {
"FOURTEEN_TEN": "14:10 — finestra di 10h",
"SIXTEEN_EIGHT": "16:8 — finestra di 8h",
"EIGHTEEN_SIX": "18:6 — finestra di 6h",
"TWENTY_FOUR": "20:4 — finestra di 4h",
"ESE_24": "ESE 24h — un giorno di digiuno completo a settimana",
"FIVE_TWO": "5:2 — due giorni leggeri a settimana"
},
"meals": {
"COLAZIONE": "Colazione",
"PRANZO": "Pranzo",
@@ -25,6 +25,14 @@ export interface CurrentPlan {
id: string;
weekStart: string;
slots: PlanSlot[];
fastingProtocol:
| 'FOURTEEN_TEN'
| 'SIXTEEN_EIGHT'
| 'EIGHTEEN_SIX'
| 'TWENTY_FOUR'
| 'ESE_24'
| 'FIVE_TWO'
| null;
}
function cookieHeader(): string {
+8
View File
@@ -62,6 +62,14 @@ function PlanPageContent({ plan }: { plan: Awaited<ReturnType<typeof fetchCurren
<p className="font-display text-ink-soft animate-fade-up mt-5 max-w-2xl text-xl italic leading-snug [animation-delay:240ms]">
{plan ? formatWeek(plan.weekStart) : t('noPlan')}
</p>
{plan?.fastingProtocol ? (
<p className="animate-fade-up mt-4 [animation-delay:300ms]">
<span className="editorial-eyebrow">{t('window')}</span>{' '}
<span className="font-display text-pomodoro ml-2 text-base italic">
{t(`protocolLabel.${plan.fastingProtocol}`)}
</span>
</p>
) : null}
</div>
<div className="animate-fade-up flex flex-col items-stretch gap-3 [animation-delay:360ms] md:col-span-4 md:items-end">
<form action={regeneratePlan}>
+26 -6
View File
@@ -36,6 +36,11 @@ export function PlanWeek({ plan }: { plan: CurrentPlan }) {
(a, b) => MEAL_ORDER.indexOf(a.meal) - MEAL_ORDER.indexOf(b.meal),
);
const dayKcal = slots.reduce((sum, s) => sum + (s.selected?.kcal ?? 0), 0);
// Nessuno slot → giorno di digiuno completo (ESE_24).
const isFastingDay = slots.length === 0;
// Solo CENA con dailyKcal ridotto → giorno "leggero" del 5:2.
const isLightDay = !isFastingDay && slots.length === 1 && slots[0].meal === 'CENA';
return (
<section key={dayKey} aria-labelledby={`day-${dayKey}`} className="space-y-5">
<header className="border-ink/15 grid items-baseline gap-2 border-b pb-3 sm:grid-cols-[auto_1fr_auto]">
@@ -47,16 +52,31 @@ export function PlanWeek({ plan }: { plan: CurrentPlan }) {
className="font-display text-ink text-2xl font-medium leading-none tracking-tight sm:text-3xl"
>
{t(`days.${dayKey}`)}
{isFastingDay ? (
<span className="font-display text-ink-dim ml-3 text-base italic">
· {t('fastingDay')}
</span>
) : isLightDay ? (
<span className="font-display text-ink-dim ml-3 text-base italic">
· {t('lightDay')}
</span>
) : null}
</h2>
<span className="text-ink-soft font-mono text-[11px] uppercase tracking-widest">
{t('dayTotal', { kcal: Math.round(dayKcal) })}
{isFastingDay ? '— kcal' : t('dayTotal', { kcal: Math.round(dayKcal) })}
</span>
</header>
<div className="divide-ink/10 grid grid-cols-1 divide-y sm:grid-cols-2 sm:gap-x-8 sm:divide-y-0 lg:grid-cols-4 lg:gap-x-6">
{slots.map((slot, slotIdx) => (
<SlotCard key={slot.id} slot={slot} index={slotIdx} />
))}
</div>
{isFastingDay ? (
<p className="font-display text-ink-soft text-base italic leading-snug">
{t('fastingDayHint')}
</p>
) : (
<div className="divide-ink/10 grid grid-cols-1 divide-y sm:grid-cols-2 sm:gap-x-8 sm:divide-y-0 lg:grid-cols-4 lg:gap-x-6">
{slots.map((slot, slotIdx) => (
<SlotCard key={slot.id} slot={slot} index={slotIdx} />
))}
</div>
)}
</section>
);
})}