📄 Documentation de la base de données Firebase

Cette documentation décrit la structure de la base de données Firebase utilisée dans le cadre de notre application d’observation de la biodiversité.

La base est divisée en deux grandes parties :

1. L’élaboration de protocoles d’observation et la gestion des accès, permettant de structurer les campagnes d’observation, de gérer les utilisateurs et les formulaires.
2. La sauvegarde et la visualisation des observations, qui concerne l’enregistrement des données terrain, qu’elles soient protocolaires ou spontanées, ainsi que leur traitement (validation, typage, etc.).

---

🧩 Partie 1 : Élaboration de protocoles et gestion des accès

users

• Contient les comptes utilisateur de l’application (observateurs ou validateurs).
• Référencé via :
  • [membres] dans codes_inventaire
  • [actor] dans workflows

forms

• Contient les formulaires utilisés pour les observations.
• Référencé via :
  • [form_id] dans codes_inventaire (observations spontanées)
  • [form_id] dans workflows (construction des protocoles)

workflows

• Représente un protocole d’observation composé de plusieurs forms.
• Contient :
  • [form_id] : liste de forms constituant le protocole
  • [actor] : liste de users administrateurs (validateurs)

sites

• Représente une parcelle de terrain observée.
• Référencé via [id] dans sessions

sessions

• Définit une période d'observation sur un ou plusieurs sites via plusieurs workflows.
• Contient :
  • [workflow_id] : liste des workflows associés
  • [id] : liste des sites concernés

codes_inventaire

• Représente un inventaire d’observation avec accès aux forms et sessions.
• Contient :
  • [membres] : liste d’users
  • [session_id] : sessions concernées
  • [form_id] : forms disponibles
• ⚠️ Les dates des sessions doivent être incluses dans la plage de dates du codes_inventaire.

---

🐾 Partie 2 : Sauvegarde et visualisation des observations

directory_observations

• Référentiel des types d’espèces et leurs traductions multilingues.
• Référencé via $type_species dans les collections $<type_species>

protocol

• Contient les informations générales liées à une observation protocolaire.
• Référencé via $group_id dans les collections $<type_species>

$<type_species> (collections dynamiques)

• Contiennent les observations classées par type d’espèce.
• Contiennent :
  • $type_species : référence à directory_observations
  • $group_id : (optionnel) référence à protocol si observation protocolaire

pending

• Contient les observations non validées d’utilisateurs non référencés dans workflows.
• Ces observations doivent être validées par un administrateur pour être transférées dans protocol et $<type_species>.

---

🌿 Collections auxiliaires

espece_insectes, espece_faune, espece_flore

• Listes des espèces référencées dans l'application.

---

✈️ Collections non utilisées

airports, form_keys

• Ces collections avaient des usages antérieur mais ne sont maintenant plus utilisées et seront supprimé prochainement