Skip to content

Latest commit

 

History

History
253 lines (201 loc) · 8.13 KB

File metadata and controls

253 lines (201 loc) · 8.13 KB

🍷 Application Android de Cave à Vin (Offline, Material You)

🇺🇸 / 🇬🇧 🇫🇷

Table of contents

📱 Présentation du projet

Cette application Android permet de gérer une cave à vin complète entièrement hors ligne, avec une interface moderne respectant les principes du Material You.
Elle offre une gestion avancée des vins, un système de tri puissant, une modification rapide des stocks et la possibilité d’exporter la base de données.

L’objectif est de fournir une application élégante, rapide, intuitive et totalement personnalisable.


🎨 Fonctionnalités principales

🧭 Navigation et ergonomie

  • Interface Material You (thèmes dynamiques, couleurs adaptatives)
  • Ajout d’un vin via un formulaire multi‑pages (un groupement de champs = une page)
  • Menu de tri permettant de classer les vins selon n’importe quel champ

🍾 Gestion des vins

  • Ajout, modification et suppression de chaque vin
  • Modification rapide du stock via boutons + / -
  • Export de la base de données en CSV ou Excel
  • Tous les champs sont facultatifs lors de l’ajout d’un vin

🗂️ Champs disponibles pour chaque vin

🏷️ Informations générales

Details
  • Nom du vin
  • Producteur / Domaine
  • Cuvée
  • Millésime
  • Type de vin (effervescent, liquoreux, sec, demi-sec, doux, liqueur, autre)
  • Couleur (rouge, blanc, rosé, autre)

🌍 Origine

Details
  • Pays
  • Région viticole
  • Sous-région
  • Appellation
  • Classement (Grand Cru, Premier Cru…)

🍇 Cépages

Details
  • Cépage principal
  • Assemblage
  • Pourcentage de chaque cépage

⚗️ Caractéristiques techniques

Details
  • Teneur en alcool (%)
  • Sucre résiduel
  • Acidité
  • pH
  • Volume de la bouteille
  • Type de bouchon
  • Température de service

🛢️ Vinification & élevage

Details
  • Méthode de vinification
  • Type de fermentation
  • Durée d’élevage
  • Type de fût
  • Temps en barrique

👁️ Dégustation

Details
  • Aspect visuel
  • Arômes
  • Saveurs
  • Structure (tanins, acidité, corps)
  • Finale
  • Note globale

🍽️ Accords & contexte

Details
  • Plats recommandés
  • Type de cuisine
  • Occasions
  • Potentiel de garde
  • Date optimale de consommation
  • État de l’étiquette
  • Récompenses / médailles
  • Critiques reconnues

💶 Informations commerciales

Details
  • Prix
  • Disponibilité
  • Distributeur / caviste
  • Code produit / SKU
  • Code-barres
  • Quantité en stock
  • Emplacement dans la cave
  • Date d’achat
  • Prix d’achat

📝 Divers

Details
  • Description générale

🧱 Architecture technique

  • Kotlin + Jetpack Compose (Material You)
  • Base de données locale Room (offline)
  • Navigation Compose multi-écrans
  • Export CSV/Excel via librairies dédiées
  • Architecture MVVM
  • Kotlin JVM Target 11 | Compile SDK Version 36 | Minimin SDK 26

🧪 Tests

  • Tests unitaires (ViewModels, Repository)
  • Tests UI (Compose Testing)

📦 Export & sauvegarde

L’utilisateur peut exporter sa base de données complète en :

  • CSV (compatible Excel, LibreOffice…)
  • XLSX (Excel natif)
  • Backup local pour réimporter sur l'app

🧰 Installation

  1. Cloner le dépôt
  2. Ouvrir dans Android Studio
  3. Lancer l’application sur un appareil ou un émulateur Android 8+

📄 Licence

GNU GENERAL PUBLIC LICENSE 3


🚧 A faire plus tard

  • ✨ Avec un coup de baguette wati magique les infos suivantes sont mises à jour via les Issues du projet.
  • 💡 Cliquer sur une des celules pour voir l'avancement.
  • 🤝 Bon pour l'instant je sais pas quand je travaillerai dessus, et je sais que je n'ai que la quantité folle de 0 follower, mais si il y a des demandes je pourrais m'y pencher.

Usage de l'IA

L'IA a été utilisé pour ce projet, notamment pour la résolution des erreurs (premier projet en kotlin pour moi, j'y connais rien) et les docstrings. Estimation d'empreinte carbone : 200g.

Icon

Wine icon created by Smashicons - Flaticon..