📖 Documentation Utilisateur ObeeSmart

Version 5.0 - Guide complet pour maîtriser votre plateforme de monitoring apicole connectée

---

Table des matières

1. Introduction
2. Tableau de bord principal
3. Gestion des ruchers
4. Gestion des ruches
5. Les balances connectées
6. Les écrans ObeeMonitor
7. Protection anti-frelons (Harpes)
8. Système d'alertes
9. Suivi apicole
10. Statistiques et analyses
11. Indicateurs clés (KPIs)
12. Rapports automatiques
13. Glossaire
14. Marketplace
15. Parrainage
16. Administration Marketplace

---

1. Introduction

Qu'est-ce qu'ObeeSmart ?

ObeeSmart est une plateforme complète de monitoring apicole connecté qui vous permet de surveiller vos ruches en temps réel, de protéger vos colonies contre les frelons asiatiques, et d'optimiser votre production de miel grâce à des indicateurs intelligents.

Les bénéfices pour l'apiculteur

Bénéfice	Description
🔔 Alertes en temps réel	Soyez prévenu instantanément en cas d'essaimage, vol, pillage ou problème de santé
⚖️ Suivi du poids	Suivez l'évolution du poids de vos ruches pour anticiper les miellées et les besoins en nourrissement
🌡️ Monitoring climatique	Température et humidité internes pour surveiller la santé de la colonie
🐝 Protection frelons	Comptage automatique des frelons éliminés par vos harpes électriques
📊 Analyses avancées	Indicateurs de santé (ISG, TSH) et rapports automatiques
📱 Accès mobile	Consultez vos données depuis n'importe où

Architecture du système

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Balances      │    │   Centrales     │    │    Écrans       │
│   connectées    │    │   Harpes        │    │   ObeeMonitor   │
└────────┬────────┘    └────────┬────────┘    └────────┬────────┘
         │                      │                      │
         │         LoRa / WiFi  │                      │
         └──────────────────────┼──────────────────────┘
                                │
                    ┌───────────▼───────────┐
                    │   Plateforme Cloud    │
                    │      ObeeSmart        │
                    └───────────┬───────────┘
                                │
              ┌─────────────────┼─────────────────┐
              │                 │                 │
    ┌─────────▼─────┐  ┌────────▼────────┐  ┌────▼────────┐
    │  Interface    │  │   Notifications │  │  Rapports   │
    │     Web       │  │    Telegram     │  │   Auto      │
    └───────────────┘  └─────────────────┘  └─────────────┘

---

2. Tableau de bord principal

Le tableau de bord est votre centre de commande pour avoir une vue d'ensemble instantanée de votre exploitation apicole.

2.1 Bannière saisonnière

En haut du tableau de bord, une bannière colorée indique la saison apicole en cours avec les actions prioritaires :

• 🌸 Printemps : Développement des colonies, préparation des hausses
• ☀️ Été : Période de miellée, surveillance des essaimages
• 🍂 Automne : Traitement varroa, mise en hivernage
• ❄️ Hiver : Contrôle des réserves, protection contre le froid

La bannière affiche les conseils adaptés à la saison (ex: "Contrôle réserves • Protection froid • Traitement oxalique")

2.2 Cartes de synthèse

Six cartes présentent les métriques essentielles :

Carte	Description	Interprétation
🏥 Score Santé	Score global de 0 à 100	> 70 = Bon, 50-70 = Attention, < 50 = Critique
🏠 Ruches	Nombre de ruches actives	Cliquez pour voir la liste
📡 Devices	Capteurs en ligne/total	Vérifiez que tous sont connectés
🐝 Frelons	Frelons éliminés aujourd'hui	Augmentation = période d'activité
🍯 Production	Récolte estimée de l'année	Objectif vs réalisé
🔔 Alertes	Alertes actives (critiques en rouge)	Traitez en priorité les critiques

2.3 Graphique de poids des ruches

Le graphique central montre l'évolution du poids total de vos ruches sur la période sélectionnée :

• Ligne verte : Poids total cumulé
• Ligne orange : Moyenne par ruche
• Barres jaunes : Alertes déclenchées

Périodes disponibles : 7j, 14j, 30j, 2 mois, 3 mois, 6 mois

Comment interpréter :

• 📈 Hausse régulière : Miellée en cours
• 📉 Baisse brutale : Possible essaimage ou vol (vérifiez les alertes)
• ➡️ Plateau : Période de consommation normale

2.4 Graphique Frelons & Météo

Ce graphique croise les données de frelons éliminés avec les conditions météo :

• Barres rouges : Nombre de frelons par jour
• Ligne verte : Température
• Ligne bleue : Humidité

Utilité : Identifiez les corrélations entre météo et activité des frelons pour optimiser le positionnement de vos harpes.

