🍷 Cave & Vigne

Gestionnaire de cave à vin, spiritueux et bières — Application web full-stack avec sommelier IA, cartes interactives, scan d'étiquettes par vision artificielle, recherche de prix de marché et imprimante d'étiquettes.

🌐 Aperçu

Cave & Vigne est une application web complète de gestion de cave personnelle. Elle permet de référencer ses bouteilles de vin et spiritueux, d'obtenir des recommandations d'accords mets/vins grâce à l'IA Claude (Anthropic), de visualiser ses vignobles sur des cartes interactives, et de scanner les étiquettes à la caméra pour importer automatiquement les informations.

✨ Fonctionnalités

Fonctionnalité	Description
🔐 Authentification	Inscription/connexion sécurisée, JWT access + refresh token, réinitialisation mot de passe
🛡️ 2FA TOTP	Double authentification (Google Authenticator, FreeOTP)
🍷 Cave à vins	CRUD complet, quantités, position, prix, millésime, infos domaine, sélection multiple
🍺 Bières	Collection complète : blonde, brune, IPA, NEIPA, stout, sour, lambic… — ABV, IBU, volume, brasserie, statut — scanner code-barres V&B / Untappd / RateBeer
🥃 Spiritueux	Whisky, rhum, cognac, armagnac, calvados, gin, vodka — avec statut ouvert/fermé
📸 Photos bouteilles	Photo étiquette + photo bouteille, infos domaine (site web, sol, altitude)
🤖 Sommelier IA multi-provider	Accords mets/vins depuis la cave — Claude, ChatGPT, Mistral ou OpenWebUI/Ollama
📷 Scan d'étiquettes	Caméra ou photo importée → IA Vision extrait les infos automatiquement
📊 Analyse IA de cave	Score diversité/équilibre, points forts, occasion parfaite, axes d'amélioration
🔍 Enrichissement multi-sources	Vivino → Open Food Facts → Vinatis → LRVF → fallback générique
🍽️ Recettes associées	Suggestions de recettes via TheMealDB
📓 Journal de dégustation	Notes par bouteille (robe, nez, bouche, finale, note /100)
💌 Liste de souhaits	Vins à acquérir avec priorité, budget max et lien boutique
📤 Export / Import CSV	Cave exportable et importable (compatible Excel)
🌍 Carte mondiale	Vins (cercles), spiritueux (diamants) et bières (triangles) — filtres par catégorie + détail des bouteilles en cave
🇫🇷 Carte France v2	16 régions viticoles, zoom/pan D3, filtre cépage, overlay domaines en cave, clic région → détail AOC + cépages + bouteilles
🗺 Carte spiritueux	Origines mondiales de vos spiritueux
⭐ Accords notés	Notation 5 étoiles des accords mets/vin avec commentaire
🌐 Catalogue public	Mode visiteur sans authentification (configurable)
⚙️ Admin	Gestion multi-provider IA, SMTP, catalogue public depuis l'UI
📱 PWA + App Android	Installable sur mobile/desktop + WebView native (caméra, swipe-to-refresh)
🍎 App iOS	Application SwiftUI (WKWebView) — caméra, swipe-back, hors-ligne
🏚️ Caves partagées	Invitations par email, permissions lecture ou écriture collaborative (ajouter/modifier/supprimer/toggle), gestion des accès
📈 Historique valeur	Snapshot quotidien + graphique d'évolution sur 90 jours
⏳ Tracker de maturité	Vins classés : à l'apogée, approche, trop jeune, passé prime
🔴 Alerte dernière bouteille	Badge rouge quand il ne reste qu'une bouteille
📦 Scanner code-barres	Caméra (BarcodeDetector) ou saisie : EAN-8/13, ITF-14 cartons/caisses, UPC, Code 128 → pré-remplit formulaire vin ou spiritueux
🔫 Douchette code-barres	Onglet dédié douchette HID (scanner physique USB/Bluetooth) — scan continu, historique 10 derniers, retour auto-focus
🗄️ Cache barcode local	Import bulk Open Food Facts (dump JSONL) → lookup instantané offline ; fallback Vivino / Oeni / Liv-ex
🏷️ Imprimante d'étiquettes	4 formats : 57×32 mm, 89×36 mm, 100×62 mm, grille A4 — impression directe via CSS `@page`
🧊 Vue 3D des casiers	Rendu CSS3D, rotation par glisser, bouteilles colorées par type, détail au clic
🗂️ Gestion des casiers v2	Type de cave (Casier / Conservation / Vieillissement / Polyvalente), édition dimensions (L × H), mode déplacement de bouteilles
💸 Recherche de rachat	Prix de marché en ligne pour racheter une bouteille : Vivino, Vinatis, iDéalwine — prix min, prix moyen, disponibilité
🍹 Générateur de cocktails	Suggestion de cocktails et apéritifs selon les spiritueux et bières disponibles dans la cave (IA)
📄 Export PDF	Impression de la cave filtrée (tableau stylisé via window.print)
🌙 "Que boire ce soir ?"	L'IA choisit dans votre cave selon occasion, convives, envie
🔎 Région spotlight	Analyse IA d'une région viticole depuis la carte France
🌐 Catalogue public	Visiteurs non connectés peuvent consulter la cave si activé (VisitorAllowed sans redirection login)
🖼️ Vue galerie	Basculement liste/galerie sur la page vins — grille d'étiquettes cliquables avec badge quantité et overlay "bu"
📅 Gantt apogée	Calendrier de dégustation (±8 ans) : barres empilées par type de vin, apogées en cours surlignées
💰 Historique des prix	Enregistrement manuel ou automatique des prix par bouteille (source + date)
✅ Actions groupées	Sélection multiple → marquer comme bu ou supprimer en une seule requête SQL (`IN (...)`)
🏅 Score qualité	Score d'enrichissement (0–100) calculé sur 13 champs clés — affiché dans le panneau d'enrichissement
📖 API docs (Swagger)	Documentation interactive OpenAPI disponible sur `/api/docs`

