Champiscope

Une application interactive pour explorer et comprendre les champignons en France.

🚀 Objectifs du projet

Champiscope est une application web destinée à :

• Explorer les données sur les champignons présents en France grâce à des fiches d’identité détaillées et des recherches avancées.
• Sensibiliser à la biodiversité fongique par le biais de visualisations interactives (cartes et graphiques).

Cette application s’adresse à un public francophone, comprenant :

• Les amateurs de champignons (mycophiles).
• Les étudiants et chercheurs en biologie.
• Le grand public curieux.

---

🗂️ Fonctionnalités essentielles

• Gestion des utilisateurs :
  • Inscription, connexion, déconnexion.
  • Gestion de profils : favoris et historiques des résultats pour le quiz "Es-tu un expert en comestibilité ?".
• Recherche avancée :
  • Recherche par nom ou caractéristiques (toxicité, couleur, milieu, saison, etc.).
  • Présentation des champignons sous forme de catalogue avec fiches d’identité détaillées.
• Visualisations de données :
  • Carte interactive des observations de champignons en France sur la fiche d'identité de chaque espèce.
  • Graphiques pour explorer la comestibilité et saison de pousse.
• Interface utilisateur :
  • Design adapté aux ordinateurs.

---

📊 Sources de données

Les données utilisées proviennent de sources ouvertes et fiables, telles que :

• Identifier les champignons (1249 espèces).
• TaxRef (Référentiel des espèces françaises).
• Liste rouge des champignons menacés en France (PDF et CSV).
• GBIF (1 159 016 occurrences d'observations en France).

---

🛠️ Technologies utilisées

• Back-end : Python, Flask, SQLAlchemy, Requests.
• Front-end : HTML5, CSS3, JavaScript.
• Base de données : SQL (SGBD : SQLite).
• Gestion des versions : Git avec dépôt collaboratif sur GitHub.

---

🔧 Installation et utilisation

Prérequis

• Python 3.9+ installé.
• Gestionnaire de paquets pip.
• Environnement virtuel recommandé : venv.

Installation sur Linux (avec bash)

1. Clonez le dépôt Git

   git clone https://github.com/AmelieDogan/Champiscope.git

2. Déplacez-vous dans le répertoire du projet

   cd Champiscope

3. Créez un environnement virtuel

   python -m venv env

4. Activez votre environnement virtuel

   source env/bin/activate

5. Installez les dépendances de l'application

   pip install -r requirements.txt

6. Configuration des variables d’environnement

   • Ouvrez votre éditeur de code préféré et créez un fichier .env dans le répertoire Champiscope.
   • Ajoutez-y les variables suivantes :

     DEBUG=True  # ou False en production
     SQLALCHEMY_DATABASE_URI=sqlite:///champiscologues.db  # Exemple qui fonctionne si vous ne déplacez pas la base de données SQLite
     SECRET_KEY=your_secret_key_here # Vous devez en générer une, la plus aléatoire possible, et la copier ici
     CHAMPI_PAR_PAGE=27 # Nombre de champignons par page, nous vous conseillons un multiple de trois puisque les champignons s'affichent par trois sur chaque ligne

7. Lancer l’application

   python run.py

   Ensuite, ouvrez votre navigateur et accédez à http://127.0.0.1:5000.