🍎 NutriFood

Suivi, optimisation et planification nutritionnelle basée sur le Guide alimentaire canadien.

📑 Table des matières

• Fonctionnalités
  • Planification hebdomadaire
  • Suivi quotidien (tracking)
  • Vue simplifiée
  • Spéciaux (deals hebdomadaires)
• Architecture
  • Stack
  • Modules frontend
  • Docker
  • Données persistantes
  • Schéma DB
• Système de deals (epiceries.ca)
• API Endpoints
• Sécurité
• Installation
• Données nutritionnelles
• Licence

📖 Documentation

Guide	Description
📖 Guide utilisateur	Comment utiliser NutriFood : comptes, navigation, sélection, recherche, objectifs, listes d'épicerie, reset
🚀 Guide de déploiement	Installation complète : Docker, configuration, reverse proxy, Cloudflare, sauvegardes
🔧 Guide administrateur	Gestion des aliments, utilisateurs, DB, logs, maintenance
📊 Rapport QA	Résultats Lighthouse, OWASP ZAP, SonarQube

Aperçu

Voir plus de captures d'écran : Mode Suivi · Mode Planification · Recherche · Spéciaux · Objectifs · Liste d'épicerie

---

Fonctionnalités

Planification hebdomadaire

📖 Voir : Guide utilisateur — Sélectionner des aliments

• Sélection d'aliments par catégorie (protéines, légumes, fruits, grains, etc.)
• Calcul automatique des objectifs nutritionnels (protéines, fibres, fer, vitamine C, calcium, oméga-3, calories)
• Objectifs personnalisables par semaine → Guide utilisateur — Objectifs
• Liste d'épicerie générée à partir des sélections (fonctionne depuis le mode tracking ET planification) → Guide utilisateur — Liste d'épicerie
• Suggestions de portions et carences en nutriments
• Sauvegarde automatique et historique des semaines
• Réinitialisation rapide (badge 🔄 cliquable) → Guide utilisateur — Reset

Suivi quotidien (tracking)

📖 Voir : Guide utilisateur — Les deux modes

• Onglet "Suivi" (par défaut) pour enregistrer ce que vous mangez réellement
• Vue avancée : navigation par jour (‹ ›), dashboard double (jour + semaine cumulée)
• Vue simplifiée : vue hebdomadaire agrégée avec cases par jour de semaine
• Données préservées entre les deux modes (planification ↔ suivi)
• Mode mémorisé dans localStorage
• Réinitialisation : badge 🔄 cliquable → jour ou semaine complète

Profil utilisateur

• Saisie du poids, taille, âge, sexe et niveau d'activité
• Régimes alimentaires (végétarien, végétalien, sans gluten, etc.)
• Allergies et intolérances
• Recommandations automatiques des objectifs nutritionnels via l'équation de Mifflin-St Jeor

Vue simplifiée

La vue simplifiée affiche une semaine complète avec des cases visuelles par catégorie :

• Cases par jour : les catégories avec ≥7 portions regroupent les cases par journée (L M M J V S S D)
• Cases chronologiques : les catégories avec <7 portions affichent les items dans l'ordre des jours consommés
• Placement intelligent : cliquer sur une case d'un jour spécifique ajoute l'aliment au bon jour
• Retrait par jour : cliquer sur une case remplie ouvre le modal alimentaire avec des boutons de retrait par jour
• Dropdown adaptatif : le menu de recherche s'ouvre vers le bas ou vers le haut selon l'espace disponible
• Bouton de sauvegarde : affiche "Sauvegarder" quand modifié, "Sauvegardé" une fois sauvegardé
• Idéal sur mobile — plus rapide à consulter

La vue Avancée affiche les cartes détaillées avec nutriments et icônes. Les deux vues partagent les mêmes données.

• Mini-dashboard en vue simplifiée : barres de progression nutritionnelles

Recherche CNF étendue

La recherche principale interroge aussi la base CNF (5993 aliments) quand les résultats locaux sont insuffisants, offrant un catalogue beaucoup plus large d'aliments canadiens.

Spéciaux (deals hebdomadaires)