🏗 Architecture

┌─────────────────────────────────────────────────────┐
│                   Cloudflare CDN/WAF                │
└──────────────────────┬──────────────────────────────┘
                       │
┌──────────────────────▼──────────────────────────────┐
│                  Nginx (reverse proxy)               │
│          SSL Let's Encrypt • Gzip • Cache           │
└──────────┬───────────────────────┬──────────────────┘
           │                       │
┌──────────▼──────────┐  ┌────────▼────────────────┐
│   React 19 + BS5    │  │  Node.js / Express API  │
│   Vite 6 (build)    │  │  Port 3001 (127.0.0.1)  │
└─────────────────────┘  └────────┬────────────────┘
                                  │
                    ┌─────────────┼──────────────┐
                    │             │              │
              ┌─────▼─────┐ ┌────▼────┐  ┌─────▼──────┐
              │  MariaDB  │ │  Redis  │  │  AI APIs   │
              │    12     │ │  :6379  │  │ (multi)    │
              └───────────┘ └─────────┘  └────────────┘

Stack technique :

Couche	Technologie
Frontend	React 19, Bootstrap 5, React Query v5, D3.js, Axios
Build	Vite 6 + @vitejs/plugin-react
Backend	Node.js 24, Express 4, JWT, Multer, Sharp 0.34, Axios, Cheerio
Base de données	MariaDB 12 (mysql2 driver)
Cache	Redis 7
IA	Claude, ChatGPT, Mistral, OpenWebUI/Ollama — Sommelier + Vision
Serveur web	Nginx
CDN/Sécurité	Cloudflare
Process manager	PM2 (cluster mode)
Mobile Android	Kotlin WebView + Swipe Refresh

🚀 Démarrage rapide (développement local)

Prérequis