2.5 Panneau latéral droit

Visites

• Nombre de visites cette semaine
• Visites planifiées à venir
• Lien rapide vers la prochaine visite

Alertes actives

• Compteur par sévérité (Critiques / Warnings / Total)
• Bouton "Voir tout" pour accéder au centre d'alertes

Conditions actuelles

• Température extérieure
• Indice de butinage (0-100)
• Conditions idéales ou non pour le butinage

2.6 Indicateurs de performance (KPIs)

En bas du tableau de bord, quatre indicateurs clés :

KPI	Signification	Valeur idéale
ISG	Indice Santé Globale	> 75%
IP	Indice de Productivité (kg/ruche)	Dépend de votre région
TSH	Taux de Survie Hivernal	> 90%
IRE	Index Récolte Estimée	Progression vers objectif

2.7 Objectifs de saison

Suivez votre progression vers vos objectifs personnalisés :

• Récolte : kg récoltés / objectif
• Santé (ISG) : score actuel / cible
• Survie hiver : prévision basée sur l'état des colonies

---

3. Gestion des ruchers

3.1 Liste des ruchers

La page "Mes ruchers" présente tous vos emplacements d'élevage avec des indicateurs synthétiques :

Colonne	Information
Rucher	Nom et localisation
Ruches	Nombre total (actives ↑ / à visiter ↓)
ISG	Score santé moyen du rucher
Visite	Jours depuis dernière visite
Estimé	Production estimée en kg
Frelons	Compteur du jour
Devices	Capteurs en ligne / total

Filtres disponibles :

• Par statut (tous, en ligne, hors ligne)
• Par santé (toute santé, bon, attention, critique)
• Recherche par nom

3.2 Fiche détaillée d'un rucher

En cliquant sur un rucher, accédez à sa fiche complète :

Informations générales

• Nom, adresse, coordonnées GPS
• Environnement (rural, forêt, urbain, montagne)
• Description personnalisée

Carte de localisation

• Visualisation OpenStreetMap
• Altitude du site

Statistiques du rucher

