📖 Documentation Utilisateur ObeeSmart

Version 6.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. Commandes LoRaWAN (Downlink)
14. Boutique ObeeSmart
15. Application mobile
16. Analyse IA par photo
17. Gamification et succès
18. Support et tickets
19. Glossaire
20. Marketplace
21. Parrainage
22. 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   │
└────────┬────────┘    └────────┬────────┘    └────────┬────────┘
         │                      │                      │
         │     LoRaWAN (↑↓)     │                      │
         └──────────────────────┼──────────────────────┘
                                │
                    ┌───────────▼───────────┐
                    │    ChirpStack LNS     │
                    └───────────┬───────────┘
                                │
                    ┌───────────▼───────────┐
                    │   Plateforme Cloud    │
                    │      ObeeSmart        │
                    └───────────┬───────────┘
                                │
       ┌────────────┬───────────┼───────────┬────────────┐
       │            │           │           │            │
  ┌────▼─────┐ ┌────▼────┐ ┌───▼────┐ ┌────▼─────┐ ┌───▼─────┐
  │Interface │ │  App    │ │Notifs  │ │ Rapports │ │Boutique │
  │   Web    │ │ Mobile  │ │Push/TG │ │   Auto   │ │  Shop   │
  └──────────┘ └─────────┘ └────────┘ └──────────┘ └─────────┘

Nouveau en v6.0 : Les commandes LoRaWAN sont bidirectionnelles (↑ uplink = données capteur, ↓ downlink = commandes à distance). L'application mobile et la boutique viennent compléter l'écosystème.

---

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. Commandes LoRaWAN (Downlink)

Les devices LoRaWAN ObeeSmart sont bidirectionnels : ils envoient des données (uplink) mais peuvent aussi recevoir des commandes à distance (downlink) depuis l'interface web.

13.1 Principe de fonctionnement

Les commandes downlink sont mises en file d'attente sur le serveur LoRaWAN (ChirpStack). Elles sont transmises au device lors de son prochain créneau de réception (fenêtre RX après un uplink). En pratique, la commande est envoyée au device lors de sa prochaine transmission de données.

Les devices LoRaWAN CLASS_A n'ouvrent leur fenêtre de réception qu'après avoir émis. Le délai dépend donc de l'intervalle de transmission configuré (par défaut 5 minutes).

13.2 Commandes disponibles par type de device

Balances (BAL-)

Commande	Description	Paramètre
Forcer un envoi	Force une transmission immédiate des données	Aucun
Tare hardware	Remet le poids à zéro directement sur le capteur	Aucun
Changer l'intervalle	Modifie la fréquence de transmission	Secondes (60-3600)
Régler l'altitude	Configure l'altitude pour la compensation barométrique	Mètres
Redémarrer	Redémarre le firmware du device	Aucun

Capteurs environnementaux (SEN-) et Centrales Harpes (PWR-)

Commande	Description	Paramètre
Forcer un envoi	Force une transmission immédiate	Aucun
Changer l'intervalle	Modifie la fréquence de transmission	Secondes (60-3600)
Redémarrer	Redémarre le firmware du device	Aucun

13.3 Envoyer une commande

1. Accédez à la fiche détaillée du device (balance, capteur ou centrale)
2. Dans la sidebar, localisez la carte "Commandes device" (visible uniquement si le device a un Device EUI configuré)
3. Pour les commandes sans paramètre (Forcer un envoi, Tare, Redémarrer) : cliquez directement sur le bouton. Une confirmation est demandée pour les actions sensibles
4. Pour les commandes avec paramètre (Intervalle, Altitude) : cliquez sur le bouton, remplissez la valeur dans la fenêtre modale, puis validez

Le statut de l'envoi s'affiche en bas de la carte :

• Spinner : Envoi en cours
• Coche verte : Commande mise en file d'attente avec succès
• Croix rouge : Erreur (ChirpStack non configuré, device sans EUI, etc.)

13.4 Tare hardware vs Tare logicielle

	Tare logicielle	Tare hardware (downlink)
Où	Côté serveur ObeeSmart	Directement sur le capteur
Effet	Soustrait un offset dans l'interface	Remet à zéro le capteur physique
Quand l'utiliser	Ajustement rapide sans attendre le device	Après changement de ruche ou remplacement batterie
Délai	Immédiat	Au prochain uplink du device

13.5 Recommandations pour l'intervalle de transmission

Intervalle	Usage	Autonomie batterie
60s (1 min)	Diagnostic temporaire, observation d'un événement	Réduite
300s (5 min)	Usage normal recommandé	Bonne
600s (10 min)	Économie batterie en hiver	Excellente
3600s (1 heure)	Hivernage, surveillance minimale	Maximale

Après diagnostic, pensez à remettre l'intervalle à 300s pour préserver la batterie.

---

14. Boutique ObeeSmart