• Liste des spéciaux d'épiceries.ca regroupés par catégorie
• Classés du meilleur rabais (prix unitaire le plus bas)
• Logos des chaînes (IGA, Metro, Super C, Maxi, Provigo, Walmart)
• Bouton "+" pour ajouter directement à la sélection
• Clic sur une ligne → fiche produit sur le site du marchand
• Tooltips au survol : nom complet du produit, magasin, format/prix/rabais

---

Architecture

Stack

• Frontend: HTML/CSS/JS vanilla (18 modules avec lazy loading)
• Backend: Python Flask (API REST, architecture Blueprints modulaire)
• Auth: JWT via PyJWT (HS256) en cookie httpOnly + protection CSRF (double-submit cookie)
• DB: SQLite (nutrifood.db) avec tables FTS5 pour la recherche
• Aliments: 160 aliments du Guide alimentaire canadien (CNF + custom)
• Déploiement: Docker Compose (2 conteneurs)

📖 Voir : Guide de déploiement

Modules frontend

Module	Rôle
core.js	Config API, état global, helpers DOM, loader de scripts (lazy loading)
app.js	Point d'entrée, init, restauration de session, orchestration
auth.js	Connexion, inscription, JWT, menu utilisateur, mot de passe oublié
render.js	Rendu des sections, catégories, chips, vue simplifiée, event delegation
nutrition.js	Totaux nutritionnels, objectifs, dashboard suivi, reset confirmation
tracking.js	Mode Suivi : switch onglets, chargement par jour, agrégation semaine (vue simple)
search.js	Recherche normalisée (accents, ligatures) avec résultats en direct
deals.js	Spéciaux d'épicerie (epiceries.ca), badges, modal comparatif
suggestions.js	Suggestions automatiques basées sur carences nutritionnelles
grocery.js	Génération, partage et impression de la liste d'épicerie
food-modal.js	Fiche détaillée d'un aliment + retrait par jour (vue simplifiée)
history.js	Historique des snapshots hebdomadaires
share.js	Vue partagée en lecture seule (lien public)
cnf.js	Recherche dans la base CNF (5993 aliments de Santé Canada)
profile.js	Profil utilisateur (poids, taille, âge, sexe, activité, régime, allergies)
journal.js	Journal nutritionnel avec graphiques de tendances (Chart.js 7d/30d)

Dépendances frontend

Fichier	Rôle
web/nutrifood.css	Styles de l'app (CSS externe, buildé dans l'image)
chart.umd.min.js	Chart.js auto-hébergé (graphiques du journal)

Modules backend (Blueprints)

Module	Rôle
app.py	App factory, config, re-exports backward-compatible
extensions.py	Constantes partagées, DB helpers, rate limiter
blueprints/auth.py	Register, login, JWT (PyJWT), changement/reset password
blueprints/foods.py	Foods API, CNF search, admin, seasonal
blueprints/selections.py	Selections CRUD, historique, share links
blueprints/tracking.py	Tracking quotidien, goals, nutrition summary
blueprints/journal.py	Journal CRUD + summary
blueprints/deals.py	Spéciaux d'épicerie
blueprints/suggestions.py	Suggestions basées sur carences
blueprints/meal_plan.py	Plans de repas hebdomadaires
blueprints/profile.py	Profil utilisateur (GET/POST + recommandations)
blueprints/export.py	Export CSV
utils/email.py	SMTP (welcome, reset)
utils/nutrition.py	Calculs densité, totaux nutritionnels
utils/season.py	Calendrier saisonnier Québec
utils/foods_helpers.py	Construction dicts aliments, filtres deals

Docker

📖 Voir : Guide de déploiement — Démarrer les conteneurs

Architecture 2 conteneurs, images publiées sur GitHub Container Registry :

ghcr.io/slopvibe-org/nutrifood-backend:latest   (Flask/Gunicorn, port 5000 interne)
ghcr.io/slopvibe-org/nutrifood-web:latest        (Nginx, port 5011 hôte → proxy vers API)

Le conteneur backend inclut le script de sauvegarde SQLite (backend/scripts/backup_db.py) pour les backups automatisés via cron.

Tags disponibles : latest (main), v1.0.0 (releases), sha-xxxxx (par commit).

Données persistantes

📖 Voir : Guide de déploiement — Structure de déploiement

Volumes Docker :

• ./data:/data — nutrifood.db, deals_raw.json
• ./config:/usr/share/nginx/html — fichiers frontend (index.html, js/)