Node.js 24+
MariaDB 12 (ou MySQL 8+)
Redis (optionnel, dégrade gracieusement)
Clé API IA : Anthropic, OpenAI, Mistral, ou instance OpenWebUI (configurable depuis l'UI admin)

1. Backend

cd backend
cp .env.example .env
# Éditer .env avec vos paramètres
npm install
npm run migrate    # Crée les tables
npm run dev        # Démarre en mode dev (nodemon, port 3001)

2. Frontend

cd frontend
# Créer .env.local
echo "REACT_APP_API_URL=http://localhost:3001/api" > .env.local
npm install
npm start          # Vite dev server → http://localhost:3000

3. Variables d'environnement requises

# backend/.env
DB_HOST=localhost
DB_NAME=cave_vigne
DB_USER=cave_user
DB_PASSWORD=votre_mot_de_passe

JWT_SECRET=cle_secrete_64_caracteres_minimum

# Clé IA par défaut (remplacée par la config admin si renseignée en BDD)
ANTHROPIC_API_KEY=sk-ant-...     # Claude
# OPENAI_API_KEY=sk-...          # ChatGPT
# MISTRAL_API_KEY=...            # Mistral

# SMTP pour emails (reset mot de passe, notifications)
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=...
SMTP_PASS=...

# Optionnel
REDIS_HOST=localhost
REDIS_PASSWORD=

📁 Structure du projet

cave-vigne/
├── backend/
│   ├── src/
│   │   ├── config/
│   │   │   ├── ai.js           # Abstraction multi-provider IA (callAI, callAIVision)
│   │   │   ├── db.js           # Pool MariaDB
│   │   │   ├── redis.js        # Cache Redis
│   │   │   ├── email.js        # Transport Nodemailer dynamique
│   │   │   └── migrate.js      # Migration BDD (tables + ALTER)
│   │   ├── jobs/
│   │   │   └── notifications.js # Cron quotidien keep_until + purge tokens
│   │   ├── middleware/
│   │   │   └── auth.js         # Vérification JWT + optionalAuth
│   │   ├── routes/
│   │   │   ├── auth.js         # Login, register, refresh, 2FA TOTP, reset password
│   │   │   ├── wines.js        # CRUD vins + accords + enrichissement + barcode (cache→OFF→scrapers)
│   │   │   ├── spirits.js      # CRUD spiritueux + barcode
│   │   │   ├── beers.js        # CRUD bières + stats + barcode (cache→OFF→V&B/Untappd/RateBeer)
│   │   │   ├── sharing.js      # Caves partagées (read/write) + invitations + permissions
│   │   │   ├── sommelier.js    # IA accord + scan + recettes + recommend + region-spotlight
│   │   │   ├── tasting.js      # Journal de dégustation par bouteille
│   │   │   ├── wishlist.js     # Liste de souhaits
│   │   │   └── settings.js     # Config admin (IA, SMTP, catalogue)
│   │   ├── services/
│   │   │   └── wineScraper.js  # EAN fallback : UPC ItemDB → Vivino → Oeni → Liv-ex ; enrichissement : Vivino → OFF → Vinatis → LRVF
│   │   ├── jobs/
│   │   │   ├── notifications.js        # Cron quotidien keep_until + valeur cave
│   │   │   └── importOpenFoodFacts.js  # Import bulk dump JSONL → barcode_cache
│   │   └── server.js           # Point d'entrée Express
│   ├── ecosystem.config.js     # Config PM2
│   ├── .env.example
│   └── package.json
│
├── frontend/
│   ├── index.html              # Entrée Vite
│   ├── vite.config.js
│   ├── public/
│   │   ├── manifest.json       # PWA manifest
│   │   └── sw.js               # Service Worker (cache-first)
│   ├── src/
│   │   ├── components/
│   │   │   ├── Layout.jsx               # Sidebar + Topbar responsive
│   │   │   ├── BarcodeScannerModal.jsx  # Caméra BarcodeDetector + saisie + douchette HID, EAN/ITF-14/UPC
│   │   │   ├── LabelPrinter.jsx         # Imprimante étiquettes (4 formats, CSS @page)
│   │   │   └── WineMarketModal.jsx      # Recherche prix marché rachat (Vivino, Vinatis, iDéalwine)
│   │   ├── context/
│   │   │   └── AuthContext.jsx # Auth state global
│   │   ├── locales/
│   │   │   ├── fr.js           # Traductions françaises
│   │   │   └── en.js           # Traductions anglaises
│   │   ├── pages/
│   │   │   ├── Login.jsx              # + lien "Mot de passe oublié"
│   │   │   ├── Register.jsx
│   │   │   ├── ForgotPassword.jsx
│   │   │   ├── ResetPassword.jsx
│   │   │   ├── Dashboard.jsx          # Donut Chart.js + valeur + maturité + analyse IA + générateur cocktails
│   │   │   ├── WinesPage.jsx          # CRUD + dégustation + barcode + enrichissement + PDF + bulk + étiquettes + rachat
│   │   │   ├── SpiritsPage.jsx        # CRUD + barcode scan
│   │   │   ├── BeersPage.jsx          # Collection bières (16 types) + barcode scan
│   │   │   ├── CellarPage.jsx         # Vue 3D des casiers v2 (type cave, dimensions, déplacement)
│   │   │   ├── SharedCavesPage.jsx    # Caves partagées (invite, lecture/écriture collaborative)
│   │   │   ├── WishlistPage.jsx
│   │   │   ├── SommelierPage.jsx      # Accord + "ce soir ?" + badge provider
│   │   │   ├── ScanPage.jsx           # Vision IA + badge provider
│   │   │   ├── ProfilePage.jsx        # Profil + 2FA
│   │   │   ├── AdminPage.jsx          # Utilisateurs + paramètres IA multi-provider
│   │   │   ├── WorldMapPage.jsx       # Vins + spiritueux + bières ; filtres catégorie
│   │   │   ├── FranceMapPage.jsx      # 16 régions, zoom D3, filtre cépage, overlay domaines, spotlight IA
│   │   │   └── SpiritsMapPage.jsx
│   │   ├── services/
│   │   │   └── api.js          # Axios + auto-refresh JWT
│   │   ├── App.jsx
│   │   ├── index.css
│   │   └── main.jsx            # + PWA service worker registration
│   └── package.json
│
├── android/                    # App Android native
│   └── app/src/main/
│       ├── java/com/cavevigne/
│       │   └── MainActivity.kt
│       └── AndroidManifest.xml
│
├── nginx/
│   └── cavevigne.fr.conf       # Config Nginx production
│
├── docs/
│   ├── DEPLOY.md               # Guide déploiement complet
│   └── GITHUB_META.md
│
├── deploy.sh                   # Script déploiement automatisé Debian 13
├── CHANGELOG.md
├── .gitignore
├── LICENSE
└── README.md

🌍 Déploiement production

Script automatisé — Debian 13

Un script de déploiement complet est fourni pour Debian 13 (Trixie) :

# Sur le VPS, après avoir cloné le dépôt
sudo bash deploy.sh

Le script installe et configure automatiquement l'ensemble de la stack :

Étape	Action
1	Mise à jour système + dépendances (`libvips`, `curl`, etc.)
2	Node.js 24 LTS + PM2 (cluster mode)
3	MariaDB 12 — création BDD, utilisateur, tuning InnoDB
4	Redis — sécurisé (bind 127.0.0.1, mot de passe)
5	Nginx — config copiée depuis `nginx/`, SSL Let's Encrypt
6	Backend + Frontend — copie, `.env` généré, migration BDD, build Vite
7	PM2 startup systemd
8	Certbot SSL + renouvellement automatique (cron 3h)
9	UFW — SSH + HTTPS ouverts, MariaDB/Redis/3001 bloqués

Le script génère automatiquement le JWT_SECRET et demande de manière interactive le domaine, l'email SSL, les mots de passe et la clé API Anthropic.

Déploiement manuel

Voir le guide complet : docs/DEPLOY.md

📱 Application Android

L'application Android est une WebView Kotlin qui encapsule l'application web avec :

Accès caméra natif pour le scan d'étiquettes
Swipe-to-refresh
Gestion des permissions (caméra, stockage)
Page d'erreur offline élégante

Build : Ouvrir android/ dans Android Studio → Generate Signed APK

🔒 Sécurité

Mots de passe hashés avec bcrypt (salt factor 12)
JWT avec expiration courte (7j) + refresh token (30j)
2FA TOTP compatible Google Authenticator, FreeOTP, Authy
Rate limiting : 200 req/15min global, 20 req/15min sur auth, 5 req/min sur /api/wines/:id/enrich (par utilisateur)
Cache enrichissement : résultats Vivino/OFF mis en cache Redis 24h (bypass possible via ?refresh=1)
Helmet.js — headers de sécurité HTTP
CORS restreint aux origines autorisées
Cloudflare WAF — protection SQLi, XSS, bots
Uploads restreints aux images, optimisés via Sharp (WebP)
Nginx : blocage des fichiers cachés, headers HSTS

🤝 Contribution

Les contributions sont les bienvenues ! Pour contribuer :

Forkez le dépôt
Créez une branche feature : git checkout -b feature/ma-fonctionnalite
Commitez vos changements : git commit -m 'feat: ajouter ma fonctionnalité'
Poussez la branche : git push origin feature/ma-fonctionnalite
Ouvrez une Pull Request

Idées d'améliorations

Recherche full-text avancée (facets, ElasticSearch)
Application iOS — distribution App Store (compte Developer requis)
Notifications push (PWA + mobile) pour les rappels keep_until

📄 Licence

Ce projet est sous licence MIT — voir LICENSE pour les détails.

🙏 Crédits

Claude (Anthropic), ChatGPT (OpenAI), Mistral AI, OpenWebUI — Sommelier IA, analyse d'étiquettes, enrichissement
D3.js — Cartes interactives
Bootstrap 5 — Interface utilisateur
Chart.js — Graphiques et statistiques
Open Food Facts — Enrichissement et cache barcode local
Vivino / Oeni / Liv-ex — Scrapers fallback EAN vins + enrichissement + prix de marché
Vinatis / iDéalwine / LRVF — Scrapers enrichissement et prix de marché
V&B / Untappd / RateBeer — Scrapers fallback bières
TheMealDB — Suggestions de recettes associées

Fait avec ❤️ et 🍷 en Normandie

Name		Name	Last commit message	Last commit date
.claude		.claude
.github		.github
android/app/src/main		android/app/src/main
backend		backend
docs		docs
frontend		frontend
ios		ios
nginx		nginx
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.prettierrc		.prettierrc
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README-WINDOWS.md		README-WINDOWS.md
README.md		README.md
SECURITY.md		SECURITY.md
api-tests.http		api-tests.http
cave-vigne.code-workspace		cave-vigne.code-workspace
deploy.sh		deploy.sh
package-lock.json		package-lock.json
package.json		package.json
setup-github.sh		setup-github.sh
setup-windows.ps1		setup-windows.ps1
start.bat		start.bat

Navigation Menu

Repository navigation

About

Repository files navigation

🍷 Cave & Vigne

🌐 Aperçu

✨ Fonctionnalités

🏗 Architecture

🚀 Démarrage rapide (développement local)

Prérequis

1. Backend

2. Frontend

3. Variables d'environnement requises

📁 Structure du projet

🌍 Déploiement production

Script automatisé — Debian 13

Déploiement manuel

📱 Application Android

🔒 Sécurité

🤝 Contribution

Idées d'améliorations

📄 Licence

🙏 Crédits

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

🍷 Cave & Vigne

🌐 Aperçu

✨ Fonctionnalités

🏗 Architecture

🚀 Démarrage rapide (développement local)

Prérequis

1. Backend

2. Frontend

3. Variables d'environnement requises

📁 Structure du projet

🌍 Déploiement production

Script automatisé — Debian 13

Déploiement manuel

📱 Application Android

🔒 Sécurité

🤝 Contribution

Idées d'améliorations

📄 Licence

🙏 Crédits

About

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages