Aller au contenu

Modèle conceptuel

Ce document pose le vocabulaire, le modèle de données et les règles métier sur lesquels s'aligne tout le reste du dossier d'analyse et de conception. Toute évolution du brief qui touche ces concepts doit être répercutée ici avant de s'attaquer aux parcours, aux stories ou aux maquettes.

Convention de nommage : les noms d'entités, d'attributs et de statuts adoptés ici sont les noms qui doivent apparaître dans l'IHM. On évite à dessein le jargon technique (formats de fichiers, sigles, anglicismes) pour ne pas rendre l'application illisible aux utilisateurs cibles (O2 - Facilité d'apprentissage, SC1 - Onboarding).

🛈 Statut : la structure des entités métier est stabilisée. Le schéma physique a depuis gagné des tables d'intégration plateforme (ancrage, dépôt reprenable, traitement, discussion avec le validateur), listées en fin de sommaire et rattachées aux fiches par leurs voisins.

Vue d'ensemble

L'application VigieChiro Companion organise les données autour d'un utilisateur unique (mono-utilisateur, hors-ligne). Cet utilisateur déclare un ou plusieurs sites de suivi, chaque site contenant un ou plusieurs points d'écoute. Sur chaque point, il réalise des passages (= une nuit complète d'enregistrement). Chaque passage produit une session d'enregistrement : les enregistrements originaux copiés depuis la SD, les séquences d'écoute (découpées en tranches de 5 s réelles, puis ralenties ×10) prêtes à être déposées sur Vigie-Chiro, ainsi que le journal du capteur et le relevé climatique de l'enregistreur utilisé.

Une fois les séquences d'écoute produites, l'utilisateur vérifie l'enregistrement par échantillonnage (sound check global). S'il est satisfait, il prépare le dépôt et téléverse directement sur Vigie-Chiro depuis l'application (repli navigateur possible). Le retour de Tadarida (résultats d'identification) arrive ensuite, et le passage entre alors en validation taxonomique (espèce par espèce).

Modèle conceptuel de données (MCD Merise) de VigieChiro Companion
MCD (méthode Merise) : entités à identifiant souligné, associations porteuses d'un verbe, cardinalités (min,max). Source modele-conceptuel.mcd, rendu avec Mocodo.

🖼️ Ouvrir le diagramme dans une vue plein écran ↗

Ce diagramme est un MCD (modèle conceptuel de données, méthode Merise) : il fixe le vocabulaire métier et la topologie des associations, sans préjuger de l'implémentation. Les clés étrangères n'y figurent pas : elles sont portées par les associations, et les cardinalités se lisent en (minimum, maximum) sur chaque patte. Vous re-spécifierez les classes Java de votre implémentation séparément (typage, méthodes, héritages selon vos choix d'architecture), et sa traduction relationnelle ajoutera les clés primaires et étrangères.

Le diagramme rend visible la séparation entre deux moments du cycle : la chaîne Passage → Session d'enregistrement → Séquence d'écoute → Sélection d'écoute (avant le dépôt VigieChiro, MUST du MVP), puis la chaîne Résultats d'identification → Observation → Taxon (après le retour Tadarida), livrée, avec la validation par l'observateur, l'avis du validateur MNHN et l'ancrage plateforme.

Sommaire des fiches

Le modèle conceptuel est éclaté en plusieurs fiches pour rester lisible. Chaque fiche est accessible depuis la barre latérale ; les liens ci-dessous servent de table des matières.

Entités

# Entité Rôle métier
C1 Utilisateur L'unique utilisateur de l'app (mono-poste, connecté à Vigie-Chiro par jeton).
C2 Site de suivi Unité géographique déclarée sur Vigie-Chiro web.
C3 Point d'écoute Code 2 caractères dans un site.
C4 Enregistreur Matériel terrain (Passive Recorder Teensy).
C4bis Micro Micro monté sur le PR (plusieurs modèles aux caractéristiques différentes).
C5 Passage Une nuit complète sur un point. Entité centrale.
C6 Session d'enregistrement Agrégat de données produit par un passage.
C7 Enregistrement original Fichier audio brut, ultrason, inaudible.
C8 Séquence d'écoute Fichier audible déposé sur Vigie-Chiro : 5 s réelles ralenties ×10 (50 s à l'écoute).
C9 Journal du capteur LogPR<n>.txt du firmware Teensy.
C10 Relevé climatique *_THLog.csv (optionnel).
C11 Sélection d'écoute Sous-ensemble de séquences pour la vérification.
C12 Résultats d'identification Résultats Tadarida (post-dépôt), importés par l'API ou par CSV.
C13 Observation Une ligne de résultats Tadarida.
C14 Taxon Code 6 lettres (genre + espèce).
C15 Groupe taxonomique Niveau hiérarchique au-dessus du taxon.
C16 Campagne Regroupement facultatif de passages relevant du même suivi.

Tables du schéma non modélisées comme entités

Le diagramme ci-dessus est conceptuel : il ne porte que les entités métier. Le schéma physique (migrations V01 → V38) contient en plus des tables d'intégration plateforme et techniques, décrites dans les voisins des fiches concernées :

Table Rôle Où elle apparaît
vigiechiro_link correspondance objet local ↔ _id plateforme (site / taxon / passage) + verrou du site voisins de C2, C5
passage_equipment matériel micro du déploiement d'une nuit (1:1 passage) voisin de C5
depot_unite, depot_plan dépôt reprenable, unité par unité, + empreinte de la liste source ; echec_definitif et cause_refus disent ce qui ne repart plus, et à quelle condition voisins de C5
participation_traitement état relevé du calcul Tadarida serveur (cache d'observation) voisin de C5
observation_message fil de discussion avec le validateur MNHN voisin de C13
passage_opportuniste participation opportuniste d'une nuit (R34) : la présence de la ligne porte le fait attribut de C5
site_tiers carré appartenant à un tiers (R35), dérivé de la synchronisation attribut de C2
point_commune commune du point (nom + code INSEE), dérivée une fois de ses coordonnées GPS (API Géo) ; l'absence de ligne dit « non résolue » attribut de C3
saved_filter_view, column_layout, app_setting tables techniques : vues de filtres, disposition des colonnes, réglages persistance d'IHM et de préférences, hors modèle métier
saved_view table morte : créée en V01, remplacée par saved_filter_view (V11), plus référencée par le code à retirer

Les tables métier d'intégration se lisent dans ce diagramme complémentaire, centré sur le Passage et l'Observation :

Extension d'intégration plateforme : matériel micro du passage, unités de dépôt reprenable, traitement de la participation, ancrage plateforme, et fil de discussion des observations
Entités d'intégration plateforme, greffées sur le Passage et l'Observation du MCD principal. L'ancrage plateforme (vigiechiro_link) est polymorphe : il relie de la même façon un site, un taxon ou un passage à son _id distant. Source modele-integration-plateforme.mcd, rendu avec Mocodo.

Autres fiches