Schéma DB

📖 Voir : Guide administrateur — Structure de la base de données

Table	Description
users	Comptes utilisateurs (email, password_hash, is_admin, token_version, weight, height, age, sex, activity_level, diet, allergies) — colonnes profil ajoutées par migration auto au démarrage
selections	Planification hebdomadaire par utilisateur
tracking	Suivi quotidien (user_id, date, data JSON)
history_snapshots	Snapshots des semaines passées
user_goals	Objectifs nutritionnels personnalisés
nf_sections / nf_categories / nf_foods	Structure des aliments (source: SQLite)
food / food_group / nutrient_name / nutrient_amount	Base CNF (Santé Canada)
food_search (FTS5)	Index de recherche full-text
share_links	Liens de partage (avec expiration)
reset_tokens	Tokens de réinitialisation mot de passe (magic links)
meal_plans	Plans de repas hebdomadaires
journal_entries	Entrées de journal nutritionnel

---

Système de deals (epiceries.ca)

Architecture en 3 couches

1. /data/deals_raw.json (source de vérité)

   • Fetch brut depuis epiceries.ca, une fois par semaine
   • Stocke TOUS les résultats sans filtrage
   • JAMAIS modifié après écriture (sauf refresh hebdomadaire)

2. filter_deals(raw, foods) (pure function)

   • Lit le raw, applique les filtres, retourne les deals valides
   • Aucun side effect — le raw reste intact
   • Filtres: word-boundary matching, exclusion animaux, strict match pour herbes/épices/noix

3. API /api/deals

   • Sert les deals filtrés en temps réel
   • Déclenche un refresh auto si le raw a >1 semaine
   • Le bouton "🔄 Rafraîchir" (admin) force un refresh manuel

---

API Endpoints

📖 Voir : Guide administrateur — Gérer les aliments pour les endpoints admin

Aliments

• GET /api/foods — liste des catégories et aliments
• GET /api/seasonal — aliments de saison (mois courant)

Recherche CNF

• GET /api/cnf/search?q=... — recherche dans la base CNF
• GET /api/cnf/product/<id> — fiche détaillée d'un aliment CNF

Authentification

• POST /api/register — inscription
• POST /api/login — connexion (définit cookie httpOnly + cookie CSRF)
• POST /api/logout — déconnexion (efface les cookies)
• GET /api/me — profil utilisateur courant
• POST /api/change-password — changement de mot de passe
• POST /api/forgot-password — mot de passe oublié (envoi lien)
• POST /api/reset-password — réinitialisation via magic link

Planification

• GET /api/selections — sélections de l'utilisateur
• POST /api/selections — sauvegarder les sélections
• GET /api/history — historique des semaines
• GET /api/history/<week> — détail d'une semaine
• GET /api/nutrition-summary — résumé nutritionnel

Suivi (tracking)

• GET /api/tracking/<date> — sélections du jour
• POST /api/tracking/<date> — sauvegarder le jour
• DELETE /api/tracking/<date> — effacer les données du jour
• GET /api/tracking/week — toutes les entrées de la semaine (lun→dim)
• DELETE /api/tracking/week — effacer toute la semaine
• GET /api/tracking/nutrition/<date> — totaux nutritionnels (jour + semaine cumulée)

Objectifs

• GET /api/goals — objectifs nutritionnels
• POST /api/goals — mettre à jour les objectifs

Spéciaux (deals)

• GET /api/deals — spéciaux filtrés (lus depuis deals_raw.json, filtrés à la volée)
• POST /api/deals/refresh — forcer un refresh du raw (admin only)

Autres

• GET /api/suggestions — suggestions basées sur carences
• POST /api/share — générer un lien de partage (avec expiration)
• GET /api/shared/<token> — vue partagée (lecture seule)
• GET/POST /api/meal-plan — plan de repas hebdomadaire
• GET/POST/DELETE /api/journal — journal nutritionnel
• GET /api/journal/summary — résumé du journal
• GET /api/health — health check (inclut deals_count, deals_stale, deals_last_refresh)
• GET /api/health/backup — vérification du dernier backup SQLite

Profil utilisateur

• GET /api/profile — récupérer le profil (poids, taille, âge, sexe, activité, régime, allergies)
• POST /api/profile — mettre à jour le profil
• GET /api/profile/recommend-targets — recommandations d'objectifs basées sur le profil (Mifflin-St Jeor)