La boutique ObeeSmart est le magasin officiel de la plateforme pour acheter du matériel de monitoring apicole connecté.

14.1 Parcourir la boutique

Accédez à la boutique via le menu "Boutique". La page d'accueil présente :

• Produits en vedette : Sélection mise en avant par l'équipe ObeeSmart
• Catégories : Navigation par type de produit (Balances, Capteurs, Centrales Harpes, Accessoires, etc.)
• Barre de recherche : Recherche par nom ou description

14.2 Fiche produit

Chaque produit affiche :

• Photos du produit avec carrousel
• Description détaillée et caractéristiques techniques
• Prix et disponibilité en stock
• Bouton "Ajouter au panier" avec sélection de quantité

14.3 Panier et commande

1. Ajoutez les produits souhaités au panier
2. Vérifiez le contenu de votre panier (icône panier en haut de page)
3. Modifiez les quantités ou supprimez des articles si besoin
4. Cliquez "Commander" pour passer à la validation
5. Renseignez vos informations de livraison
6. Confirmez la commande

14.4 Suivi des commandes

Depuis "Mes commandes", suivez l'état de vos commandes :

Statut	Description
En attente	Commande reçue, en cours de préparation
En préparation	Commande en cours de traitement
Expédiée	Colis envoyé, numéro de suivi disponible
Livrée	Colis reçu
Annulée	Commande annulée

14.5 Boutique vs Marketplace

	Boutique	Marketplace
Vendeur	ObeeSmart (officiel)	Apiculteurs entre eux
Produits	Matériel connecté neuf	Matériel d'occasion ou neuf
Garantie	Garantie constructeur	Selon le vendeur
Paiement	Paiement direct	Paiement sécurisé avec commission 5%

---

15. Application mobile

L'application mobile ObeeSmart vous permet de surveiller vos ruches depuis votre smartphone, partout et à tout moment.

15.1 Installation

L'application est disponible pour Android et iOS :

• Android : Téléchargez depuis le Google Play Store ou installez l'APK fourni
• iOS : Téléchargez depuis l'App Store (ou via TestFlight en phase de test)

15.2 Connexion

Utilisez les mêmes identifiants que sur l'interface web (email + mot de passe). L'application utilise un système d'authentification sécurisé avec tokens JWT pour maintenir votre session active.

15.3 Navigation

L'application s'organise autour de 6 onglets en bas de l'écran :

Onglet	Contenu
Accueil	Tableau de bord avec synthèse, météo, prochaine visite, photo récente
Capteurs	Liste de tous vos devices (balances, capteurs, centrales, écrans)
Stats	Graphiques et statistiques de votre exploitation
Alertes	Liste des alertes avec filtrage et détail
Rucher	Gestion apicole (ruchers, ruches, visites, traitements, récoltes, rapports, IA)
Profil	Compte, abonnement, notifications, succès, classement

15.4 Fonctionnalités du tableau de bord mobile

Le dashboard mobile est optimisé pour un accès rapide :

• Cartes de synthèse : Ruches, devices en ligne, alertes actives, production
• Widget météo : Conditions actuelles et prévisions
• Prochaine visite : Rappel de la visite planifiée
• Dernière photo : Photo la plus récente de vos ruches
• Alertes critiques : Accès direct aux alertes urgentes

15.5 Différences entre Web et Mobile

Fonctionnalité	Web	Mobile
Tableau de bord	Complet avec graphiques poids, frelons, météo, KPIs	Synthèse optimisée avec météo et accès rapides
Gestion des devices	Tableau détaillé avec filtres avancés	Liste avec cartes et navigation par device
Commandes LoRaWAN	Interface complète avec tous les paramètres	Non disponible (utilisez le web)
Visites / Traitements / Récoltes	Formulaires complets	Formulaires adaptés au mobile
Analyse IA	Upload de photo	Prise de photo directe avec l'appareil
Rapports	Consultation et export PDF	Consultation de la liste
Notifications	Email, Telegram, Push navigateur	Push natif (notifications système)
Marketplace	Interface complète	Non disponible (utilisez le web)
Boutique	Interface complète	Non disponible (utilisez le web)
Succès / Classement	Non disponible	Badges, niveaux et classement des apiculteurs
Administration	Accès complet	Non disponible (réservé au web)
Mode hors ligne	Non	Consultation des dernières données en cache

15.6 Notifications push

L'application mobile prend en charge les notifications push natives :

1. Autorisez les notifications lors de la première utilisation
2. Configurez vos préférences dans Profil > Notifications :
   • Alertes critiques (poids, sécurité)
   • Alertes device (hors ligne, batterie)
   • Alertes frelons
   • Rappels de visites
3. Les notifications arrivent directement sur votre écran de verrouillage

15.7 Thème et interface