• Nombre de ruches
• Poids total
• Stock estimé de miel
• Frelons éliminés (aujourd'hui / semaine)

Production & Hausses

• Estimation totale en kg
• Nombre de hausses prêtes à récolter
• État des hausses (operculées, pleines, partielles, vides)

Suivi apicole du rucher

• ISG moyen
• Jours depuis dernière visite
• Nombre de visites effectuées
• TSH (Taux Survie Hivernal)
• Alertes sur ruches nécessitant une visite

Équipements

• Balances connectées
• Capteurs environnementaux
• Harpes anti-frelons

Actions rapides

• ✏️ Modifier le rucher
• ➕ Ajouter une ruche
• 📋 Planifier une visite
• 💊 Traitement collectif
• 📊 Voir les statistiques

3.3 Liste des ruches du rucher

Un tableau liste toutes les ruches avec :

Colonne	Description
Nom	Nom et identifiant de la ruche
ISG	Score santé (couleur selon niveau)
TSH	Taux survie hivernal
Poids	Poids actuel si équipée d'une balance
Δ 24H	Variation de poids sur 24h
Reine	Année et couleur de marquage
Actions	Voir, dupliquer, modifier

3.4 Centrales Harpes

Liste des dispositifs anti-frelons installés sur le rucher :

Colonne	Description
Nom	Identifiant de la centrale
Frelons	Compteur journalier
Semaine	Total sur 7 jours
Mois	Total sur 30 jours
Total	Compteur global

---

4. Gestion des ruches

4.1 Liste globale des ruches

La page "Mes ruches" affiche toutes vos ruches avec filtrage multi-critères :

Cartes de synthèse :

• Total des ruches
• Ruches en ligne (avec capteur actif)
• Santé moyenne
• Ruches à visiter (> 21 jours)
• Mouvement détecté
• Poids total

Colonnes du tableau :

Colonne	Description
Nom	Nom et identifiant unique
Rucher	Emplacement de la ruche
Santé	Score ISG avec code couleur
Visite	Jours depuis dernière visite
Force	Évaluation de la colonie (★★★★★)
Poids	Poids actuel
Temp.	Température intérieure
Varroa	Niveau d'infestation
Récolte	Production de la saison
État	OK / Attention / Critique

4.2 Fiche détaillée d'une ruche

En-tête

• Nom de la ruche avec badge de statut (Active, En ligne, ISG)
• Fil d'Ariane pour navigation rapide
• Bouton "Modifier"

Métriques temps réel

Quatre cartes affichent les données actuelles :

Métrique	Source	Utilité
Poids	Balance	Suivi des réserves et miellée
Temp. intérieure	Capteur	Santé du couvain (idéal: 34-36°C)
Humidité	Capteur	Risque de moisissure (idéal: 50-70%)
Batterie	Balance	Planifier le remplacement

Suivi apicole

• Score santé (0-100)
• Jours depuis visite
• Force colonie (évaluation en étoiles)
• Récolte 2026 (production de la saison)

Indicateurs complémentaires :

• Niveau Varroa (none, low, medium, high)
• État des réserves (empty, low, medium, good, full)
• Reine vue il y a X jours

Graphique d'évolution du poids

• Visualisation sur 7j, 30j ou 90j
• Identification des tendances (miellée, consommation, événements)

Graphique Température & Humidité

• Courbe température intérieure vs extérieure
• Courbe humidité
• Détection des anomalies thermiques

Capteurs associés

Liste des devices connectés à cette ruche :

• Balance (poids, temp, batterie)
• Capteur environnemental (temp, humidité)

Panneau latéral - Visites

• Dernière visite (date et notes)
• Prochaine visite planifiée
• Historique complet accessible

Panneau latéral - Informations

• Type de ruche (Dadant, Langstroth, Warré...)
• Nombre de cadres
• Nombre de hausses
• Date de création

Panneau latéral - Reine

• Année d'introduction
• Couleur de marquage
• Origine (race/souche)
• Vérification recommandée si > 2 ans

Actions disponibles

• 📝 Nouvelle visite
• ✏️ Modifier la ruche
• 📊 Voir les statistiques
• 👁️ Voir le rucher
• 🗑️ Supprimer la ruche

---

5. Les balances connectées

5.1 Vue d'ensemble des balances

La page "Mes balances" centralise le suivi de toutes vos balances :

Cartes de synthèse :

• En ligne / Hors ligne
• Batteries faibles
• Poids total

Graphique d'évolution :

• Visualisation multi-ruches
• Sélection des balances à afficher
• Export des données

Tableau des balances :

Colonne	Description
Balance	Identifiant (BAL-XXXXXXXX)
Ruche / Rucher	Association
Statut	En ligne / Hors ligne
Poids	Valeur actuelle en kg
Δ 24H	Variation journalière
Batterie	Niveau avec indicateur
Temp.	Température mesurée
Signal	Force du signal LoRa (RSSI)
Dernière vue	Temps depuis dernière transmission

5.2 Fiche détaillée d'une balance

Identité du device

• Device Name (ex: BAL-2286CEF2)
• Device EUI (identifiant réseau)
• Statut de connexion

Métriques actuelles

• Poids actuel : en kg avec 2 décimales
• Température intérieure : du capteur
• Humidité intérieure : pourcentage
• Batterie : niveau et voltage

Données environnementales

• Pression atmosphérique
• Altitude
• Luminosité
• Température du miel
• Signal RSSI et SNR

Informations techniques

• Tare configurée
• Charge maximale
• Facteur de calibration
• Version firmware
• Dernière donnée reçue

Historique graphique

• Sélection de la métrique (Poids, Temp, Humidité, Batterie)
• Période : 24h, 7j, 30j
• Identification des patterns

Ruche associée

• Lien direct vers la ruche
• Informations de contexte

Actions de maintenance

Effectuer une tare

Met le poids actuel à zéro. Utilisez cette fonction :

• Après installation sur une nouvelle ruche
• Si la balance affiche un poids incorrect
• Après remplacement des piles

Calibrer

Ajustez la précision avec un poids de référence connu :

1. Placez un poids connu sur la balance (ex: 10 kg)
2. Entrez la valeur dans le champ
3. La balance recalcule son facteur de correction

Modifier

• Changer le nom
• Réassigner à une autre ruche
• Modifier la description

---

6. Les écrans ObeeMonitor

6.1 Qu'est-ce qu'un ObeeMonitor ?

L'ObeeMonitor est un écran déporté (type ESP32) qui affiche les données de vos ruches en temps réel, idéal pour :

• Installation dans votre miellerie
• Affichage au rucher (avec protection)
• Tableau de bord mural

6.2 Liste des écrans

Cartes de synthèse :

• En ligne / Inactifs / Hors ligne
• Total des écrans

Graphique d'activité :

• Taux de connectivité par écran
• Périodes actives/inactives

Tableau des écrans :

Colonne	Information
Nom	Nom personnalisé
Statut	En ligne / Hors ligne
Dernière activité	Timestamp
IP	Adresse réseau
Ruchers	Ruchers affichés

6.3 Configuration d'un écran

Paramètres de connexion

• Token API : Clé unique pour l'authentification
• URL de l'API : Endpoint à configurer sur l'écran

Configuration d'affichage

• Thème : Sombre / Clair / Auto
• Mode : Dashboard / Ruches / Frelons / Météo
• Intervalle : Fréquence de rafraîchissement (10-3600 sec)

Données affichées

Cochez les éléments à afficher :

• ✅ Frelons
• ✅ Poids
• ✅ Météo
• ✅ Alertes
• ✅ Harpes

Ruchers affichés

Sélectionnez les ruchers dont les données seront visibles sur cet écran.

Informations de diagnostic

• Firmware version
• Identifiant MCU
• Signal WiFi (RSSI)
• Adresse IP

---

7. Protection anti-frelons (Harpes)

7.1 Comment ça fonctionne ?

Les harpes électriques sont des dispositifs qui éliminent les frelons asiatiques par électrocution. Chaque centrale peut gérer jusqu'à 7 harpes et transmet les comptages via LoRa.

7.2 Centrales Harpes dans l'interface

Sur la fiche d'un rucher, la section "Centrales Harpes" affiche :

Information	Description
Nom	Identifiant de la centrale (PWR-XXXXXXXX)
Frelons	Compteur du jour (badge coloré)
Semaine	Total sur 7 jours
Mois	Total sur 30 jours
Total	Compteur depuis installation

7.3 Interprétation des données

Niveaux d'activité :

• 🟢 < 50/jour : Activité normale
• 🟡 50-200/jour : Pression modérée
• 🔴 > 200/jour : Forte pression, surveillez vos colonies

Saisonnalité :

• Pics d'activité généralement entre août et novembre
• Corrélation avec température (actifs > 12°C)

7.4 Alertes liées aux harpes

Le système génère des alertes automatiques :

• Harpe déconnectée : Câble coupé ou harpe HS
• Harpe sans consommation : Fusible grillé ou relais défaillant
• Tension centrale basse : Problème d'alimentation
• Pic de frelons : Augmentation soudaine de l'activité

---

8. Système d'alertes

8.1 Centre d'alertes

La page "Mes alertes" est votre centre de gestion pour toutes les notifications :

Compteurs en haut :

• Total des alertes
• Alertes ouvertes
• Alertes critiques (rouge)
• Avertissements (orange)

Filtres disponibles :

• Par statut (Actives, Résolues, Toutes)
• Par sévérité (Critiques, Warning, Info)
• Par type (Poids, Sécurité, Device, Combinées)
• Par date
• Par device

8.2 Types d'alertes

Alertes Poids (⚖️)

Type	Sévérité	Description
Essaimage détecté	🔴 Critique	Perte de 800g-1.5kg en <10min
Vol de ruche	🔴 Critique	Perte >5kg en <1h
Pillage	🟠 Warning	Perte progressive >500g/jour
Ruche trop légère	🔴 Critique	Poids <15kg en hiver
Miellée forte	🟢 Info	Gain >1kg/jour
Fin de miellée	🟢 Info	Ralentissement de la prise de poids
Consommation anormale	🟠 Warning	Perte >100g/jour en hiver

Alertes Sécurité (🔒)

Type	Sévérité	Description
Vol nocturne	🔴 Critique	Perte de poids significative la nuit
Mouvement détecté	🟢 Info	Vibration sur le capteur
Mouvements répétés	🟠 Warning	Plusieurs mouvements en 24h
Pic de frelons	🟠 Warning	Augmentation soudaine des éliminations

Alertes Device (📡)

Type	Sévérité	Description
Device hors ligne	🟠 Warning	Plus de communication depuis >2h
Batterie faible	🟠 Warning	Niveau <20%
Batterie critique	🔴 Critique	Niveau <10%
Signal faible	🟠 Warning	RSSI insuffisant
Harpe déconnectée	🟠 Warning	Câble ou harpe HS
Tension centrale basse	🟠 Warning	Alimentation défaillante

Alertes Combinées (🔄)

Type	Sévérité	Description
Pré-essaimage	🟠 Warning	Temp >37°C + agitation en journée
Colonie faible	🟠 Warning	Temp couvain <32°C + poids stable
Perte de reine	🟠 Warning	Comportement anormal suggérant orphelinage

8.3 Gestion des alertes

Pour chaque alerte, vous pouvez :

Action	Effet
Acquitter	Marque comme "vue" mais reste active
Résoudre	Ferme l'alerte avec note optionnelle
Snooze	Masque temporairement (30min, 1h, 4h)

8.4 Alertes urgentes (bannière)

Les alertes critiques apparaissent aussi dans une bannière rouge en haut du tableau de bord avec accès direct.

8.5 Notifications

Configurez la réception des alertes via :

• Telegram : Notifications instantanées sur votre téléphone
• Email : Résumé périodique ou alertes critiques
• Push navigateur : Si l'application est ouverte

---

9. Suivi apicole

9.1 Tableau de bord Suivi Apicole

Une vue dédiée aux pratiques apicoles (menu "Suivi Apicole") :

Synthèse

• Nombre de ruchers et ruches
• Alertes actives
• Production de l'année

Santé globale

• Distribution des ruches par état (bonnes / attention / critiques)
• ISG et TSH moyens
• Tendances de variation

Hausses

• Total des hausses posées
• Hausses prêtes à récolter
• État détaillé (operculées, pleines, partielles, vides)
• Estimation de la récolte disponible

Visites

• Visites effectuées cette semaine
• Visites planifiées
• Bouton pour planifier une nouvelle visite

Dernier rapport

• Accès au rapport hebdomadaire le plus récent
• Score de santé du rapport

Traitements en cours

• Liste des traitements actifs
• Dates de fin prévues

9.2 Gestion des visites

Créer une visite

1. Depuis une ruche ou un rucher, cliquez "Nouvelle visite"
2. Renseignez les observations :
   • Type de visite (Routine, Contrôle, Traitement, Récolte, Urgence)
   • Météo et température
   • Observations reine (vue, marquée, clipée)
   • Couvain (œufs, larves, operculé)
   • Force de la colonie (1-5 étoiles)
   • Réserves alimentaires
   • Présence de cellules royales
   • Niveau varroa
   • Actions effectuées
3. Ajoutez des notes et photos
4. Planifiez la prochaine visite

Types de visites

Type	Icône	Description
Routine	📅	Inspection régulière
Contrôle	🔍	Vérification ciblée
Traitement	💊	Application d'un traitement
Récolte	🍯	Récolte de miel
Urgence	⚠️	Intervention suite à alerte
Nourrissement	☕	Apport de nourriture
Préparation	🔧	Préparation hivernage/printemps

9.3 Gestion des traitements

Enregistrer un traitement

1. Menu "Suivi Apicole" > "Traitements"
2. Cliquez "Nouveau traitement"
3. Sélectionnez :
   • Rucher et/ou ruche(s) concernée(s)
   • Type (Varroa, Nosémose, Loque, etc.)
   • Produit utilisé (Apivar, Acide oxalique, etc.)
   • Dosage et méthode d'application
   • Dates de début et fin
4. Le système calcule automatiquement la date de récolte autorisée selon le délai d'attente

Calendrier des traitements recommandés

Saison	Traitements suggérés
Printemps	Acide formique, Acide oxalique
Été	Acide formique, Thymol, HopGuard
Automne	Apivar, Apiguard, Thymol
Hiver	Acide oxalique (dégouttement)

9.4 Gestion des récoltes

Enregistrer une récolte

1. Menu "Suivi Apicole" > "Récoltes"
2. Cliquez "Nouvelle récolte"
3. Renseignez :
   • Date de récolte
   • Rucher et ruche(s)
   • Type de miel (Acacia, Lavande, Toutes fleurs, etc.)
   • Nombre de hausses/cadres récoltés
   • Poids brut et net
   • Taux d'humidité
   • Qualité (Premium, Standard, etc.)
4. Optionnel : Valorisation (prix/kg), stockage, numéro de lot

Suivi de stock

• Visualisez le miel disponible
• Enregistrez les ventes
• Gérez la traçabilité par lot

---

10. Statistiques et analyses

10.1 Page Statistiques

Accédez à des analyses approfondies via "Monitoring" > "Statistiques" :

Métriques globales

• Ruches actives
• ISG moyen
• Stock estimé
• Poids moyen
• Frelons sur la période
• Hausses totales

Santé du cheptel

• Distribution visuelle (bonnes / attention / critiques)
• Évolution dans le temps

Tendances poids

• Ruches en hausse / stables / en baisse
• Poids total actuel

Production

• Stock estimé disponible
• Récolte réalisée
• État des hausses

Graphique frelons

• Évolution quotidienne sur 30 jours
• Identification des pics d'activité

Statistiques par rucher

Tableau comparatif de vos différents ruchers :

Rucher	Ruches	ISG	Hausses	Stock	Prêtes	Tendance

Performance par ruche

Classement de toutes vos ruches avec indicateurs de performance :

Ruche	Rucher	ISG	TSH	Poids	Variation	État

10.2 Périodes d'analyse

Sélectionnez la période de vos statistiques :

• 7 jours
• 30 jours
• 90 jours
• 1 an

---

11. Indicateurs clés (KPIs)

11.1 ISG - Indice Santé Globale

Définition : Score de 0 à 100 évaluant l'état sanitaire d'une ruche ou du cheptel.

Calcul basé sur :

• Force de la colonie (évaluation lors des visites)
• Présence et qualité du couvain
• Comportement des abeilles
• Absence de signes de maladie
• Niveau d'infestation varroa
• État des réserves

Interprétation :

Score	État	Action recommandée
80-100	🟢 Excellent	Maintenir le suivi
70-79	🟢 Bon	Surveillance normale
50-69	🟡 Attention	Visite de contrôle recommandée
30-49	🟠 Préoccupant	Intervention nécessaire
0-29	🔴 Critique	Action urgente requise

11.2 TSH - Taux de Survie Hivernal

Définition : Probabilité estimée (0-100%) qu'une colonie survive à l'hiver.

Calcul basé sur :

• Poids de la ruche (réserves alimentaires)
• Population estimée avant hivernage
• Historique des hivers précédents
• Traitements varroa effectués
• État sanitaire global

Seuils de référence :

Score	Pronostic
> 90%	Excellentes chances
70-90%	Bonnes chances, surveiller
50-70%	Risque modéré, prévoir nourrissement
< 50%	Risque élevé, intervention urgente

11.3 IP - Indice de Productivité

Définition : Production moyenne en kg de miel par ruche sur la saison.

Utilité :

• Comparer les performances entre ruchers
• Évaluer l'impact des pratiques apicoles
• Identifier les colonies les plus productives

Benchmarks régionaux (à titre indicatif) :

Région	Moyenne
Provence	15-25 kg/ruche
Sud-Ouest	20-35 kg/ruche
Île-de-France	10-20 kg/ruche
Montagne	8-15 kg/ruche

11.4 IRE - Index Récolte Estimée

Définition : Estimation de la production disponible à récolter basée sur le poids des hausses.

Calcul :

• Poids des hausses (mesuré ou estimé)
• Moins le poids des cadres vides
• Pondéré par le taux d'operculation

---

12. Rapports automatiques

12.1 Types de rapports

Type	Fréquence	Contenu
Hebdomadaire	Chaque lundi	Synthèse de la semaine
Mensuel	1er du mois	Bilan du mois écoulé
Saisonnier	À la demande	Analyse de la saison
Annuel	1er janvier	Bilan de l'année

12.2 Contenu d'un rapport

Chaque rapport inclut :

1. Résumé exécutif

   • Score de santé global
   • Faits marquants de la période

2. Analyse des poids

   • Évolution graphique
   • Variations significatives
   • Identification des miellées

3. Alertes de la période

   • Nombre et types
   • Alertes critiques
   • Taux de résolution

4. Météo

   • Conditions moyennes
   • Impact sur l'activité

5. Visites effectuées

   • Nombre de visites
   • Observations clés

6. Production

   • Estimation de récolte
   • Comparaison avec objectifs

7. Recommandations

   • Actions suggérées pour la période suivante
   • Alertes préventives

12.3 Consulter les rapports

1. Menu "Suivi Apicole" > "Rapports"
2. Sélectionnez le type de rapport
3. Choisissez la période
4. Options : Consulter en ligne ou télécharger en PDF

12.4 Notifications de rapports

Configurez l'envoi automatique :

• Par email chaque semaine/mois
• Notification Telegram avec résumé
• Push navigateur

---

13. Glossaire

Termes apicoles

Terme	Définition
Couvain	Ensemble des œufs, larves et nymphes
Hausse	Élément supérieur pour la récolte de miel
Miellée	Période de production de nectar par les fleurs
Essaimage	Division naturelle de la colonie
Nourrissement	Apport de sirop ou candy aux abeilles
Varroa	Acarien parasite des abeilles
Orphelinage	Colonie sans reine
Pillage	Vol de miel par des abeilles étrangères

Termes techniques

Terme	Définition
LoRa	Technologie de communication longue portée
DevEUI	Identifiant unique d'un device LoRa
RSSI	Indicateur de force du signal radio
SNR	Rapport signal/bruit
Tare	Remise à zéro du poids de référence
Calibration	Ajustement de la précision de mesure

Termes marketplace

Terme	Définition
Annonce	Article mis en vente sur la marketplace
Listing	Terme technique pour une annonce
Commission	Pourcentage prélevé sur les ventes sécurisées
Paiement sécurisé	Système de paiement protégeant acheteur et vendeur
Modération	Retrait d'une annonce par un administrateur
Vendeur vérifié	Vendeur dont l'identité a été validée
Parrainage	Système d'invitation permettant de gagner des crédits

Acronymes ObeeSmart

Acronyme	Signification
ISG	Indice Santé Globale
TSH	Taux de Survie Hivernal
IP	Indice de Productivité
IRE	Index Récolte Estimée
KPI	Key Performance Indicator
CA	Chiffre d'Affaires

---

14. Marketplace

La Marketplace ObeeSmart permet aux apiculteurs d'acheter et vendre du matériel apicole entre passionnés, directement depuis la plateforme.

14.1 Parcourir les annonces

La page Marketplace (menu "Marketplace") présente toutes les annonces actives :

Statistiques en haut :

• Annonces actives
• Nombre de vendeurs
• Transactions réussies

Sidebar - Catégories :
Filtrez par catégorie de matériel (Ruches, Extracteurs, Vêtements, etc.). Chaque catégorie peut avoir des sous-catégories.

Sidebar - Filtres :

Filtre	Description
Recherche	Mots-clés dans le titre/description
Prix	Fourchette min/max en euros
État	Neuf, Comme neuf, Bon état, État correct
Département	Code département (ex: 75)
Livraison	Livraison possible ou retrait uniquement

Tri disponible : Plus récentes, Prix croissant, Prix décroissant, Populaires.

Grille d'annonces :
Chaque annonce affiche une photo, le titre, la localisation, le prix et le nombre de vues. Cliquez sur une annonce pour voir les détails.

14.2 Fiche détaillée d'une annonce

La page de détail présente :

Photos

• Carrousel de photos (jusqu'à 6)
• Navigation avec flèches et miniatures

Informations

• Titre et prix
• Badges : état (Neuf, Comme neuf...), livraison disponible, paiement sécurisé
• Localisation du vendeur

Actions

• Contacter le vendeur : Ouvre une conversation privée
• Ajouter aux favoris : Sauvegarde l'annonce
• Se connecter : Pour les visiteurs non connectés

Profil vendeur

• Nom, note moyenne (étoiles), nombre d'avis
• Nombre de ventes réalisées
• Lien vers le profil complet

Statistiques de l'annonce

• Nombre de vues
• Nombre de favoris
• Nombre de contacts

14.3 Déposer une annonce

Pour vendre du matériel (menu "Déposer une annonce") :

1. Photos (max 6) : La première sera la photo principale
2. Catégorie : Sélectionnez la catégorie adaptée
3. Titre : Descriptif et accrocheur (200 car. max)
4. Description : Détaillez l'état, dimensions, année, raison de la vente
5. Prix et Quantité
6. État : Neuf / Comme neuf / Bon état / État correct / Pour pièces
7. Localisation : Ville, département, ou géolocalisation automatique
8. Livraison : Retrait sur place et/ou livraison (avec frais)
9. Paiement sécurisé : Commission de 5%, protège acheteur et vendeur

Options de publication :

• Enregistrer le brouillon : Sauvegarde sans publier
• Publier l'annonce : Met en ligne immédiatement

14.4 Gestion de ses annonces

La page "Mes annonces" permet de gérer vos annonces :

• Voir toutes vos annonces (actives, brouillons, vendues, en pause)
• Modifier ou supprimer une annonce
• Mettre en pause / remettre en ligne
• Suivre les statistiques (vues, favoris, contacts)

14.5 Messagerie

Le système de messagerie intégré permet de communiquer avec les vendeurs/acheteurs :

• Conversations liées à une annonce
• Historique des messages
• Notification de nouveaux messages

14.6 Favoris et achats

• Favoris : Retrouvez les annonces sauvegardées
• Mes achats : Suivi des transactions en tant qu'acheteur
• Mes ventes : Suivi des transactions en tant que vendeur

14.7 Statuts des annonces

Statut	Description
Brouillon	Annonce non publiée, en cours de rédaction
Active	Annonce visible sur la marketplace
En pause	Temporairement masquée par le vendeur
Vendue	Transaction finalisée
Expirée	Durée de publication dépassée
Modérée	Retirée par un administrateur

14.8 Statuts des transactions

Statut	Description
En attente paiement	L'acheteur doit effectuer le paiement
Paiement sécurisé	Paiement reçu, en attente d'expédition
Expédié	Le vendeur a envoyé l'article
Livré	L'article est arrivé
Terminé	Transaction complétée avec succès
Annulé	Transaction annulée
Remboursé	Paiement remboursé à l'acheteur
Litige	Différend entre acheteur et vendeur

---

15. Parrainage

Le système de parrainage vous permet d'inviter des amis apiculteurs et de gagner des crédits.

15.1 Votre lien de parrainage

Chaque utilisateur dispose d'un lien unique et d'un code de parrainage. Partagez-les pour inviter de nouveaux utilisateurs.

Modes de partage :

• Copier le lien dans le presse-papier
• Partager par email
• Partager sur Twitter, WhatsApp, Facebook

15.2 Envoyer une invitation

Envoyez une invitation personnalisée par email :

1. Saisissez l'email de votre ami
2. Cliquez "Envoyer l'invitation"
3. Votre ami reçoit un email avec un lien d'inscription

Limites : 10 invitations par jour, validité de 7 jours.

15.3 Récompenses

Action	Récompense
Ami s'inscrit	10 crédits
10 parrainages	Médaille "Influenceur"

15.4 Suivi des invitations

Le tableau de bord affiche :

Compteur	Description
Invitations envoyées	Total des invitations
Acceptées	Amis qui se sont inscrits
Crédits gagnés	Total des crédits obtenus
En attente	Invitations non encore acceptées

Historique : Tableau détaillé avec email, statut (En attente / Acceptée / Expirée), dates d'envoi et d'expiration, et actions (renvoyer / annuler).

---

16. Administration Marketplace

Section réservée aux administrateurs.

16.1 Dashboard Admin Marketplace

Le tableau de bord d'administration (Admin > Marketplace) présente :

6 KPIs principaux :

• Annonces totales
• Annonces actives
• Nombre de vendeurs
• Nombre de transactions
• Chiffre d'affaires total
• Commissions perçues

3 alertes d'action :

• Brouillons en attente de validation
• Annonces modérées
• Litiges en cours

Navigation vers les sous-sections : Annonces, Vendeurs, Transactions, Avis, Catégories.

Actions récentes : Journal des actions de modération effectuées.

16.2 Gestion des annonces

Interface de modération complète :

Statistiques rapides : Total, Actives, Brouillons, Modérées, En pause, Vendues.

Filtres :

Filtre	Options
Recherche	Titre, description
Statut	Brouillon, Active, En pause, Vendue, Expirée, Modérée, Supprimée
Catégorie	Toutes les catégories
Tri	Date, Prix, Vues

Actions individuelles :

Action	Effet
Approuver	Passe une annonce brouillon/modérée/en pause → active
Modérer	Retire l'annonce avec une raison obligatoire
Supprimer	Marque comme supprimée
Voir détail	Modal avec toutes les informations

Actions groupées :
Sélectionnez plusieurs annonces et appliquez une action en masse (Approuver / Modérer / Supprimer).

16.3 Gestion des vendeurs

Statistiques : Total vendeurs, Vérifiés, Non vérifiés.

Tableau des vendeurs :

Colonne	Description
Vendeur	Nom et nom d'affichage
Email	Adresse email
Ventes	Nombre de ventes réalisées
Note	Note moyenne (étoiles) + nombre d'avis
CA	Chiffre d'affaires total
Vérifié	Badge de vérification
Inscrit le	Date d'inscription

Actions :

• Vérifier / Retirer la vérification : Toggle du badge vendeur vérifié
• Voir détail : Modal avec profil complet, bio, localisation, annonces récentes
• Voir annonces : Lien filtré vers les annonces du vendeur

16.4 Suivi des transactions

Filtres : Statut, Date de début, Date de fin.

Tableau des transactions :

Colonne	Description
#	Numéro de transaction
Annonce	Titre de l'article
Vendeur	Nom du vendeur
Acheteur	Nom de l'acheteur
Montant	Prix total
Commission	Part prélevée
Statut	Badge coloré
Date	Date de création

Actions admin :

Action	Effet
Forcer terminée	Marque la transaction comme complétée
Rembourser	Marque comme remboursée (avec raison)
Annuler	Annule la transaction (avec raison)

Détail transaction : Modal avec informations complètes (montants, commission, chronologie, coordonnées vendeur/acheteur).

16.5 Modération des avis

Filtres : Visibilité (Tous / Visibles / Masqués), Note (1 à 5 étoiles).

Tableau des avis :

Colonne	Description
Évaluateur	Qui a laissé l'avis
Évalué	Le vendeur/acheteur évalué
Annonce	L'article concerné
Note	Étoiles (1-5)
Commentaire	Texte de l'avis (tronqué)
Visible	Badge Visible/Masqué
Date	Date de l'avis

Actions :

• Masquer / Afficher : Toggle de visibilité
• Supprimer : Suppression définitive

16.6 Gestion des catégories

Interface de gestion des catégories avec hiérarchie parent/enfant :

Colonne	Description
Icône	Icône de la catégorie
Catégorie	Nom (enfants indentés avec └)
Slug	Identifiant URL
Commission %	Taux de commission sur les ventes
Active	Badge Active/Inactive
Annonces	Nombre d'annonces dans la catégorie
Ordre	Boutons haut/bas pour réordonner

Actions :

• Modifier : Modal pour changer nom, icône, taux de commission, statut actif
• Activer / Désactiver : Toggle rapide
• Réordonner : Déplacer les catégories avec boutons ↑ ↓, puis sauvegarder l'ordre

---

Besoin d'aide ?

• 📧 Support : support@obeesmart.com
• 📖 FAQ : Consultez notre base de connaissances
• 💬 Communauté : Rejoignez notre forum d'entraide
• 🐛 Bug : Signalez via le bouton "Support" en bas de page

---

Documentation ObeeSmart v5.0 - Dernière mise à jour : Février 2026