Export

• GET /api/export/csv — export CSV des données (suivi, journal, sélections)

Administration

• POST /api/admin/food/hide — masquer un aliment (admin only)
• POST /api/admin/food/show — afficher un aliment (admin only)

---

Sécurité

Headers de sécurité (nginx)

• X-Content-Type-Options: nosniff
• X-Frame-Options: DENY
• Strict-Transport-Security (HSTS)
• Content-Security-Policy : script-src 'self' + hash Cloudflare, style-src 'self' 'unsafe-inline'
• Referrer-Policy
• Permissions-Policy
• Cross-Origin-Embedder-Policy
• Cross-Origin-Opener-Policy
• Chart.js auto-hébergé (plus de CDN — script-src 'self' uniquement)

Authentification

• JWT tokens (PyJWT, HS256) stockés en cookie httpOnly + Secure + SameSite (plus dans localStorage)
• Protection CSRF via double-submit cookie (nf_csrf_token) — header X-CSRF-Token sur les requêtes mutatives
• Password hashing: argon2id (migration transparente depuis PBKDF2 au prochain login)
• Token invalidation on password change (token_version)
• Rate limiting: 10 req/min sur endpoints sensibles (login, register, forgot-password, reset-password) — utilise X-Forwarded-For
• Reset tokens expirent après 1h
• Endpoint /api/logout pour effacer les cookies

CI et tests

📖 Voir : Guide de test complet

• 93 tests pytest (couverture 74%)
• CI GitHub Actions : pytest --cov --cov-fail-under=60 + ruff + bandit sur chaque PR
• Docker publishing : images build sur ghcr.io à chaque push sur main
• requirements-dev.txt : dépendances de développement (pytest, pytest-cov)

Résultats QA (6 août 2026)

📋 Rapport QA complet

Outil	Résultat
Lighthouse	Performance 100 · Accessibility 100 · Best Practices 92 · SEO 100
OWASP ZAP	0 FAIL · 19 WARN (CSP unsafe-inline style) · 2 INFO
SonarQube	0 bugs · 1 vuln (faux positif CORS/CSRF) · 0 hotspots · 51 code smells (pré-existant)
Tests	93 passed · 74% coverage
Sécurité	Cookie httpOnly · CSRF double-submit · argon2id · CSP stricte · rate limiting
Mobile	✅ Aucun overflow · toutes fonctionnalités opérationnelles

---

Installation

📖 Voir : Guide de déploiement complet

Prérequis

• Docker + Docker Compose v2
• Port 5011 disponible (ou modifier docker-compose.yml)

Déploiement rapide

git clone https://github.com/SlopVibe-org/nutri-food.git
cd nutri-food
cp .env.example .env  # Éditer avec vos valeurs
docker compose up -d    # Pull les images depuis ghcr.io

Mise à jour

# Pull les dernières images + restart (~5s de downtime)
bash scripts/deploy.sh

# Ou manuellement
docker compose pull && docker compose up -d

Releases et tags

Les images Docker sont taggées automatiquement :

• latest — dernier push sur main
• v1.0.0 — sur GitHub Release (rollback précis)
• sha-xxxxx — par commit (debugging)

Créer une release :

git tag v1.0.0
git push origin v1.0.0
# → GitHub Actions build & push l'image taggée

Configuration (.env)

JWT_SECRET=votre_secret_long_et_aleatoire
DB_PATH=/data/nutrifood.db
JWT_EXPIRY_HOURS=2160
SMTP_HOST=smtp.fastmail.com
SMTP_PORT=465
[email protected]
SMTP_PASS=votre_mot_de_passe
[email protected]
APP_URL=https://votre-domaine.com/nutri-food/

---

Données nutritionnelles

• Aliments NutriFood: gérés via SQLite (tables nf_*), interface admin → Guide admin
• CNF (Canadian Nutrient File): 5993 aliments de Santé Canada intégrés (tables food, nutrient_*)
• Objectifs par défaut (hebdomadaires): Protéines 350g, Fibres 175g, Fer 56mg, Vit C 280mg, Calcium 700mg, Oméga-3 3.5g, Calories 14000kcal

---

Licence

GPL-3.0