L'application mobile utilise un thème sombre avec des accents ambrés/miel, conçu pour :

• Réduire la fatigue oculaire lors des consultations en extérieur
• Économiser la batterie sur les écrans OLED
• Offrir un contraste optimal pour la lecture des données

---

16. Analyse IA par photo

ObeeSmart intègre une fonctionnalité d'analyse automatique par intelligence artificielle de vos photos de ruches.

16.1 Comment ça fonctionne

1. Prenez une photo de vos cadres, de l'entrée de la ruche, ou de tout élément à analyser
2. L'IA examine la photo et fournit une analyse détaillée :
   • État du couvain : Régularité, santé, présence de maladies
   • Population : Estimation de la densité d'abeilles
   • Réserves : État des cadres de miel et pollen
   • Anomalies : Détection de signes de maladie, parasites, problèmes
3. Un rapport d'analyse est généré avec des recommandations

16.2 Depuis le web

1. Allez dans Suivi Apicole ou sur la fiche d'une ruche
2. Uploadez une photo pour analyse
3. Consultez le résultat dans la liste des analyses

16.3 Depuis l'application mobile

1. Dans l'onglet Rucher, accédez à la section IA
2. Utilisez le bouton Caméra pour prendre une photo directement
3. L'analyse se lance automatiquement
4. Consultez le résultat et l'historique dans Liste des analyses

16.4 Historique des analyses

Toutes vos analyses sont conservées et accessibles :

• Date et photo analysée
• Résultat et score de confiance
• Recommandations associées
• Ruche liée (si spécifiée)

---

17. Gamification et succès

L'application mobile intègre un système de gamification pour encourager les bonnes pratiques apicoles.

17.1 Succès (Achievements)

Débloquez des badges en atteignant des objectifs :

Catégorie	Exemples de succès
Visites	Première visite, 10 visites, 50 visites...
Récoltes	Première récolte, 100 kg récoltés...
Monitoring	7 jours consécutifs de connexion, toutes les alertes traitées...
Communauté	Premier parrainage, 5 amis invités...

Consultez vos succès dans Profil > Succès.

17.2 Classement (Leaderboard)

Comparez-vous aux autres apiculteurs de la communauté ObeeSmart :

• Classement par score global
• Classement par production
• Classement par assiduité

Accessible dans Profil > Classement.

17.3 Crédits

Les crédits sont une monnaie interne utilisable sur la plateforme :

• Gagnés via le parrainage (10 crédits par ami inscrit)
• Gagnés via certains succès
• Utilisables dans la boutique ou la marketplace

Votre solde de crédits est visible dans votre profil et dans la barre de navigation.

---

18. Support et tickets

18.1 Créer un ticket de support

Si vous rencontrez un problème ou avez une question :

1. Cliquez sur le bouton "Support" en bas de page (ou dans le menu)
2. Remplissez le formulaire :
   • Sujet : Décrivez brièvement votre problème
   • Priorité : Basse, Normale, Haute, Urgente
   • Description : Détaillez le problème avec le maximum d'informations
3. Soumettez le ticket

18.2 Suivi de vos tickets

Consultez l'état de vos tickets dans Support > Mes tickets :

Statut	Description
Ouvert	Ticket soumis, en attente de traitement
En cours	Un technicien travaille sur votre demande
En attente	Nous attendons des informations de votre part
Résolu	Le problème a été traité
Fermé	Ticket clos

18.3 Messagerie du ticket

Chaque ticket dispose d'un fil de discussion :

• Échangez des messages avec l'équipe support
• Ajoutez des pièces jointes (captures d'écran, photos)
• Recevez des notifications quand une réponse est postée

---

19. 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
LoRaWAN	Protocole de communication longue portée, basse consommation
Uplink	Données envoyées par le device vers le serveur
Downlink	Commandes envoyées du serveur vers le device
DevEUI	Identifiant unique d'un device LoRa
ChirpStack	Serveur réseau LoRaWAN utilisé par ObeeSmart
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
CLASS_A	Mode LoRaWAN où le device n'écoute qu'après avoir émis
fPort	Port applicatif LoRaWAN (3 = commandes ObeeSmart)
Push	Notification envoyée directement sur le smartphone
JWT	Token d'authentification sécurisé pour l'app mobile

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
Boutique	Magasin officiel ObeeSmart pour le matériel connecté
Crédits	Monnaie interne gagnée par parrainage ou succès
Gamification	Système de badges et classement pour les apiculteurs

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

---

20. Marketplace

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

20.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.

20.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

20.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

20.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)

20.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

20.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

20.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

20.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

---

21. Parrainage

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

21.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

21.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.

21.3 Récompenses

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

21.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).

---

22. Administration Marketplace

Section réservée aux administrateurs.

22.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.

22.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).

22.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

22.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).

22.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

22.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 v6.0 - Dernière mise à jour : Février 2026