morgane
f1e07f4151
CI / PHP Syntax Check (push) Has been cancelled
CI / JavaScript Lint (push) Has been cancelled
CI / Docker Build Test (push) Has been cancelled
CI / Validate Translation Files (push) Has been cancelled
CI / Auto-merge develop → main (push) Has been cancelled
CI / Create GitHub Release (push) Has been cancelled
222 lines
4.4 KiB
Markdown
222 lines
4.4 KiB
Markdown
🏠 EverShelf
|
||
|
||
«Gestionnaire de garde-manger auto-hébergé — Suivez vos stocks alimentaires, scannez vos produits, recevez des suggestions de recettes avec l’IA et réduisez le gaspillage.»
|
||
|
||
Fork amélioré du projet original EverShelf avec corrections, améliorations d’ergonomie, intégrations supplémentaires et optimisations.
|
||
|
||
---
|
||
|
||
<div align="center">🚀 Démo en ligne
|
||
|
||
"▶ Tester la démo" (https://evershelfproject.dadaloop.it/demo)
|
||
·
|
||
"🌐 Site du projet" (https://evershelfproject.dadaloop.it/)
|
||
·
|
||
"📖 Documentation" (https://github.com/dadaloop82/EverShelf/wiki)
|
||
|
||
La démo utilise des données fictives. Les fonctions IA sont activées. Les modifications sont isolées.
|
||
|
||
</div>---
|
||
|
||
""License: MIT" (https://img.shields.io/badge/License-MIT-green.svg)" (LICENSE)
|
||
""PHP" (https://img.shields.io/badge/PHP-8.0+-blue.svg)" (https://www.php.net/)
|
||
""SQLite" (https://img.shields.io/badge/SQLite-3-blue.svg)" (https://www.sqlite.org/)
|
||
""Docker" (https://img.shields.io/badge/Docker-Compatible-2496ED.svg)" (Dockerfile)
|
||
|
||
---
|
||
|
||
✨ Fonctionnalités principales
|
||
|
||
📦 Gestion des stocks
|
||
|
||
- Inventaire alimentaire complet
|
||
- Gestion des emplacements :
|
||
- 🏠 Placard
|
||
- ❄️ Réfrigérateur
|
||
- 🧊 Congélateur
|
||
- 📍 Emplacements personnalisés
|
||
- Scan de codes-barres avec la caméra du téléphone
|
||
- Ajout rapide de produits
|
||
- Suivi des dates de péremption
|
||
- Gestion des produits ouverts
|
||
- Support des produits sous vide
|
||
- Détection des incohérences de stock
|
||
|
||
---
|
||
|
||
🤖 Intelligence artificielle (Google Gemini)
|
||
|
||
EverShelf peut utiliser l’IA pour :
|
||
|
||
- 📸 Identifier un produit depuis une photo
|
||
- 📅 Lire automatiquement une date limite de consommation
|
||
- 🧊 Proposer un stockage adapté
|
||
- 🍳 Générer des recettes selon votre inventaire
|
||
- 💬 Répondre aux questions sur vos produits
|
||
- 🛒 Améliorer les suggestions de courses
|
||
|
||
«L’IA est optionnelle. EverShelf fonctionne sans clé Gemini.»
|
||
|
||
---
|
||
|
||
🛒 Liste de courses intelligente
|
||
|
||
- Création automatique depuis les ruptures de stock
|
||
- Prévisions de besoins
|
||
- Synchronisation avec Bring!
|
||
- Nettoyage automatique des doublons
|
||
- Suggestions d’achat personnalisées
|
||
|
||
---
|
||
|
||
🍳 Mode cuisine
|
||
|
||
- Recettes étape par étape
|
||
- Mode mains libres
|
||
- Synthèse vocale (TTS)
|
||
- Minuteurs automatiques
|
||
- Suivi des ingrédients utilisés
|
||
- Conseils anti-gaspillage
|
||
|
||
---
|
||
|
||
♻️ Réduction du gaspillage
|
||
|
||
- Suivi des aliments consommés ou jetés
|
||
- Analyse des pertes
|
||
- Alertes de péremption
|
||
- Suggestions pour utiliser les produits bientôt périmés
|
||
|
||
---
|
||
|
||
🏡 Intégrations
|
||
|
||
Home Assistant
|
||
|
||
Intégration native disponible :
|
||
|
||
- Capteurs de stock
|
||
- Dates de péremption
|
||
- Liste de courses
|
||
- Calendrier des produits
|
||
- Actions personnalisées
|
||
- Suggestions de recettes IA
|
||
|
||
Compatible avec une installation 100% locale.
|
||
|
||
---
|
||
|
||
📱 Application mobile / PWA
|
||
|
||
- Interface adaptée smartphone
|
||
- Installation comme une application
|
||
- Synchronisation multi-appareils
|
||
- Mode hors-ligne :
|
||
- consultation du stock
|
||
- actions mises en attente
|
||
- synchronisation automatique au retour réseau
|
||
|
||
---
|
||
|
||
📺 Mode tablette (Kiosque Android)
|
||
|
||
- Affichage plein écran
|
||
- Verrouillage kiosque
|
||
- Scan caméra
|
||
- Support TTS natif Android
|
||
- Découverte automatique du serveur
|
||
- Support des balances Bluetooth
|
||
|
||
---
|
||
|
||
🚀 Installation rapide
|
||
|
||
Prérequis
|
||
|
||
- PHP 8.0+
|
||
- SQLite 3
|
||
- Extensions PHP :
|
||
- "pdo_sqlite"
|
||
- "curl"
|
||
- "mbstring"
|
||
- "json"
|
||
|
||
Docker est recommandé.
|
||
|
||
---
|
||
|
||
🐳 Installation Docker
|
||
|
||
git clone https://git.mashome.fr/morgane/EverShelf.git
|
||
|
||
cd EverShelf
|
||
|
||
cp .env.example .env
|
||
|
||
nano .env
|
||
|
||
docker compose up -d
|
||
|
||
Puis ouvrez :
|
||
|
||
http://localhost:8080
|
||
|
||
---
|
||
|
||
⚙️ Configuration
|
||
|
||
Exemple ".env" :
|
||
|
||
# IA Google Gemini (optionnel)
|
||
GEMINI_API_KEY=votre_cle
|
||
|
||
# Bring! (optionnel)
|
||
BRING_EMAIL=email@example.com
|
||
BRING_PASSWORD=motdepasse
|
||
|
||
# Sécurité API
|
||
API_TOKEN=
|
||
|
||
# Nettoyage automatique
|
||
RECIPE_RETENTION_DAYS=7
|
||
TRANSACTION_RETENTION_DAYS=90
|
||
|
||
---
|
||
|
||
🔒 Vie privée
|
||
|
||
EverShelf est conçu pour fonctionner en auto-hébergement :
|
||
|
||
- Pas de compte obligatoire
|
||
- Pas de cloud imposé
|
||
- Données stockées localement
|
||
- SQLite comme base de données
|
||
- Les fonctions IA utilisent uniquement les services configurés par l’utilisateur
|
||
|
||
---
|
||
|
||
🛠️ Développement
|
||
|
||
Technologies principales :
|
||
|
||
- PHP
|
||
- SQLite
|
||
- JavaScript
|
||
- HTML/CSS
|
||
- Docker
|
||
|
||
---
|
||
|
||
📜 Licence
|
||
|
||
Projet sous licence MIT.
|
||
|
||
---
|
||
|
||
🙏 Crédits
|
||
|
||
Projet original :
|
||
|
||
https://github.com/dadaloop82/EverShelf
|
||
|
||
Ce dépôt est un fork indépendant contenant des améliorations et adaptations personnelles. |