Upload 16 files

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+assets/carte_exemple.png filter=lfs diff=lfs merge=lfs -text

PROMPTS.md

@@ -0,0 +1,29 @@
+# Utilisation de l'IA générative
+
+**Outil :** Claude (Anthropic), modèle `claude-opus-5-5`, dans l'application Claude (mode agent avec exécution de code).
+**Rôle :** lecture du dossier PFE, conception de l'architecture, écriture du code, du jeu de données, des tests et de la documentation.
+Le code a été exécuté et testé dans l'environnement de l'agent (tests dans `tests/`).
+
+## Prompts utilisés (dans l'ordre)
+1. *« J'ai un projet à réaliser, tu peux m'aider à le faire : le projet consiste à créer une application qui utilise l'IA
+   pour résoudre un problème actuel, puis à la présenter en vidéo. [consignes complètes du projet : outils publics
+   Hugging Face / GitHub / Kaggle, Python, aller au-delà du cours, reproductible, citer les prompts ; à rendre : code,
+   données, guide d'utilisation, bibliothèques et sources] »*
+2. *« La partie vidéo c'est Manon qui la fait, moi je veux juste faire l'application. »*
+3. *« Voilà, utilise ça pour faire l'appli, tout est dans le dossier, fais l'appli dedans. »* + pièce jointe :
+   `Dossier_PFE_Manon_Thomas_M2_ECV_Paris.pdf`
+
+## Ce que l'IA a produit à partir de ces prompts
+| Fichier | Produit par l'IA | Vérification humaine à faire / faite |
+|---|---|---|
+| `grapp/engine.py`, `grapp/carte.py`, `app.py` | Code complet | Relire, lancer, tester la démo |
+| `data/vins.csv` (via `scripts/build_dataset.py`) | Profils d'appellation (échelles 1-5, arômes, accords, prix indicatifs) | Relire les profils avec les sources de SOURCES.md |
+| `data/dico.csv` | Définitions en ton Gen Z | Relire |
+| `tests/`, README, SOURCES, ce fichier | Oui | — |
+
+## Choix de l'IA à justifier à l'oral
+- Recommandation **hybride et explicable** plutôt qu'un chatbot : réponses rapides, gratuites, hors ligne, sans hallucination de vins inexistants.
+- OCR + correspondance floue pour ne recommander **que des vins présents sur la carte**.
+- Modèle Hugging Face léger et multilingue, avec repli TF-IDF pour garantir la reproductibilité.
+
+*(Ajoutez ici les prompts que vous utiliserez ensuite, par ex. avec ChatGPT ou Copilot pour modifier le code.)*

README.md

@@ -1,10 +1,123 @@
 ---
-title: Grapp
-emoji: 🚀
-colorFrom: purple
-colorTo: blue
-sdk: static
+title: GRAPP
+emoji: 🍇
+colorFrom: pink
+colorTo: purple
+sdk: streamlit
+app_file: app.py
 pinned: false
+license: mit
+short_description: Choisir son vin sans se prendre la grappe
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🍇 GRAPP — L'app pour choisir ton vin sans te prendre la grappe
+
+> Même si t'y connais rien, GRAPP t'aide à trouver LE vin que tu kiffes, super facilement.
+
+**Problème.** En 60 ans, la consommation de vin des Français a chuté de 70 %. Les jeunes trouvent le vin élitiste,
+compliqué et intimidant (« c'est cher », « je préfère la bière », « au bar je commande une blonde, c'est plus facile »).
+Devant une carte des vins de resto, ils ne savent pas quoi choisir. Le vin pèse pourtant 15 % de la production agricole
+française en valeur, et 1 exploitation agricole sur 5 a une activité viticole.
+
+**Solution.** GRAPP (concept et direction artistique : projet de fin d'études de Manon Thomas, M2 DA, ECV Paris 2025)
+transforme la carte des vins en conseil personnalisé, sans jargon :
+
+| Module | Ce que ça fait | IA utilisée |
+|---|---|---|
+| 🥂 **Tchin Tchin !** | 1) photo de la carte du resto → GRAPP repère les vins proposés et leurs prix ; 2) quiz en 7 questions ; 3) top 3 avec un **% de match** et le *pourquoi* | OCR Tesseract + correspondance floue ; recommandation hybride (profil + embeddings de phrases Hugging Face) |
+| 💖 **Mes p'tits favoris** | Garde tes vins pépites et te propose des vins du même style | Similarité d'embeddings |
+| 💡 **Dico Vino** | Pose ta question comme tu veux (« pourquoi ma bouche gratte ? ») → explication cool du mot (ici : tanins) | Recherche sémantique |
+
+### Ce qui va au-delà du cours
+- **Pipeline multimodal** : image → texte (OCR) → entités (vins) → recommandation.
+- **Correspondance floue** robuste aux erreurs d'OCR (« Cétes du Rhone » → Côtes du Rhône, « ler Cru » → 1er Cru).
+- **Recommandation hybride explicable** : score pondéré entre critères du quiz et similarité sémantique d'une phrase libre,
+  avec les raisons affichées à l'utilisateur.
+- **Modèle Hugging Face multilingue** (`paraphrase-multilingual-MiniLM-L12-v2`) avec **repli automatique** sur TF-IDF
+  hors ligne : l'app tourne toujours.
+
+---
+
+## 📘 Guide d'utilisation
+
+### 1. Installer (une seule fois)
+Il faut **Python 3.10+**.
+
+```bash
+cd GRAPP
+python -m venv .venv
+source .venv/bin/activate          # Windows : .venv\Scripts\activate
+pip install -r requirements.txt
+```
+
+Pour lire les photos de cartes, installer aussi le moteur **Tesseract** :
+- macOS : `brew install tesseract tesseract-lang`
+- Windows : installeur sur https://github.com/UB-Mannheim/tesseract/wiki
+- Linux : `sudo apt install tesseract-ocr tesseract-ocr-fra`
+
+> Sans Tesseract, tout marche sauf la lecture de photo : on colle alors le texte de la carte.
+> Au premier lancement, le modèle Hugging Face (~470 Mo) se télécharge automatiquement.
+
+### 2. Lancer
+```bash
+streamlit run app.py
+```
+L'app s'ouvre dans le navigateur (http://localhost:8501).
+
+### 3. Utiliser
+1. **Tchin Tchin !** → choisis *Photo*, *Carte d'exemple (démo)* ou *Coller le texte*, puis **Lire la carte**
+   (ou « Pas de carte, on passe au quiz »).
+2. Réponds aux **7 questions** (plan du jour, verre ou bouteille, couleur, bulles, sucre, corps, goûts, budget, envie en une phrase).
+3. GRAPP affiche ton **top 3** avec le % de match. ❤️ pour garder un vin, 🔁 pour des vins du même style.
+4. **Mes p'tits favoris** : tes vins enregistrés (dans `data/favoris.json`).
+5. **Dico Vino** : tape un mot ou une question.
+
+Scénario de démo conseillé pour la vidéo : *Carte d'exemple* → Apéro entre potes → bouteille → Rouge → Sans bulles →
+Sec → Léger → Fruité, 30 € → « un truc frais avec de la charcuterie » ⇒ Chinon / Beaujolais-Villages en tête.
+
+### 4. Vérifier que tout marche
+```bash
+python tests/test_grapp.py         # ou : python -m pytest -q
+```
+
+### 5. (Optionnel) Ajouter de vraies bouteilles notées — Kaggle
+Télécharger `winemag-data-130k-v2.csv` depuis https://www.kaggle.com/datasets/zynicide/wine-reviews dans `data/`, puis :
+```bash
+python scripts/enrichir_kaggle.py
+```
+Chaque vin recommandé affiche alors les bouteilles réelles les mieux notées de son appellation.
+
+### 6. Mettre l'app en ligne (lien public)
+**Hugging Face Spaces (gratuit) :**
+1. Crée un compte sur https://huggingface.co puis *New Space* → nom `grapp`, SDK **Streamlit**, matériel *CPU basic (free)*.
+2. Onglet *Files* → *Upload files* : glisse **tout le contenu** du dossier GRAPP (dossiers compris), puis *Commit*.
+3. Attends 3 à 5 minutes (construction). Ton lien : `https://huggingface.co/spaces/<ton-pseudo>/grapp`.
+
+Le bloc `---` en haut de ce README et le fichier `packages.txt` (qui installe Tesseract) servent à Hugging Face.
+
+**Alternative, Streamlit Community Cloud :** mets le dossier sur GitHub, puis https://share.streamlit.io → *Create app* → choisis le dépôt et `app.py`.
+
+> En ligne, les favoris sont partagés par tous les visiteurs et remis à zéro à chaque redémarrage.
+
+---
+
+## 🗂️ Contenu du projet
+```
+app.py                       Interface Streamlit (charte graphique du dossier PFE)
+grapp/engine.py              Moteur de recommandation, embeddings, Dico Vino
+grapp/carte.py               OCR de la carte + correspondance floue + prix
+data/vins.csv                75 profils de vins par appellation (couleur, bulles, sucre, corps, acidité, tanins, arômes, accords, prix)
+data/dico.csv                34 définitions du Dico Vino
+assets/carte_exemple.png     Carte des vins fictive pour la démo
+scripts/build_dataset.py     Régénère data/vins.csv
+scripts/generer_carte_exemple.py  Régénère la carte d'exemple
+scripts/enrichir_kaggle.py   Enrichissement optionnel avec Wine Reviews (Kaggle)
+tests/test_grapp.py          Tests automatiques
+SOURCES.md                   Bibliothèques, modèles, données et sources citées
+PROMPTS.md                   Où et comment l'IA générative a été utilisée, avec les prompts
+```
+
+## Limites
+- La base contient des **profils typiques d'appellation** (75), pas chaque domaine : deux vins d'une même appellation peuvent différer.
+- Les prix sont **indicatifs** (France, caviste) ; GRAPP utilise le prix de la carte quand il le lit.
+- À consommer avec modération. L'abus d'alcool est dangereux pour la santé. App réservée aux 18 ans et plus.

SOURCES.md

@@ -0,0 +1,31 @@
+# Sources, bibliothèques et données
+
+## Bibliothèques (open source, Python)
+| Outil | Usage | Lien |
+|---|---|---|
+| Streamlit | Interface web | https://github.com/streamlit/streamlit |
+| sentence-transformers | Embeddings de phrases | https://github.com/UKPLab/sentence-transformers |
+| scikit-learn | TF-IDF (repli hors ligne) | https://github.com/scikit-learn/scikit-learn |
+| pandas / NumPy | Données, calcul vectoriel | https://pandas.pydata.org · https://numpy.org |
+| Tesseract OCR | Lecture de la photo de la carte | https://github.com/tesseract-ocr/tesseract |
+| pytesseract | Lien Python ↔ Tesseract | https://github.com/madmaze/pytesseract |
+| Pillow | Images | https://github.com/python-pillow/Pillow |
+| difflib (bibliothèque standard) | Correspondance floue | https://docs.python.org/3/library/difflib.html |
+
+## Modèle Hugging Face
+- `sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2` (Reimers & Gurevych, 2019-2020, licence Apache 2.0)
+  https://huggingface.co/sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2
+
+## Données
+- `data/vins.csv` et `data/dico.csv` : constitués pour le projet (profils typiques d'appellation et définitions),
+  rédigés avec l'aide d'une IA générative (voir PROMPTS.md) puis relus. Références publiques utilisées pour les profils :
+  INAO, fiches des appellations (https://www.inao.gouv.fr) ; Vin & Société / interprofessions (Vins de Bordeaux,
+  Vins du Val de Loire, BIVB Bourgogne, Inter Rhône, Vins d'Alsace).
+- Optionnel : Kaggle *Wine Reviews* (zynicide, avis Wine Enthusiast, 130 k vins), https://www.kaggle.com/datasets/zynicide/wine-reviews
+- `assets/carte_exemple.png` : carte fictive générée par `scripts/generer_carte_exemple.py`.
+
+## Chiffres du contexte (dossier PFE de Manon Thomas, ECV Paris 2025)
+- Baisse de 70 % de la consommation de vin des Français en 60 ans ; 1 exploitation agricole sur 5 avec une activité
+  viticole ; le vin = 15 % de la production agricole française en valeur.
+- Concept, nom, ton de voix, palette (#FF5F8A #7D1C4F #F5472C #F4C4B6 #FAEFE7 #D5B5D2) et parcours (Tchin Tchin / Mes p'tits favoris / Dico Vino) : Manon Thomas.
+- Applications concurrentes étudiées : Vivino, Oeni, Vinidaily.

app.py

@@ -0,0 +1,267 @@
+"""GRAPP — L'app pour choisir ton vin sans te prendre la grappe.
+
+Lancer :  streamlit run app.py
+"""
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import pandas as pd
+import streamlit as st
+from PIL import Image
+
+from grapp.carte import ocr_image, trouver_vins
+from grapp.engine import FAMILLES, OCCASIONS, DicoVino, Grapp, Preferences
+
+ROOT = Path(__file__).resolve().parent
+FAV_FILE = ROOT / "data" / "favoris.json"
+EMOJI = {"rouge": "🍷", "blanc": "🥂", "rose": "🌸"}
+
+st.set_page_config(page_title="GRAPP", page_icon="🍇", layout="centered")
+
+# ------------------------------------------------- charte graphique (dossier PFE)
+st.markdown("""
+<style>
+:root { --rose:#FF5F8A; --prune:#7D1C4F; --corail:#F5472C; --peche:#F4C4B6;
+        --creme:#FAEFE7; --lilas:#D5B5D2; }
+.stApp { background: var(--creme); }
+h1, h2, h3 { color: var(--prune) !important; font-style: italic; letter-spacing: -.5px; }
+.grapp-logo { font-size: 3.2rem; font-weight: 900; font-style: italic; color: var(--prune);
+              line-height: 1; margin: 0; }
+.grapp-tag { color: var(--rose); font-weight: 700; margin-top: .2rem; }
+.card { background: white; border-radius: 18px; padding: 1rem 1.2rem; margin-bottom: .8rem;
+        border: 3px solid var(--prune); box-shadow: 5px 5px 0 var(--rose); }
+.card h4 { margin: 0; color: var(--prune); font-size: 1.3rem; text-transform: uppercase; }
+.match { float: right; background: var(--corail); color: white; font-weight: 800;
+         border-radius: 999px; padding: .2rem .7rem; }
+.pitch { font-style: italic; color: #444; margin: .3rem 0; }
+.chip { display: inline-block; background: var(--peche); color: var(--prune); border-radius: 999px;
+        padding: .1rem .6rem; margin: .15rem .2rem 0 0; font-size: .82rem; font-weight: 600; }
+.stButton > button { border-radius: 999px; border: 2px solid var(--prune); color: var(--prune);
+                     font-weight: 700; }
+.stButton > button[kind="primary"] { background: var(--rose); border-color: var(--rose); color: white; }
+</style>
+""", unsafe_allow_html=True)
+
+
+# ------------------------------------------------- chargement (mis en cache)
+@st.cache_resource(show_spinner="On réveille le sommelier IA… 🍇")
+def moteur():
+    return Grapp(), DicoVino()
+
+
+grapp, dico = moteur()
+noms = grapp.vins["nom"].tolist()
+_bk = ROOT / "data" / "bouteilles_kaggle.csv"
+BOUTEILLES = pd.read_csv(_bk) if _bk.exists() else None  # optionnel, cf. scripts/enrichir_kaggle.py
+
+
+def lire_favoris() -> list[str]:
+    try:
+        return json.loads(FAV_FILE.read_text(encoding="utf-8"))
+    except (FileNotFoundError, json.JSONDecodeError):
+        return []
+
+
+def ecrire_favoris(favs: list[str]) -> None:
+    FAV_FILE.write_text(json.dumps(favs, ensure_ascii=False, indent=2), encoding="utf-8")
+
+
+ss = st.session_state
+ss.setdefault("etape", 0)        # 0 = carte, 1..7 = quiz, 8 = résultats
+ss.setdefault("rep", {})
+ss.setdefault("carte", None)     # {nom: prix} ou None
+ss.setdefault("favoris", lire_favoris())
+
+st.markdown('<p class="grapp-logo">GRAPP’</p>'
+            '<p class="grapp-tag">L’app pour choisir ton vin sans te prendre la grappe 🍇</p>',
+            unsafe_allow_html=True)
+with st.expander("ℹ️ C'est quoi ce sommelier ?"):
+    st.caption(f"Moteur sémantique : **{grapp.embedder.backend}** · {len(noms)} vins en base · "
+               "OCR Tesseract pour lire la carte · tout tourne en local.")
+
+tab_tchin, tab_fav, tab_dico = st.tabs(["🥂 Tchin Tchin !", "💖 Mes p'tits favoris", "💡 Dico Vino"])
+
+
+# ------------------------------------------------- cartes de vin
+def carte_vin(r, cle: str):
+    v = r.vin
+    chips = "".join(f'<span class="chip">{x}</span>' for x in r.raisons)
+    st.markdown(f"""
+<div class="card"><span class="match">{r.match}% match</span>
+<h4>{EMOJI.get(v['couleur'], '🍷')} {r.nom}</h4>
+<div>{v['region']} · ~{r.prix:.0f} €</div>
+<p class="pitch">« {v['pitch']} »</p>
+<div><b>Ça sent :</b> {v['aromes']} · <b>Avec :</b> {v['accords']}</div>
+<div>{chips}</div></div>""", unsafe_allow_html=True)
+    c1, c2 = st.columns(2)
+    deja = r.nom in ss.favoris
+    if c1.button("💔 Retirer" if deja else "❤️ Mes fav", key=f"fav_{cle}"):
+        ss.favoris = [f for f in ss.favoris if f != r.nom] if deja else ss.favoris + [r.nom]
+        ecrire_favoris(ss.favoris)
+        st.rerun()
+    with c2.popover("🔁 Dans le même style"):
+        for s in grapp.similaires(r.nom):
+            st.write(f"• {s}")
+    if BOUTEILLES is not None:
+        b = BOUTEILLES[BOUTEILLES["nom"] == r.nom]
+        if not b.empty:
+            with st.expander("🍾 Vraies bouteilles bien notées (Wine Enthusiast)"):
+                for _, x in b.iterrows():
+                    st.markdown(f"**{x.bouteille}** · {x.points}/100 · {x.prix_usd:.0f} $  \n*{x.avis}*")
+
+
+# ------------------------------------------------- onglet 1 : Tchin Tchin
+QUESTIONS = [
+    ("Alors, on trinque ?", "C'est quoi le plan du jour ?", "occasion",
+     list(OCCASIONS.values())),
+    ("Verre ou bouteille ?", "Tu la joues solo ou on partage ?", "format",
+     ["Juste un p'tit verre (ou 2)", "On prend une bouteille"]),
+    ("La vie en couleur !", "T'es dans quelle team ?", "couleur",
+     ["Rouge", "Blanc", "Rosé", "Surprends-moi"]),
+    ("Plus ça pétille… ", "Un peu de pep's dans ton verre ?", "bulles",
+     ["J'adore le pétillant", "Sans bulles", "Peu importe"]),
+    ("Sucré ou pas ?", "Sois honnête, personne ne juge.", "sucre",
+     ["Sec", "Presque sec", "Une pointe de douceur", "Doux", "Team dessert"]),
+    ("Léger ou costaud ?", "Plutôt plume ou plutôt haltère ?", "corps",
+     ["Tout léger", "Léger", "Entre les deux", "Costaud", "Ultra costaud"]),
+    ("C'est parfait !", "Dernière ligne droite : tes goûts et ton budget.", "final", None),
+]
+
+
+def construire_prefs(rep: dict) -> Preferences:
+    occ = {v: k for k, v in OCCASIONS.items()}
+    return Preferences(
+        occasion=occ.get(rep.get("occasion"), "apero"),
+        format="verre" if str(rep.get("format", "")).startswith("Juste") else "bouteille",
+        couleur={"Rouge": "rouge", "Blanc": "blanc", "Rosé": "rose"}.get(rep.get("couleur"), "peu_importe"),
+        bulles={"J'adore le pétillant": "oui", "Sans bulles": "non"}.get(rep.get("bulles"), "peu_importe"),
+        sucre=QUESTIONS[4][3].index(rep.get("sucre", "Sec")) + 1,
+        corps=QUESTIONS[5][3].index(rep.get("corps", "Entre les deux")) + 1,
+        familles=[k for k, v in FAMILLES.items() if v in rep.get("familles", [])],
+        budget=float(rep.get("budget", 30)),
+        envie=rep.get("envie", ""),
+    )
+
+
+with tab_tchin:
+    e = ss.etape
+    if e == 0:
+        st.subheader("Étape 1 · Scanne la carte du resto 📸")
+        st.write("GRAPP lit la carte et ne te propose **que des vins qui y sont**. "
+                 "Pas de carte ? Pas de souci, passe directement au quiz.")
+        source = st.radio("Comment tu nous montres la carte ?",
+                          ["📷 Photo / fichier", "🧾 Carte d'exemple (démo)", "⌨️ Coller le texte"],
+                          horizontal=True)
+        texte = ""
+        if source.startswith("📷"):
+            f = st.file_uploader("Photo de la carte des vins", type=["png", "jpg", "jpeg"])
+            if f:
+                img = Image.open(f)
+                st.image(img, width=300)
+        elif source.startswith("🧾"):
+            img = Image.open(ROOT / "assets" / "carte_exemple.png")
+            st.image(img, width=300)
+        else:
+            img = None
+            texte = st.text_area("Colle ici le texte de la carte", height=160)
+        if st.button("🔍 Lire la carte", type="primary"):
+            try:
+                if not source.startswith("⌨️"):
+                    if source.startswith("📷") and not f:
+                        st.warning("Ajoute d'abord une photo 😉")
+                        st.stop()
+                    with st.spinner("L'IA déchiffre la carte…"):
+                        texte = ocr_image(img)
+                trouves = trouver_vins(texte, noms)
+            except RuntimeError as err:
+                st.error(f"Lecture impossible : {err}. Colle plutôt le texte de la carte.")
+                trouves = []
+            if trouves:
+                ss.carte = {t["nom"]: t["prix_carte"] for t in trouves}
+                ss.etape = 1
+                st.rerun()
+            elif texte:
+                st.warning("Je n'ai reconnu aucun vin de ma base sur cette carte 🤔")
+        st.divider()
+        if st.button("Pas de carte, on passe au quiz ➡️"):
+            ss.carte, ss.etape = None, 1
+            st.rerun()
+
+    elif 1 <= e <= 7:
+        if ss.carte:
+            st.success(f"🧾 {len(ss.carte)} vins repérés sur la carte : " + ", ".join(ss.carte))
+        titre, sous, cle, options = QUESTIONS[e - 1]
+        st.progress(e / 7, text=f"{e}/7")
+        st.subheader(titre)
+        st.caption(sous)
+        if options:
+            idx = options.index(ss.rep[cle]) if ss.rep.get(cle) in options else 0
+            choix = st.radio(" ", options, index=idx, key=f"q{e}", label_visibility="collapsed")
+        else:
+            fam = st.multiselect("Les saveurs qui te font kiffer", list(FAMILLES.values()),
+                                 default=ss.rep.get("familles", []))
+            fmt = "le verre" if str(ss.rep.get("format", "")).startswith("Juste") else "la bouteille"
+            bud = st.slider(f"Budget max pour {fmt} (€)", 3, 80,
+                            int(ss.rep.get("budget", 8 if fmt == "le verre" else 30)))
+            env = st.text_input("Ton envie en une phrase (facultatif)",
+                                value=ss.rep.get("envie", ""),
+                                placeholder="ex : un truc frais pour un barbecue entre potes")
+        c1, c2 = st.columns(2)
+        if c1.button("⬅️ Retour"):
+            ss.etape -= 1
+            st.rerun()
+        if c2.button("Suivant ➡️" if e < 7 else "🍇 Trouve mon vin !", type="primary"):
+            if options:
+                ss.rep[cle] = choix
+            else:
+                ss.rep.update(familles=fam, budget=bud, envie=env)
+            ss.etape += 1
+            st.rerun()
+
+    else:
+        prefs = construire_prefs(ss.rep)
+        recos = grapp.recommander(prefs, k=3, carte=ss.carte)
+        st.subheader("Plus qu'à kiffer ✨")
+        if not recos:
+            st.warning("Aucun vin ne colle à 100 % à tes critères"
+                       + (" sur cette carte" if ss.carte else "") + ". Essaie « Surprends-moi » ou « Peu importe » !")
+        for i, r in enumerate(recos):
+            carte_vin(r, f"reco{i}")
+        if st.button("🔄 Recommencer"):
+            ss.etape, ss.rep, ss.carte = 0, {}, None
+            st.rerun()
+
+
+# ------------------------------------------------- onglet 2 : favoris
+with tab_fav:
+    st.subheader("Mes vins pépites 💖")
+    if not ss.favoris:
+        st.info("Pas encore de favori. Fais le quiz et clique sur ❤️ !")
+    for nom in ss.favoris:
+        v = grapp.vins[grapp.vins["nom"] == nom]
+        if v.empty:
+            continue
+        v = v.iloc[0]
+        c1, c2 = st.columns([4, 1])
+        c1.markdown(f"**{EMOJI.get(v.couleur, '🍷')} {nom}** · {v.region} · ~{v.prix_bouteille} €  \n"
+                    f"*{v.pitch}*  \n🔁 Si tu aimes, essaie : {', '.join(grapp.similaires(nom))}")
+        if c2.button("🗑️", key=f"del_{nom}"):
+            ss.favoris.remove(nom)
+            ecrire_favoris(ss.favoris)
+            st.rerun()
+
+
+# ------------------------------------------------- onglet 3 : Dico Vino
+with tab_dico:
+    st.subheader("Je décrypte le vin ! 💡")
+    st.write("Un mot bizarre sur la carte ? Pose ta question comme tu veux.")
+    q = st.text_input("Ta question", placeholder="ex : pourquoi j'ai la bouche qui gratte avec ce rouge ?")
+    if q:
+        for _, d in dico.chercher(q).iterrows():
+            st.markdown(f'<div class="card"><h4>{d.terme}</h4><p>{d.definition}</p>'
+                        f'<p class="pitch">👉 {d.exemple}</p></div>', unsafe_allow_html=True)
+    with st.expander("📖 Tout le dico"):
+        for _, d in dico.df.sort_values("terme").iterrows():
+            st.markdown(f"**{d.terme}** : {d.definition}")

data/dico.csv

@@ -0,0 +1,35 @@
+terme,definition,exemple
+Tanins,"Ce qui assèche la bouche, comme un thé trop infusé. Vient de la peau et des pépins du raisin, surtout dans les rouges.","Un Cahors a beaucoup de tanins, un Beaujolais très peu."
+Sec,"Pas de sucre qu'on sent. Rien à voir avec un vin qui « assèche » : ça, ce sont les tanins.","Un Chablis est sec."
+Moelleux,"Un peu sucré, mais pas autant qu'un liquoreux.","Un Vouvray moelleux avec une tarte aux pommes."
+Liquoreux,"Très sucré, presque comme du miel. Souvent servi avec le dessert ou le foie gras.","Le Sauternes est le liquoreux star."
+Corps,"La sensation de poids en bouche : léger comme de l'eau ou épais comme du lait entier.","Un Châteauneuf-du-Pape a beaucoup de corps."
+Acidité,"Ce qui fait saliver et donne de la fraîcheur, comme un citron.","Le Muscadet est très acide, donc très frais."
+Cépage,"La variété de raisin, comme les variétés de pommes (Golden, Granny…).","Pinot Noir, Chardonnay, Syrah sont des cépages."
+Appellation (AOP),"Le nom d'un lieu protégé avec des règles de production. Le vin porte le nom du coin, pas du raisin.","Sancerre est une appellation, son cépage est le Sauvignon."
+Millésime,"L'année de la récolte du raisin, écrite sur l'étiquette.","Un Bordeaux 2020."
+Robe,"La couleur du vin quand tu regardes ton verre.","Robe rubis, robe dorée…"
+Nez,"Les odeurs du vin quand tu le sens avant de boire.","Ce rosé a un nez de pêche."
+Bouche,"Ce que tu ressens quand le vin est dans ta bouche : goût, texture, longueur.","Une bouche ronde et fruitée."
+Longueur,"Le temps pendant lequel le goût reste après avoir avalé. Plus c'est long, plus c'est souvent qualitatif.","On dit aussi « caudalies » (1 caudalie = 1 seconde)."
+Minéral,"Une sensation de pierre mouillée, de craie ou de coquillage. Fréquent dans les blancs frais.","Chablis et Sancerre sont très minéraux."
+Boisé,"Des arômes de vanille, de toast ou de bois, qui viennent de l'élevage en fût de chêne.","Un Saint-Émilion souvent boisé."
+Fût de chêne,"Le tonneau en bois où certains vins vieillissent. Il apporte vanille, toasté et rondeur.","Le Meursault est élevé en fût."
+Brut,"Pour les bulles : très peu de sucre. Le plus courant.","Champagne Brut."
+Demi-sec,"Pour les bulles : assez sucré, parfait avec le dessert.","Champagne demi-sec avec le gâteau d'anniversaire."
+Crémant,"Un vin effervescent fait comme le Champagne, mais ailleurs (Loire, Alsace, Bourgogne…) et souvent moins cher.","Crémant de Loire."
+Pet'Nat,"Pétillant naturel : bulles obtenues en une seule fermentation en bouteille. Souvent trouble et funky.","Un Pet'Nat rosé pour l'apéro."
+Vin nature,"Vin fait avec un minimum d'intervention : raisins bio, pas ou peu de sulfites ajoutés.","Un Gamay nature glou-glou."
+Glou-glou,"Un vin léger et fruité qui se boit très facilement.","Un Beaujolais bien frais, c'est glou-glou."
+Sulfites,"Un conservateur (SO2) utilisé presque partout pour protéger le vin.","« Contient des sulfites » sur l'étiquette."
+Carafer,"Verser le vin dans une carafe pour qu'il prenne l'air et s'ouvre.","On carafe un jeune Madiran."
+Bouchonné,"Défaut : le vin sent le carton mouillé ou la cave humide. Tu peux le renvoyer au resto.","Le serveur te fait goûter pour vérifier qu'il n'est pas bouchonné."
+Température de service,"Rouges légers vers 14 °C, rouges costauds vers 17 °C, blancs et rosés vers 8–10 °C, bulles vers 6–8 °C.","Un rouge trop chaud paraît lourd."
+Accord mets-vin,"Choisir un vin qui va bien avec le plat. Règle simple : plat léger, vin léger ; plat riche, vin riche.","Huîtres + Muscadet."
+Sommelier,"La personne qui conseille les vins au restaurant. Pose-lui des questions, c'est son métier !","« Je cherche un rouge léger à moins de 30 € »."
+Rosé de saignée,"Rosé obtenu en retirant du jus d'une cuve de rouge : souvent plus coloré et plus fruité.","Le Tavel est très coloré."
+Grand cru,"Le niveau le plus prestigieux d'un vignoble, surtout en Bourgogne et en Alsace. Souvent cher.","Chambertin Grand Cru."
+Fruité,"Le vin sent et a le goût de fruits : fraise, cerise, pêche, agrumes…","Un Côtes de Provence rosé très fruité."
+Épicé,"Arômes de poivre, de clou de girofle ou de réglisse.","La Syrah du Rhône est poivrée."
+Rond,"Doux et souple en bouche, sans angles : peu d'acidité et peu de tanins.","Un Merlot rond."
+Vif,"Beaucoup d'acidité et de fraîcheur : ça réveille !","Un Sancerre vif."

data/vins.csv

@@ -0,0 +1,76 @@
+nom,region,couleur,bulles,sucre,corps,acidite,tanins,aromes,famille,accords,occasion,prix_bouteille,prix_verre,pitch
+Beaujolais-Villages,Beaujolais,rouge,0,1,2,3,1,fraise cerise bonbon framboise,fruite,charcuterie pizza apéro,apero,11,5,Le rouge qui se boit comme du jus de fruits (mais pour adultes).
+Morgon,Beaujolais,rouge,0,1,3,3,2,cerise noire kirsch violette,fruite,volaille burger,repas,15,6,Le Beaujolais qui a fait de la muscu.
+Fleurie,Beaujolais,rouge,0,1,2,3,1,violette pivoine framboise,floral,saumon salade quiche,apero,15,6,Un bouquet de fleurs dans ton verre.
+Bourgogne Pinot Noir,Bourgogne,rouge,0,1,2,4,2,cerise griotte sous-bois,fruite,volaille champignons,repas,18,7,Le classique chic mais pas prise de tête.
+Gevrey-Chambertin,Bourgogne,rouge,0,1,4,4,3,cassis réglisse sous-bois cuir,boise,boeuf bourguignon gibier,grande_occasion,45,14,Pour impressionner belle-maman.
+Mercurey,Bourgogne,rouge,0,1,3,3,3,fruits rouges épices douces,fruite,veau fromage,repas,22,8,"Bourgogne qualité, prix sympa."
+Côtes du Rhône,Vallée du Rhône,rouge,0,1,3,3,3,fruits noirs poivre garrigue,epice,barbecue pâtes bolo,repas,9,5,Le pote fiable de toutes tes soirées.
+Crozes-Hermitage,Vallée du Rhône,rouge,0,1,3,3,3,mûre poivre noir violette,epice,grillades agneau,repas,17,7,"Syrah poivrée, caractère assumé."
+Châteauneuf-du-Pape,Vallée du Rhône,rouge,0,1,5,2,4,fruits confits garrigue réglisse,epice,daube gibier,grande_occasion,40,13,Le soleil du Sud en mode XXL.
+Gigondas,Vallée du Rhône,rouge,0,1,4,2,4,cerise noire épices cacao,epice,agneau ragoût,repas,25,9,Puissant et généreux comme un câlin.
+Vacqueyras,Vallée du Rhône,rouge,0,1,4,3,3,fruits noirs thym poivre,epice,côte de boeuf,repas,18,7,Costaud mais pas bourrin.
+Bordeaux Supérieur,Bordeaux,rouge,0,1,3,3,4,cassis prune boisé léger,boise,entrecôte fromage,repas,12,6,Le Bordeaux accessible qui ne fait pas peur.
+Saint-Émilion,Bordeaux,rouge,0,1,4,3,3,prune vanille chocolat,boise,magret canard,grande_occasion,28,10,"Merlot velours, ambiance château."
+Pauillac,Bordeaux,rouge,0,1,5,3,5,cassis cèdre tabac,boise,agneau de lait,grande_occasion,60,18,Le boss final des rouges.
+Médoc,Bordeaux,rouge,0,1,4,3,4,cassis graphite boisé,boise,boeuf grillé,repas,16,7,"Structure béton, pour les viandeux."
+Côtes de Bourg,Bordeaux,rouge,0,1,3,3,3,fruits rouges réglisse,fruite,burger pâtes,repas,10,5,"Petit prix, grosse ambiance."
+Chinon,Val de Loire,rouge,0,1,2,4,2,framboise poivron violette,fruite,charcuterie rillettes,apero,13,6,Le rouge frais à servir un peu frais.
+Saumur-Champigny,Val de Loire,rouge,0,1,2,4,2,fruits rouges croquants,fruite,volaille tartes salées,apero,13,6,Croquant comme une fraise des bois.
+Bourgueil,Val de Loire,rouge,0,1,3,4,3,cassis framboise graphite,fruite,porc grillades,repas,13,6,Cabernet franc qui a du peps.
+Cahors,Sud-Ouest,rouge,0,1,5,3,5,mûre prune réglisse,epice,cassoulet confit,repas,14,6,Le vin noir. Ultra costaud.
+Madiran,Sud-Ouest,rouge,0,1,5,3,5,fruits noirs épices cacao,epice,magret garbure,repas,15,6,Tanins de rugbyman.
+Marcillac,Sud-Ouest,rouge,0,1,2,4,2,cassis poivre framboise,fruite,charcuterie aligot,apero,12,6,Le rouge secret de l'Aveyron.
+Corbières,Languedoc,rouge,0,1,4,2,3,fruits noirs garrigue laurier,epice,barbecue tajine,repas,10,5,Le Sud qui sent la garrigue.
+Pic Saint-Loup,Languedoc,rouge,0,1,4,3,3,mûre thym poivre,epice,agneau grillé,repas,18,7,Le Languedoc version premium.
+Minervois,Languedoc,rouge,0,1,3,2,3,cerise épices réglisse,epice,pizza grillades,repas,11,5,"Soleil en bouteille, prix mini."
+Bandol rouge,Provence,rouge,0,1,5,3,5,mûre cuir garrigue,epice,daube agneau,grande_occasion,30,11,Mourvèdre de caractère.
+Alsace Pinot Noir,Alsace,rouge,0,1,1,4,1,cerise fraise légère,fruite,tarte flambée volaille,apero,15,6,Le rouge léger comme une plume.
+Corse Vin rouge,Corse,rouge,0,1,3,3,3,maquis fruits rouges,epice,charcuterie corse,repas,15,6,Le maquis dans ton verre.
+Vin nature Gamay,Divers,rouge,0,1,1,4,1,fruits rouges croquants bonbon,fruite,apéro tapas,apero,16,7,"Glou-glou nature, à boire frais."
+Côtes de Provence rosé,Provence,rose,0,1,2,3,1,pêche agrumes groseille,fruite,salade grillades apéro,apero,13,6,Le rosé pâle de l'été en terrasse.
+Tavel,Vallée du Rhône,rose,0,1,3,3,2,fraise épices cerise,fruite,cuisine asiatique paella,repas,15,6,Le rosé qui se prend pour un rouge.
+Bandol rosé,Provence,rose,0,1,3,3,1,agrumes pêche épices,fruite,bouillabaisse poisson grillé,repas,22,8,Le rosé chic de la Riviera.
+Rosé d'Anjou,Val de Loire,rose,0,3,1,3,1,bonbon fraise framboise,gourmand,apéro dessert fruits,apero,8,4,"Doux et fruité, le rosé bonbon."
+Cabernet d'Anjou,Val de Loire,rose,0,3,2,3,1,fraise framboise sucre d'orge,gourmand,cuisine épicée apéro,apero,9,4,"Rosé gourmand, légèrement sucré."
+Pays d'Oc rosé,Languedoc,rose,0,1,2,3,1,fruits rouges agrumes,fruite,barbecue pique-nique,apero,7,4,"Petit budget, grand soleil."
+Chablis,Bourgogne,blanc,0,1,2,5,1,citron pierre à fusil iode,mineral,huîtres sushis,repas,20,8,"Ultra frais, comme une vague."
+Mâcon-Villages,Bourgogne,blanc,0,1,2,3,1,pomme beurre fleurs blanches,fruite,poisson volaille,apero,12,6,Chardonnay facile et rond.
+Meursault,Bourgogne,blanc,0,1,4,3,1,beurre noisette brioche,boise,homard volaille crème,grande_occasion,50,15,Le blanc beurré de luxe.
+Pouilly-Fuissé,Bourgogne,blanc,0,1,3,3,1,agrumes amande grillée,boise,poisson sauce,repas,28,10,Chardonnay riche et élégant.
+Sancerre,Val de Loire,blanc,0,1,2,5,1,pamplemousse buis silex,mineral,chèvre poisson,repas,22,8,"Vif, net, sans bavure."
+Pouilly-Fumé,Val de Loire,blanc,0,1,2,5,1,agrumes pierre à fusil fumé,mineral,saint-jacques chèvre,repas,22,8,Sauvignon fumé de caractère.
+Muscadet Sèvre-et-Maine,Val de Loire,blanc,0,1,1,5,1,citron iode pomme verte,mineral,huîtres moules,apero,9,5,L'ami des fruits de mer à petit prix.
+Vouvray sec,Val de Loire,blanc,0,1,2,4,1,coing pomme miel,fruite,poisson cuisine asiatique,repas,14,6,Chenin croquant et pomme.
+Vouvray moelleux,Val de Loire,blanc,0,4,3,4,1,miel coing abricot,gourmand,foie gras tarte aux pommes,dessert,18,7,"Doux mais frais, pas écœurant."
+Touraine Sauvignon,Val de Loire,blanc,0,1,1,4,1,agrumes groseille herbe coupée,fruite,apéro salade chèvre,apero,9,5,Le blanc qui réveille.
+Entre-deux-Mers,Bordeaux,blanc,0,1,1,4,1,agrumes fleurs blanches,fruite,poisson apéro,apero,8,4,"Frais et pas cher, validé."
+Sauternes,Bordeaux,blanc,0,5,4,3,1,miel abricot safran,gourmand,foie gras roquefort dessert,dessert,35,12,"Le blanc liquoreux, du miel en bouteille."
+Pessac-Léognan blanc,Bordeaux,blanc,0,1,3,4,1,agrumes boisé fumé,boise,poisson noble,grande_occasion,35,12,Bordeaux blanc grand style.
+Alsace Riesling,Alsace,blanc,0,1,2,5,1,citron vert pétrole léger minéral,mineral,choucroute poisson,repas,14,6,Tranchant comme un laser.
+Alsace Gewurztraminer,Alsace,blanc,0,3,3,2,1,litchi rose épices,floral,cuisine asiatique munster,repas,15,6,"Litchi et rose, très parfumé."
+Alsace Pinot Gris,Alsace,blanc,0,2,3,3,1,poire fumé miel,gourmand,volaille foie gras,repas,15,6,"Rond, un peu fumé, très doux."
+Viognier Pays d'Oc,Languedoc,blanc,0,1,3,2,1,abricot pêche fleurs,floral,curry poulet,apero,10,5,"Parfum d'abricot, très solaire."
+Condrieu,Vallée du Rhône,blanc,0,1,4,2,1,abricot violette pêche,floral,poisson crème,grande_occasion,45,14,Le Viognier haute couture.
+Picpoul de Pinet,Languedoc,blanc,0,1,1,5,1,citron iode fleurs,mineral,huîtres tapas,apero,9,5,Le blanc de la mer du Sud.
+Jurançon sec,Sud-Ouest,blanc,0,1,2,5,1,fruits exotiques agrumes,fruite,poisson cuisine épicée,repas,14,6,Exotique et vif.
+Jurançon moelleux,Sud-Ouest,blanc,0,4,3,4,1,mangue ananas miel,gourmand,dessert fruits foie gras,dessert,18,7,"Ananas et mangue, en mode dessert."
+Côtes de Gascogne blanc,Sud-Ouest,blanc,0,2,1,4,1,pamplemousse fruits exotiques,fruite,apéro salade,apero,7,4,Le blanc tropical à mini prix.
+Vin jaune,Jura,blanc,0,1,4,4,1,noix curry épices,epice,comté poulet aux morilles,grande_occasion,40,13,OVNI du vin : noix et curry.
+Muscat de Beaumes-de-Venise,Vallée du Rhône,blanc,0,5,3,2,1,raisin frais orange fleurs,gourmand,dessert chocolat blanc,dessert,16,6,Comme croquer du raisin sucré.
+Champagne Brut,Champagne,blanc,1,1,2,5,1,brioche pomme agrumes,fruite,apéro sushis tout,grande_occasion,35,12,"Les bulles de la fête, obligées."
+Champagne Rosé,Champagne,rose,1,1,2,4,1,fraise framboise brioche,fruite,apéro dessert fruits rouges,grande_occasion,45,14,Bulles + rose = combo parfait.
+Champagne Demi-sec,Champagne,blanc,1,3,2,4,1,fruits blancs miel brioche,gourmand,dessert gâteau,dessert,35,12,Bulles douces pour le gâteau.
+Crémant de Loire,Val de Loire,blanc,1,1,2,4,1,pomme verte fleurs,fruite,apéro,apero,12,5,Les bulles du Champagne sans le prix.
+Crémant d'Alsace,Alsace,blanc,1,1,2,4,1,agrumes pomme brioche,fruite,apéro tarte flambée,apero,12,5,"Bulles fines, budget mini."
+Crémant de Bourgogne rosé,Bourgogne,rose,1,1,2,4,1,fruits rouges croquants,fruite,apéro,apero,14,6,Bulles roses pour trinquer.
+Clairette de Die,Vallée du Rhône,blanc,1,4,1,3,1,muscat raisin rose,gourmand,dessert brunch,dessert,11,5,"Bulles sucrées et légères, très fun."
+Blanquette de Limoux,Languedoc,blanc,1,1,2,4,1,pomme verte fleurs,fruite,apéro,apero,11,5,Les plus vieilles bulles de France.
+Pétillant naturel (Pet'Nat),Divers,rose,1,2,1,4,1,fruits rouges acidulés,fruite,apéro pique-nique,apero,15,6,"Bulles nature, funky et acidulées."
+Prosecco,Italie,blanc,1,2,1,3,1,poire pomme fleurs,fruite,apéro spritz,apero,10,5,Bulles italiennes légères.
+Cava,Espagne,blanc,1,1,2,4,1,agrumes amande,fruite,tapas apéro,apero,10,5,"Bulles espagnoles, olé."
+Rioja,Espagne,rouge,0,1,4,3,3,cerise vanille cuir,boise,tapas chorizo,repas,14,6,Le rouge espagnol vanillé.
+Chianti,Italie,rouge,0,1,3,4,3,cerise tomate herbes,fruite,pizza pâtes,repas,13,6,Celui qui va avec ta pizza.
+Malbec argentin,Argentine,rouge,0,1,4,3,3,mûre prune violette,fruite,burger asado,repas,13,6,"Gros fruit, ultra facile."
+Pinot Grigio,Italie,blanc,0,1,1,3,1,poire citron,fruite,apéro salade,apero,9,5,"Léger, neutre, safe."
+Porto Tawny,Portugal,rouge,0,5,4,3,2,noix caramel figue,gourmand,chocolat fromage,dessert,20,6,"Caramel et noix, pour finir la soirée."

grapp/carte.py

@@ -0,0 +1,72 @@
+"""Étape 1 de GRAPP : lire la carte des vins du resto (photo ou texte).
+
+- OCR : Tesseract via `pytesseract` (moteur open source, GitHub tesseract-ocr).
+- Ensuite on retrouve, ligne par ligne, les vins de la carte qui existent dans
+  notre base (correspondance floue tolérante aux fautes d'OCR, via difflib),
+  et on récupère le prix écrit sur la ligne s'il y en a un.
+"""
+from __future__ import annotations
+
+import re
+from difflib import SequenceMatcher
+
+from .engine import normaliser
+
+PRIX = re.compile(r"(\d{1,3}(?:[.,]\d{1,2})?)\s*(?:€|eur)", re.I)
+PRIX_FIN = re.compile(r"(\d{1,3}(?:[.,]\d{1,2})?)\s*$")
+# mots trop génériques pour identifier un vin à eux seuls
+VIDES = {"vin", "de", "du", "des", "la", "le", "d", "rouge", "blanc", "rose",
+         "brut", "sec", "pays", "oc", "aop", "igp", "cotes", "villages"}
+
+
+def ocr_image(image) -> str:
+    """Renvoie le texte d'une image PIL. Lève RuntimeError si Tesseract manque."""
+    try:
+        import pytesseract
+        from PIL import ImageOps
+    except ImportError as e:  # pragma: no cover
+        raise RuntimeError("pytesseract n'est pas installé") from e
+    img = ImageOps.grayscale(image)
+    if img.width < 1500:  # l'OCR aime les grandes images
+        f = 1500 / img.width
+        img = img.resize((int(img.width * f), int(img.height * f)))
+    try:
+        langues = pytesseract.get_languages(config="")
+    except Exception as e:
+        raise RuntimeError("Tesseract n'est pas installé sur cet ordinateur") from e
+    lang = "fra" if "fra" in langues else "eng"
+    return pytesseract.image_to_string(img, lang=lang, config="--psm 6")
+
+
+def _score(ligne: str, nom: str) -> float:
+    """Proximité entre une ligne de carte et un nom de vin (0 à 1)."""
+    n = normaliser(nom)
+    if n and n in ligne:
+        return 1.0
+    mots = [m for m in n.split() if m not in VIDES and len(m) > 2]
+    if not mots:
+        return 0.0
+    toks = ligne.split()
+    trouves = 0
+    for m in mots:
+        best = max((SequenceMatcher(None, m, t).ratio() for t in toks), default=0)
+        trouves += best >= 0.8
+    return trouves / len(mots)
+
+
+def trouver_vins(texte: str, noms: list[str], seuil: float = 0.99) -> list[dict]:
+    """Associe chaque ligne du texte de la carte au meilleur vin de la base."""
+    resultats, deja = [], set()
+    for brute in texte.splitlines():
+        ligne = normaliser(brute)
+        if len(ligne) < 4:
+            continue
+        scores = sorted(((_score(ligne, n), SequenceMatcher(None, normaliser(n), ligne).ratio(), n)
+                         for n in noms), reverse=True)
+        s, _, nom = scores[0]
+        if s >= seuil and nom not in deja:
+            m = PRIX.search(brute) or PRIX_FIN.search(brute.strip())
+            prix = float(m.group(1).replace(",", ".")) if m else None
+            resultats.append({"nom": nom, "ligne": brute.strip(), "prix_carte": prix})
+            deja.add(nom)
+    return resultats

grapp/engine.py

@@ -0,0 +1,209 @@
+"""Moteur de recommandation GRAPP.
+
+Score hybride pour chaque vin :
+  1. un score "profil" à partir des réponses au quiz (couleur, bulles, sucre,
+     corps, famille d'arômes, occasion, budget) ;
+  2. un score "sémantique" entre la phrase libre de l'utilisateur
+     (« un truc frais pour un barbecue entre potes ») et la fiche du vin,
+     calculé avec des embeddings de phrases.
+
+Embeddings : si `sentence-transformers` est installé, on utilise le modèle
+multilingue Hugging Face `paraphrase-multilingual-MiniLM-L12-v2`. Sinon, on
+retombe sur un TF-IDF en n-grammes de caractères (scikit-learn), qui marche
+hors ligne. L'app fonctionne donc dans les deux cas.
+"""
+from __future__ import annotations
+
+import unicodedata
+from dataclasses import dataclass, field
+from pathlib import Path
+
+import numpy as np
+import pandas as pd
+
+DATA_DIR = Path(__file__).resolve().parents[1] / "data"
+HF_MODEL = "sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2"
+
+FAMILLES = {
+    "fruite": "Fruité 🍓",
+    "floral": "Floral 🌸",
+    "epice": "Épicé 🌶️",
+    "boise": "Boisé / vanillé 🪵",
+    "mineral": "Frais et minéral 🌊",
+    "gourmand": "Gourmand / sucré 🍯",
+}
+OCCASIONS = {
+    "apero": "Apéro entre potes",
+    "repas": "Avec un bon repas",
+    "dessert": "Pour le dessert",
+    "grande_occasion": "Grosse occasion",
+}
+
+
+def normaliser(texte: str) -> str:
+    """Minuscules, sans accents ni ponctuation (pour comparer des textes)."""
+    t = unicodedata.normalize("NFKD", str(texte)).encode("ascii", "ignore").decode()
+    t = "".join(c if c.isalnum() else " " for c in t.lower())
+    return " ".join(t.split())
+
+
+def charger_vins(path: Path | None = None) -> pd.DataFrame:
+    df = pd.read_csv(path or DATA_DIR / "vins.csv")
+    df["fiche"] = (
+        df["nom"] + ". " + df["couleur"] + " " + df["region"] + ". Arômes : "
+        + df["aromes"] + ". Accords : " + df["accords"] + ". " + df["pitch"]
+    )
+    return df
+
+
+# ---------------------------------------------------------------- embeddings
+class Embedder:
+    """Transforme des textes en vecteurs normalisés (cosinus = produit scalaire)."""
+
+    def __init__(self, corpus: list[str], use_hf: bool = True):
+        self.backend = "tfidf"
+        self._model = None
+        if use_hf:
+            try:
+                from sentence_transformers import SentenceTransformer
+
+                self._model = SentenceTransformer(HF_MODEL)
+                self.backend = "huggingface"
+            except Exception:  # pas installé, pas de réseau, etc.
+                self._model = None
+        if self._model is None:
+            from sklearn.feature_extraction.text import TfidfVectorizer
+
+            self._tfidf = TfidfVectorizer(
+                analyzer="char_wb", ngram_range=(3, 5), preprocessor=normaliser
+            ).fit(corpus)
+
+    def encode(self, textes: list[str]) -> np.ndarray:
+        if self._model is not None:
+            return np.asarray(
+                self._model.encode(textes, normalize_embeddings=True), dtype=float
+            )
+        m = self._tfidf.transform(textes).toarray()
+        n = np.linalg.norm(m, axis=1, keepdims=True)
+        return m / np.where(n == 0, 1, n)
+
+
+# ------------------------------------------------------------------ quiz
+@dataclass
+class Preferences:
+    format: str = "verre"          # verre | bouteille
+    couleur: str = "peu_importe"   # rouge | blanc | rose | peu_importe
+    bulles: str = "peu_importe"    # oui | non | peu_importe
+    sucre: int = 1                 # 1 sec … 5 bien sucré
+    corps: int = 3                 # 1 léger … 5 costaud
+    familles: list[str] = field(default_factory=list)
+    occasion: str = "apero"
+    budget: float = 30.0           # € max (pour le format choisi)
+    envie: str = ""                # phrase libre
+
+
+@dataclass
+class Reco:
+    nom: str
+    match: int
+    prix: float
+    raisons: list[str]
+    vin: dict
+
+
+class Grapp:
+    POIDS = {"sucre": 0.18, "corps": 0.18, "famille": 0.17, "occasion": 0.12,
+             "budget": 0.15, "semantique": 0.20}
+
+    def __init__(self, vins: pd.DataFrame | None = None, use_hf: bool = True):
+        self.vins = charger_vins() if vins is None else vins
+        self.embedder = Embedder(self.vins["fiche"].tolist(), use_hf=use_hf)
+        self.vecteurs = self.embedder.encode(self.vins["fiche"].tolist())
+
+    # -- filtres durs : on ne propose jamais un rouge à qui veut du blanc
+    def _filtrer(self, p: Preferences, carte: list[str] | None) -> pd.DataFrame:
+        df = self.vins
+        if p.couleur != "peu_importe":
+            df = df[df["couleur"] == p.couleur]
+        if p.bulles == "oui":
+            df = df[df["bulles"] == 1]
+        elif p.bulles == "non":
+            df = df[df["bulles"] == 0]
+        if carte:
+            df = df[df["nom"].isin(list(carte))]
+        return df
+
+    def recommander(self, p: Preferences, k: int = 5,
+                    carte: dict[str, float | None] | None = None) -> list[Reco]:
+        """`carte` = {nom du vin: prix lu sur la carte (ou None)} pour se limiter au resto."""
+        df = self._filtrer(p, carte)
+        if df.empty:
+            return []
+        col_prix = "prix_verre" if p.format == "verre" else "prix_bouteille"
+
+        sem = np.zeros(len(df))
+        if p.envie.strip():
+            q = self.embedder.encode([p.envie])[0]
+            sims = self.vecteurs[df.index.to_numpy()] @ q
+            lo, hi = sims.min(), sims.max()
+            sem = (sims - lo) / (hi - lo) if hi > lo else np.ones_like(sims)
+
+        recos = []
+        for i, (_, v) in enumerate(df.iterrows()):
+            s, raisons = {}, []
+            s["sucre"] = 1 - abs(v.sucre - p.sucre) / 4
+            s["corps"] = 1 - abs(v.corps - p.corps) / 4
+            s["famille"] = 1.0 if not p.familles or v.famille in p.familles else 0.25
+            s["occasion"] = 1.0 if v.occasion == p.occasion else 0.4
+            prix = float(v[col_prix])
+            if carte and carte.get(v.nom):
+                prix = float(carte[v.nom])  # le vrai prix du resto
+            s["budget"] = 1.0 if prix <= p.budget else max(0.0, 1 - (prix - p.budget) / p.budget)
+            s["semantique"] = float(sem[i]) if p.envie.strip() else 0.5
+
+            if s["sucre"] >= 0.75:
+                raisons.append({1: "Sec, comme tu aimes", 2: "Presque sec",
+                                3: "Une pointe de douceur", 4: "Doux comme demandé",
+                                5: "Bien sucré, team gourmand"}[int(v.sucre)])
+            if s["corps"] >= 0.75:
+                raisons.append("Léger et facile" if v.corps <= 2 else
+                               "Équilibré" if v.corps == 3 else "Costaud, du caractère")
+            if p.familles and v.famille in p.familles:
+                raisons.append(f"Profil {FAMILLES[v.famille]}")
+            if v.occasion == p.occasion:
+                raisons.append(f"Parfait pour : {OCCASIONS[v.occasion].lower()}")
+            if prix <= p.budget:
+                unite = "le verre" if p.format == "verre" else "la bouteille"
+                raisons.append(f"Dans ton budget ({prix:.0f} € {unite})")
+            if p.envie.strip() and s["semantique"] >= 0.7:
+                raisons.append("Colle à ton envie du moment")
+
+            score = sum(self.POIDS[c] * s[c] for c in self.POIDS)
+            recos.append(Reco(v.nom, round(100 * score), prix, raisons, v.to_dict()))
+        recos.sort(key=lambda r: r.match, reverse=True)
+        return recos[:k]
+
+    def similaires(self, nom: str, k: int = 3) -> list[str]:
+        """Vins proches d'un favori (même logique « si tu as aimé… »)."""
+        idx = self.vins.index[self.vins["nom"] == nom]
+        if idx.empty:
+            return []
+        sims = self.vecteurs @ self.vecteurs[idx[0]]
+        ordre = [j for j in np.argsort(-sims) if j != idx[0]]
+        return self.vins.iloc[ordre[:k]]["nom"].tolist()
+
+
+# ------------------------------------------------------------------ Dico Vino
+class DicoVino:
+    def __init__(self, embedder_factory=Embedder, path: Path | None = None, use_hf=True):
+        self.df = pd.read_csv(path or DATA_DIR / "dico.csv")
+        textes = (self.df["terme"] + " : " + self.df["definition"]).tolist()
+        self.embedder = embedder_factory(textes, use_hf=use_hf)
+        self.vecteurs = self.embedder.encode(textes)
+
+    def chercher(self, question: str, k: int = 3) -> pd.DataFrame:
+        exact = self.df[self.df["terme"].map(normaliser).str.contains(normaliser(question) or "§")]
+        q = self.embedder.encode([question])[0]
+        ordre = np.argsort(-(self.vecteurs @ q))[:k]
+        res = pd.concat([exact, self.df.iloc[ordre]]).drop_duplicates("terme")
+        return res.head(k)

packages.txt

@@ -0,0 +1,2 @@
+tesseract-ocr
+tesseract-ocr-fra

requirements.txt

@@ -0,0 +1,8 @@
+streamlit>=1.36
+pandas>=2.0
+numpy>=1.24
+scikit-learn>=1.3
+pillow>=10.0
+pytesseract>=0.3.10
+# IA sémantique Hugging Face (recommandé ; sans elle, GRAPP passe en mode TF-IDF)
+sentence-transformers>=2.7

scripts/build_dataset.py

@@ -0,0 +1,94 @@
+"""Construit data/vins.csv : base de profils de vins français par appellation.
+
+Profils "typiques" d'appellation (pas des avis inventés) : couleur, bulles,
+sucre, corps, acidité, tanins (échelles 1-5), arômes dominants, accords et
+fourchette de prix indicative. Rédigés avec l'aide d'un assistant IA puis
+relus à partir de sources publiques (voir SOURCES.md). À enrichir avec
+scripts/enrichir_kaggle.py (Wine Reviews, Kaggle).
+"""
+import csv, pathlib
+
+COLS = ["nom","region","couleur","bulles","sucre","corps","acidite","tanins",
+        "aromes","famille","accords","occasion","prix_bouteille","prix_verre","pitch"]
+# famille : fruite / floral / epice / boise / mineral / gourmand
+V = [
+("Beaujolais-Villages","Beaujolais","rouge",0,1,2,3,1,"fraise cerise bonbon framboise","fruite","charcuterie pizza apéro","apero",11,5,"Le rouge qui se boit comme du jus de fruits (mais pour adultes)."),
+("Morgon","Beaujolais","rouge",0,1,3,3,2,"cerise noire kirsch violette","fruite","volaille burger","repas",15,6,"Le Beaujolais qui a fait de la muscu."),
+("Fleurie","Beaujolais","rouge",0,1,2,3,1,"violette pivoine framboise","floral","saumon salade quiche","apero",15,6,"Un bouquet de fleurs dans ton verre."),
+("Bourgogne Pinot Noir","Bourgogne","rouge",0,1,2,4,2,"cerise griotte sous-bois","fruite","volaille champignons","repas",18,7,"Le classique chic mais pas prise de tête."),
+("Gevrey-Chambertin","Bourgogne","rouge",0,1,4,4,3,"cassis réglisse sous-bois cuir","boise","boeuf bourguignon gibier","grande_occasion",45,14,"Pour impressionner belle-maman."),
+("Mercurey","Bourgogne","rouge",0,1,3,3,3,"fruits rouges épices douces","fruite","veau fromage","repas",22,8,"Bourgogne qualité, prix sympa."),
+("Côtes du Rhône","Vallée du Rhône","rouge",0,1,3,3,3,"fruits noirs poivre garrigue","epice","barbecue pâtes bolo","repas",9,5,"Le pote fiable de toutes tes soirées."),
+("Crozes-Hermitage","Vallée du Rhône","rouge",0,1,3,3,3,"mûre poivre noir violette","epice","grillades agneau","repas",17,7,"Syrah poivrée, caractère assumé."),
+("Châteauneuf-du-Pape","Vallée du Rhône","rouge",0,1,5,2,4,"fruits confits garrigue réglisse","epice","daube gibier","grande_occasion",40,13,"Le soleil du Sud en mode XXL."),
+("Gigondas","Vallée du Rhône","rouge",0,1,4,2,4,"cerise noire épices cacao","epice","agneau ragoût","repas",25,9,"Puissant et généreux comme un câlin."),
+("Vacqueyras","Vallée du Rhône","rouge",0,1,4,3,3,"fruits noirs thym poivre","epice","côte de boeuf","repas",18,7,"Costaud mais pas bourrin."),
+("Bordeaux Supérieur","Bordeaux","rouge",0,1,3,3,4,"cassis prune boisé léger","boise","entrecôte fromage","repas",12,6,"Le Bordeaux accessible qui ne fait pas peur."),
+("Saint-Émilion","Bordeaux","rouge",0,1,4,3,3,"prune vanille chocolat","boise","magret canard","grande_occasion",28,10,"Merlot velours, ambiance château."),
+("Pauillac","Bordeaux","rouge",0,1,5,3,5,"cassis cèdre tabac","boise","agneau de lait","grande_occasion",60,18,"Le boss final des rouges."),
+("Médoc","Bordeaux","rouge",0,1,4,3,4,"cassis graphite boisé","boise","boeuf grillé","repas",16,7,"Structure béton, pour les viandeux."),
+("Côtes de Bourg","Bordeaux","rouge",0,1,3,3,3,"fruits rouges réglisse","fruite","burger pâtes","repas",10,5,"Petit prix, grosse ambiance."),
+("Chinon","Val de Loire","rouge",0,1,2,4,2,"framboise poivron violette","fruite","charcuterie rillettes","apero",13,6,"Le rouge frais à servir un peu frais."),
+("Saumur-Champigny","Val de Loire","rouge",0,1,2,4,2,"fruits rouges croquants","fruite","volaille tartes salées","apero",13,6,"Croquant comme une fraise des bois."),
+("Bourgueil","Val de Loire","rouge",0,1,3,4,3,"cassis framboise graphite","fruite","porc grillades","repas",13,6,"Cabernet franc qui a du peps."),
+("Cahors","Sud-Ouest","rouge",0,1,5,3,5,"mûre prune réglisse","epice","cassoulet confit","repas",14,6,"Le vin noir. Ultra costaud."),
+("Madiran","Sud-Ouest","rouge",0,1,5,3,5,"fruits noirs épices cacao","epice","magret garbure","repas",15,6,"Tanins de rugbyman."),
+("Marcillac","Sud-Ouest","rouge",0,1,2,4,2,"cassis poivre framboise","fruite","charcuterie aligot","apero",12,6,"Le rouge secret de l'Aveyron."),
+("Corbières","Languedoc","rouge",0,1,4,2,3,"fruits noirs garrigue laurier","epice","barbecue tajine","repas",10,5,"Le Sud qui sent la garrigue."),
+("Pic Saint-Loup","Languedoc","rouge",0,1,4,3,3,"mûre thym poivre","epice","agneau grillé","repas",18,7,"Le Languedoc version premium."),
+("Minervois","Languedoc","rouge",0,1,3,2,3,"cerise épices réglisse","epice","pizza grillades","repas",11,5,"Soleil en bouteille, prix mini."),
+("Bandol rouge","Provence","rouge",0,1,5,3,5,"mûre cuir garrigue","epice","daube agneau","grande_occasion",30,11,"Mourvèdre de caractère."),
+("Alsace Pinot Noir","Alsace","rouge",0,1,1,4,1,"cerise fraise légère","fruite","tarte flambée volaille","apero",15,6,"Le rouge léger comme une plume."),
+("Corse Vin rouge","Corse","rouge",0,1,3,3,3,"maquis fruits rouges","epice","charcuterie corse","repas",15,6,"Le maquis dans ton verre."),
+("Vin nature Gamay","Divers","rouge",0,1,1,4,1,"fruits rouges croquants bonbon","fruite","apéro tapas","apero",16,7,"Glou-glou nature, à boire frais."),
+("Côtes de Provence rosé","Provence","rose",0,1,2,3,1,"pêche agrumes groseille","fruite","salade grillades apéro","apero",13,6,"Le rosé pâle de l'été en terrasse."),
+("Tavel","Vallée du Rhône","rose",0,1,3,3,2,"fraise épices cerise","fruite","cuisine asiatique paella","repas",15,6,"Le rosé qui se prend pour un rouge."),
+("Bandol rosé","Provence","rose",0,1,3,3,1,"agrumes pêche épices","fruite","bouillabaisse poisson grillé","repas",22,8,"Le rosé chic de la Riviera."),
+("Rosé d'Anjou","Val de Loire","rose",0,3,1,3,1,"bonbon fraise framboise","gourmand","apéro dessert fruits","apero",8,4,"Doux et fruité, le rosé bonbon."),
+("Cabernet d'Anjou","Val de Loire","rose",0,3,2,3,1,"fraise framboise sucre d'orge","gourmand","cuisine épicée apéro","apero",9,4,"Rosé gourmand, légèrement sucré."),
+("Pays d'Oc rosé","Languedoc","rose",0,1,2,3,1,"fruits rouges agrumes","fruite","barbecue pique-nique","apero",7,4,"Petit budget, grand soleil."),
+("Chablis","Bourgogne","blanc",0,1,2,5,1,"citron pierre à fusil iode","mineral","huîtres sushis","repas",20,8,"Ultra frais, comme une vague."),
+("Mâcon-Villages","Bourgogne","blanc",0,1,2,3,1,"pomme beurre fleurs blanches","fruite","poisson volaille","apero",12,6,"Chardonnay facile et rond."),
+("Meursault","Bourgogne","blanc",0,1,4,3,1,"beurre noisette brioche","boise","homard volaille crème","grande_occasion",50,15,"Le blanc beurré de luxe."),
+("Pouilly-Fuissé","Bourgogne","blanc",0,1,3,3,1,"agrumes amande grillée","boise","poisson sauce","repas",28,10,"Chardonnay riche et élégant."),
+("Sancerre","Val de Loire","blanc",0,1,2,5,1,"pamplemousse buis silex","mineral","chèvre poisson","repas",22,8,"Vif, net, sans bavure."),
+("Pouilly-Fumé","Val de Loire","blanc",0,1,2,5,1,"agrumes pierre à fusil fumé","mineral","saint-jacques chèvre","repas",22,8,"Sauvignon fumé de caractère."),
+("Muscadet Sèvre-et-Maine","Val de Loire","blanc",0,1,1,5,1,"citron iode pomme verte","mineral","huîtres moules","apero",9,5,"L'ami des fruits de mer à petit prix."),
+("Vouvray sec","Val de Loire","blanc",0,1,2,4,1,"coing pomme miel","fruite","poisson cuisine asiatique","repas",14,6,"Chenin croquant et pomme."),
+("Vouvray moelleux","Val de Loire","blanc",0,4,3,4,1,"miel coing abricot","gourmand","foie gras tarte aux pommes","dessert",18,7,"Doux mais frais, pas écœurant."),
+("Touraine Sauvignon","Val de Loire","blanc",0,1,1,4,1,"agrumes groseille herbe coupée","fruite","apéro salade chèvre","apero",9,5,"Le blanc qui réveille."),
+("Entre-deux-Mers","Bordeaux","blanc",0,1,1,4,1,"agrumes fleurs blanches","fruite","poisson apéro","apero",8,4,"Frais et pas cher, validé."),
+("Sauternes","Bordeaux","blanc",0,5,4,3,1,"miel abricot safran","gourmand","foie gras roquefort dessert","dessert",35,12,"Le blanc liquoreux, du miel en bouteille."),
+("Pessac-Léognan blanc","Bordeaux","blanc",0,1,3,4,1,"agrumes boisé fumé","boise","poisson noble","grande_occasion",35,12,"Bordeaux blanc grand style."),
+("Alsace Riesling","Alsace","blanc",0,1,2,5,1,"citron vert pétrole léger minéral","mineral","choucroute poisson","repas",14,6,"Tranchant comme un laser."),
+("Alsace Gewurztraminer","Alsace","blanc",0,3,3,2,1,"litchi rose épices","floral","cuisine asiatique munster","repas",15,6,"Litchi et rose, très parfumé."),
+("Alsace Pinot Gris","Alsace","blanc",0,2,3,3,1,"poire fumé miel","gourmand","volaille foie gras","repas",15,6,"Rond, un peu fumé, très doux."),
+("Viognier Pays d'Oc","Languedoc","blanc",0,1,3,2,1,"abricot pêche fleurs","floral","curry poulet","apero",10,5,"Parfum d'abricot, très solaire."),
+("Condrieu","Vallée du Rhône","blanc",0,1,4,2,1,"abricot violette pêche","floral","poisson crème","grande_occasion",45,14,"Le Viognier haute couture."),
+("Picpoul de Pinet","Languedoc","blanc",0,1,1,5,1,"citron iode fleurs","mineral","huîtres tapas","apero",9,5,"Le blanc de la mer du Sud."),
+("Jurançon sec","Sud-Ouest","blanc",0,1,2,5,1,"fruits exotiques agrumes","fruite","poisson cuisine épicée","repas",14,6,"Exotique et vif."),
+("Jurançon moelleux","Sud-Ouest","blanc",0,4,3,4,1,"mangue ananas miel","gourmand","dessert fruits foie gras","dessert",18,7,"Ananas et mangue, en mode dessert."),
+("Côtes de Gascogne blanc","Sud-Ouest","blanc",0,2,1,4,1,"pamplemousse fruits exotiques","fruite","apéro salade","apero",7,4,"Le blanc tropical à mini prix."),
+("Vin jaune","Jura","blanc",0,1,4,4,1,"noix curry épices","epice","comté poulet aux morilles","grande_occasion",40,13,"OVNI du vin : noix et curry."),
+("Muscat de Beaumes-de-Venise","Vallée du Rhône","blanc",0,5,3,2,1,"raisin frais orange fleurs","gourmand","dessert chocolat blanc","dessert",16,6,"Comme croquer du raisin sucré."),
+("Champagne Brut","Champagne","blanc",1,1,2,5,1,"brioche pomme agrumes","fruite","apéro sushis tout","grande_occasion",35,12,"Les bulles de la fête, obligées."),
+("Champagne Rosé","Champagne","rose",1,1,2,4,1,"fraise framboise brioche","fruite","apéro dessert fruits rouges","grande_occasion",45,14,"Bulles + rose = combo parfait."),
+("Champagne Demi-sec","Champagne","blanc",1,3,2,4,1,"fruits blancs miel brioche","gourmand","dessert gâteau","dessert",35,12,"Bulles douces pour le gâteau."),
+("Crémant de Loire","Val de Loire","blanc",1,1,2,4,1,"pomme verte fleurs","fruite","apéro","apero",12,5,"Les bulles du Champagne sans le prix."),
+("Crémant d'Alsace","Alsace","blanc",1,1,2,4,1,"agrumes pomme brioche","fruite","apéro tarte flambée","apero",12,5,"Bulles fines, budget mini."),
+("Crémant de Bourgogne rosé","Bourgogne","rose",1,1,2,4,1,"fruits rouges croquants","fruite","apéro","apero",14,6,"Bulles roses pour trinquer."),
+("Clairette de Die","Vallée du Rhône","blanc",1,4,1,3,1,"muscat raisin rose","gourmand","dessert brunch","dessert",11,5,"Bulles sucrées et légères, très fun."),
+("Blanquette de Limoux","Languedoc","blanc",1,1,2,4,1,"pomme verte fleurs","fruite","apéro","apero",11,5,"Les plus vieilles bulles de France."),
+("Pétillant naturel (Pet'Nat)","Divers","rose",1,2,1,4,1,"fruits rouges acidulés","fruite","apéro pique-nique","apero",15,6,"Bulles nature, funky et acidulées."),
+("Prosecco","Italie","blanc",1,2,1,3,1,"poire pomme fleurs","fruite","apéro spritz","apero",10,5,"Bulles italiennes légères."),
+("Cava","Espagne","blanc",1,1,2,4,1,"agrumes amande","fruite","tapas apéro","apero",10,5,"Bulles espagnoles, olé."),
+("Rioja","Espagne","rouge",0,1,4,3,3,"cerise vanille cuir","boise","tapas chorizo","repas",14,6,"Le rouge espagnol vanillé."),
+("Chianti","Italie","rouge",0,1,3,4,3,"cerise tomate herbes","fruite","pizza pâtes","repas",13,6,"Celui qui va avec ta pizza."),
+("Malbec argentin","Argentine","rouge",0,1,4,3,3,"mûre prune violette","fruite","burger asado","repas",13,6,"Gros fruit, ultra facile."),
+("Pinot Grigio","Italie","blanc",0,1,1,3,1,"poire citron","fruite","apéro salade","apero",9,5,"Léger, neutre, safe."),
+("Porto Tawny","Portugal","rouge",0,5,4,3,2,"noix caramel figue","gourmand","chocolat fromage","dessert",20,6,"Caramel et noix, pour finir la soirée."),
+]
+out = pathlib.Path(__file__).resolve().parents[1] / "data" / "vins.csv"
+with open(out, "w", newline="", encoding="utf-8") as f:
+    w = csv.writer(f); w.writerow(COLS); w.writerows(V)
+print(f"{len(V)} vins -> {out}")

scripts/enrichir_kaggle.py

@@ -0,0 +1,36 @@
+"""(Optionnel) Ajoute de vraies bouteilles notées à GRAPP avec le dataset Kaggle
+« Wine Reviews » (Wine Enthusiast, 130 000 avis) : https://www.kaggle.com/datasets/zynicide/wine-reviews
+
+1. Télécharger winemag-data-130k-v2.csv (compte Kaggle gratuit), le mettre dans data/
+   ou :  kaggle datasets download -d zynicide/wine-reviews -p data --unzip
+2. python scripts/enrichir_kaggle.py
+=> crée data/bouteilles_kaggle.csv ; l'app affiche alors, pour chaque vin
+   recommandé, les bouteilles réelles les mieux notées de cette appellation.
+"""
+import sys
+from pathlib import Path
+
+import pandas as pd
+
+ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(ROOT))
+from grapp.engine import normaliser  # noqa: E402
+
+src = ROOT / "data" / "winemag-data-130k-v2.csv"
+if not src.exists():
+    sys.exit(f"Fichier introuvable : {src}\nTélécharge-le depuis Kaggle (voir l'en-tête du script).")
+
+kag = pd.read_csv(src).dropna(subset=["title", "price"])
+kag["t"] = kag["title"].map(normaliser) + " " + kag["designation"].fillna("").map(normaliser)
+vins = pd.read_csv(ROOT / "data" / "vins.csv")
+
+lignes = []
+for nom in vins["nom"]:
+    cle = normaliser(nom.replace(" rouge", "").replace(" blanc", "").replace(" rosé", ""))
+    sel = kag[kag["t"].str.contains(rf"\b{cle}\b", regex=True)]
+    for _, r in sel.sort_values(["points", "price"], ascending=[False, True]).head(5).iterrows():
+        lignes.append({"nom": nom, "bouteille": r.title, "points": r.points,
+                       "prix_usd": r.price, "avis": r.description})
+out = pd.DataFrame(lignes)
+out.to_csv(ROOT / "data" / "bouteilles_kaggle.csv", index=False)
+print(f"{len(out)} bouteilles pour {out['nom'].nunique()} appellations -> data/bouteilles_kaggle.csv")

scripts/generer_carte_exemple.py

@@ -0,0 +1,28 @@
+"""Génère assets/carte_exemple.png : une fausse carte des vins de bistrot pour la démo."""
+from pathlib import Path
+from PIL import Image, ImageDraw, ImageFont
+
+LIGNES = [("LA CARTE DES VINS", None), ("", None), ("BULLES", None),
+ ("Crémant de Loire, Domaine des Coteaux", "32 €"), ("Champagne Brut, Maison Laurent", "68 €"), ("", None),
+ ("BLANCS", None), ("Muscadet Sèvre-et-Maine 2023", "24 €"), ("Sancerre, Les Caillottes 2022", "42 €"),
+ ("Alsace Gewurztraminer 2021", "34 €"), ("Chablis 1er Cru 2021", "48 €"), ("", None),
+ ("ROSÉS", None), ("Côtes de Provence rosé, Château Sainte-Roseline", "33 €"), ("Tavel 2023", "30 €"), ("", None),
+ ("ROUGES", None), ("Beaujolais-Villages 2023", "25 €"), ("Chinon, Les Picasses 2020", "29 €"),
+ ("Côtes du Rhône, E. Guigal 2021", "27 €"), ("Saint-Émilion Grand Cru 2018", "58 €"),
+ ("Cahors Malbec 2019", "31 €"), ("", None), ("DOUCEURS", None), ("Sauternes 2017 (50 cl)", "45 €")]
+root = Path(__file__).resolve().parents[1]
+W, H = 1100, 60 + 46 * len(LIGNES)
+img = Image.new("RGB", (W, H), "#FFFDF8"); d = ImageDraw.Draw(img)
+def font(bold, size):
+    for p in [f"/usr/share/fonts/truetype/dejavu/DejaVuSerif{'-Bold' if bold else ''}.ttf",
+              "/Library/Fonts/Georgia.ttf", "/System/Library/Fonts/Supplemental/Georgia.ttf"]:
+        try: return ImageFont.truetype(p, size)
+        except OSError: pass
+    return ImageFont.load_default()
+y = 40
+for txt, prix in LIGNES:
+    titre = prix is None and txt.isupper()
+    d.text((70, y), txt, fill="#7D1C4F" if titre else "#222", font=font(titre, 30 if titre else 26))
+    if prix: d.text((W - 160, y), prix, fill="#222", font=font(False, 26))
+    y += 46
+img.save(root / "assets" / "carte_exemple.png"); print("ok", img.size)

tests/test_grapp.py

@@ -0,0 +1,42 @@
+"""Tests rapides : python -m pytest -q   (ou python tests/test_grapp.py)"""
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+from grapp.carte import trouver_vins
+from grapp.engine import DicoVino, Grapp, Preferences
+
+G = Grapp(use_hf=False)
+NOMS = G.vins["nom"].tolist()
+
+
+def test_filtre_couleur_et_bulles():
+    r = G.recommander(Preferences(couleur="blanc", bulles="oui"), k=10)
+    assert r and all(x.vin["couleur"] == "blanc" and x.vin["bulles"] == 1 for x in r)
+
+
+def test_huitres_donne_un_blanc_mineral():
+    p = Preferences(couleur="blanc", familles=["mineral"], occasion="repas",
+                    format="bouteille", budget=25, envie="huîtres et fruits de mer")
+    assert G.recommander(p, k=1)[0].vin["famille"] == "mineral"
+
+
+def test_lecture_carte_tolere_fautes_ocr():
+    texte = "Cétes du Rhone, E. Guigal 2021 27€\nChampagne Brut, Maison X 68 €\nChablis ler Cru 48 €"
+    res = {x["nom"]: x["prix_carte"] for x in trouver_vins(texte, NOMS)}
+    assert res == {"Côtes du Rhône": 27.0, "Champagne Brut": 68.0, "Chablis": 48.0}
+
+
+def test_reco_limitee_a_la_carte_et_prix_resto():
+    r = G.recommander(Preferences(format="bouteille"), carte={"Chinon": 29.0, "Tavel": 30.0})
+    assert {x.nom for x in r} <= {"Chinon", "Tavel"} and {x.prix for x in r} <= {29.0, 30.0}
+
+
+def test_dico():
+    assert "Tanins" in DicoVino(use_hf=False).chercher("tanins")["terme"].tolist()
+
+
+if __name__ == "__main__":
+    for n, f in list(globals().items()):
+        if n.startswith("test_"):
+            f(); print("OK", n)