Cinque feature che chiudono il PRD §5.3 (gestione digiuno).
§5.3.1 Streak + statistiche settimanali/mensili
- @ketopath/shared/tracking/fasting-stats: computeFastingStats(events) ritorna
weeklyHours, monthlyHours, currentStreak, longestStreak, completionRate,
totalSessions, completedSessions
- 6 unit test (currentStreak consecutivo, longestStreak storico, completionRate
ignora IN_PROGRESS, range temporali)
- /fasting: la striscia di stat passa da 3 a 5 (settimanali, mensili, streak
attuale, streak record, % completamento)
§5.3.2 Diario sintomi durante il digiuno
- updateFastSymptoms server action → PATCH /me/fast-events/:id { symptoms }
- SymptomsDiary component nel timer attivo: checkbox "Mal di testa" + 3 slider
1-10 (Energia, Fame, Lucidità) + textarea note libere; "Salva" non
interrompe il timer
§5.3.3 Notifiche per-fast
- FastEvent.notifiedMilestones String[] (idempotenza)
- Cron */5 * * * * `runFastingMilestonesJob` scansiona le sessioni IN_PROGRESS
e invia push secondo le milestone:
· hydration_2h / 4h / 6h — promemoria idratazione
· electrolyte_18h — alert elettroliti per digiuni lunghi
· ending_soon — 30 min prima della fine
- Skip automatico se l'utente ha fastingPausedUntil futuro
- Skip se l'utente non ha attivato `fastingMilestones` nelle preferenze
- Server.ts gestisce ora 2 ScheduledTask (weekly + fasting)
§5.3.4 Modalità giorno libero
- User.fastingPausedUntil DateTime?
- POST /me/fasting/pause con body { until?: ISO|null } — default: domani 06:00
- GET /me/fasting/pause ritorna { fastingPausedUntil, paused }
- /fasting: FastingPauseToggle bottone "Pausa per oggi" → banner con countdown +
"Riprendi adesso" per terminare prima
§5.3.5 Pasto di rottura intelligente
- GET /me/fast-events/:id/break-fast-suggestions: solo per digiuni >= 24h,
ritorna 3 ricette con prepMinutes ≤ 20, kcal ≤ 350, categoria
COLAZIONE/SPUNTINO. Heuristica per "facile da digerire".
- /fasting history: per le sessioni completate >= 24h aggiunge un disclosure
"Suggerimenti per riprendere a mangiare" che fetcha on-demand e linka alle
ricette
Schema migrations: add_fasting_paused_until, add_fast_event_milestones.
72/72 unit test verdi (6 nuovi). Lint, typecheck, build verdi.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
70 lines
2.1 KiB
TypeScript
70 lines
2.1 KiB
TypeScript
import { describe, expect, it } from 'vitest';
|
|
|
|
import { computeFastingStats, type FastingEventLike } from './fasting-stats.js';
|
|
|
|
const HOUR_MS = 3_600_000;
|
|
const DAY_MS = 24 * HOUR_MS;
|
|
|
|
function ev(
|
|
daysAgo: number,
|
|
hours: number,
|
|
status: FastingEventLike['status'] = 'COMPLETED',
|
|
): FastingEventLike {
|
|
const now = new Date('2026-04-29T12:00:00Z');
|
|
const start = new Date(now.getTime() - daysAgo * DAY_MS);
|
|
return {
|
|
status,
|
|
startedAt: start.toISOString(),
|
|
endedAt:
|
|
status === 'IN_PROGRESS' ? null : new Date(start.getTime() + hours * HOUR_MS).toISOString(),
|
|
targetDuration: hours * 60,
|
|
};
|
|
}
|
|
|
|
const NOW = new Date('2026-04-29T12:00:00Z');
|
|
|
|
describe('computeFastingStats', () => {
|
|
it('vuoto → tutti zeri', () => {
|
|
const s = computeFastingStats([], NOW);
|
|
expect(s).toEqual({
|
|
weeklyHours: 0,
|
|
monthlyHours: 0,
|
|
currentStreak: 0,
|
|
longestStreak: 0,
|
|
completionRate: 0,
|
|
totalSessions: 0,
|
|
completedSessions: 0,
|
|
});
|
|
});
|
|
|
|
it('weeklyHours somma solo sessioni completate negli ultimi 7 giorni', () => {
|
|
const s = computeFastingStats([ev(0, 16), ev(2, 18), ev(10, 24)], NOW);
|
|
expect(s.weeklyHours).toBeCloseTo(34, 5);
|
|
expect(s.monthlyHours).toBeCloseTo(58, 5);
|
|
});
|
|
|
|
it('currentStreak: 3 giorni consecutivi con sessione completed', () => {
|
|
const s = computeFastingStats([ev(0, 16), ev(1, 16), ev(2, 16), ev(4, 16)], NOW);
|
|
expect(s.currentStreak).toBe(3);
|
|
});
|
|
|
|
it('currentStreak salta se manca un giorno', () => {
|
|
const s = computeFastingStats([ev(0, 16), ev(2, 16)], NOW);
|
|
expect(s.currentStreak).toBe(1);
|
|
});
|
|
|
|
it('completionRate ignora sessioni in corso', () => {
|
|
const s = computeFastingStats(
|
|
[ev(0, 16, 'COMPLETED'), ev(1, 8, 'ABORTED'), ev(2, 0, 'IN_PROGRESS')],
|
|
NOW,
|
|
);
|
|
expect(s.completionRate).toBeCloseTo(0.5, 5);
|
|
});
|
|
|
|
it('longestStreak storico', () => {
|
|
const events = [ev(0, 16), ev(1, 16), ev(2, 16), ev(3, 16), ev(10, 16), ev(11, 16)];
|
|
const s = computeFastingStats(events, NOW);
|
|
expect(s.longestStreak).toBeGreaterThanOrEqual(4);
|
|
});
|
|
});
|