Référentiels et Nomenclatures¶
Ce document explique l'intégration et la gestion des données de référence dans Cicada : nomenclatures métier, référentiel taxonomique (TaxRef), référentiel des habitats (HabRef), inventaire géologique (INPG) et catalogue des protocoles (CAMPanule).
Inspiré de GeoNature : L'architecture suit les conventions de GeoNature (noms de schemas, structure des tables, sources de données) pour assurer la compatibilité et faciliter les échanges de données.
Vue d'ensemble des référentiels¶
| Référentiel | Schema PostgreSQL | Source | Taille | Chargement |
|---|---|---|---|---|
| Nomenclatures | ref_nomenclatures |
Fichiers SQL internes | ~500 entrées | Automatique au démarrage |
| HabRef (habitats) | ref_habitats |
INPN via geonature.fr | ~35 000 habitats | Automatique au démarrage |
| TaxRef (taxonomie) | taxonomie |
INPN via geonature.fr | ~700 000 taxons | Automatique au démarrage |
| INPG (géologie) | ref_inpg |
Projet socle (base INPG de l'INPN) | ~3 956 sites | Automatique au démarrage |
| CAMPanule (protocoles) | ref_campanule |
INPN (PatriNat) | ~4 500 entrées | Automatique au démarrage |
| Découpage administratif | ref_geo |
GeoJSON embarqué (IGN via OpenDataSoft) | 109 départements + 26 régions | Automatique au démarrage |
Provenance des données¶
- TaxRef : Référentiel taxonomique national publié par le MNHN/INPN. Contient l'ensemble des noms scientifiques de la faune, la flore et la fonge de France. Téléchargé depuis
geonature.fr/data/inpn/taxonomie/. Mis à jour environ 1 fois par an. - HabRef : Référentiel des habitats naturels publié par le MNHN/INPN. Contient les habitats des principales typologies françaises et européennes (EUNIS, Corine Biotope, Natura 2000, etc.). Téléchargé depuis
geonature.fr/data/inpn/habitats/. Mises à jour très rares. - INPG : Inventaire National du Patrimoine Géologique, géré par le BRGM pour le compte du MNHN. Contient les sites géologiques d'intérêt patrimonial de France. Les données sont extraites du « projet socle » (base INPG de l'INPN), filtrées pour ne conserver que les sites à diffusion publique (
niveau_de_diffusion = 'Public'). Stockées dans un fichier SQL interne au projet (backend/inpg_data/inpg_inserts.sql). ⚠️ L'intégration INPG est susceptible d'évoluer : le mode de récupération des données pourrait changer à terme (API, téléchargement automatique, etc.). - CAMPanule : CATalogue des Méthodes et des Protocoles de collecte de données naturalistes, publié par PatriNat (OFB/CNRS/MNHN) via l'INPN. Contient les protocoles standardisés, les méthodes et techniques de collecte utilisés en France. Données publiques embarquées dans le projet en CSV (
backend/apps/campanule/data/). Version 1, septembre 2022. - Découpage administratif : contours des départements et collectivités françaises (métropole, DROM, COM, TAAF), dérivés du découpage IGN et embarqués en GeoJSON dans le projet (
backend/apps/geo/data/departements.geojson, ~550 Ko). Les régions sont reconstruites en base par agrégationST_Uniondes départements. Sert au filtre « zone géographique » de l'exploration des données. Voir la section dédiée ci-dessous.
Mode lite pour les tests¶
TaxRef propose un mode --lite qui ne charge que ~8 000 taxons représentatifs au lieu de ~700 000. C'est utile pour :
- Le développement local (démarrage plus rapide)
- Les tests CI (pas besoin de l'intégralité du référentiel)
- Les environnements de démonstration
Pour activer le mode lite, ajouter dans votre .env :
Le mode lite ne garde que : - Les noms de référence (cd_nom = cd_ref, pas les synonymes) - Les rangs espèce et supérieurs (pas les sous-espèces, variétés) - Un cap par groupe taxonomique (~700 oiseaux, ~250 mammifères, ~3000 angiospermes, etc.)
Installation¶
Première installation (Docker)¶
# 1. Lancer les services — tout est chargé automatiquement
docker compose up -d
# 2. (Optionnel) Créer les données de test
docker compose exec web python manage.py seed_testdata
Ce qui se passe automatiquement au démarrage :
python manage.py migrate— Crée les schemas et tables (donttaxonomie,ref_habitatsetref_inpg)python manage.py import_nomenclatures— Charge les nomenclatures métierpython manage.py import_habref— Charge le référentiel HabRef (~35k habitats)python manage.py import_taxref— Charge le référentiel TaxRef (~700k taxons)python manage.py import_inpg— Charge l'INPG (~3 956 sites géologiques)python manage.py import_campanule— Charge CAMPanule (~4 500 entrées protocoles/méthodes/techniques)python create_superuser.py— Crée le superutilisateurpython manage.py collectstatic— Fichiers statiques
Pour accélérer le démarrage en développement, ajouter dans .env :
Comparaison avec GeoNature¶
| Étape | GeoNature | Cicada |
|---|---|---|
| Schemas BD | Alembic branches | Django migrations |
| Nomenclatures | Auto (Alembic nomenclatures_inpn_data) |
Auto (import_nomenclatures) |
| HabRef | Auto (Alembic habitats_inpn_data) |
Auto (import_habref) |
| TaxRef | Manuel (geonature taxref import-v18) |
Manuel (import_taxref) |
| Réf. géographiques | Optionnel (flags dans install_all.ini) |
Non implémenté |
Nomenclatures métier¶
Structure des données¶
Types de nomenclatures (ref_nomenclatures.bib_nomenclatures_types) :
- id_type : Identifiant unique
- mnemonique : Code mnémonique du type
- label : Libellé descriptif
- definition : Définition détaillée
Nomenclatures (ref_nomenclatures.t_nomenclatures) :
- id_nomenclature : Identifiant unique
- id_type : Référence vers le type
- cd_nomenclature : Code technique unique (ex: RNN, RNR)
- mnemonique : Mnémonique métier
- label : Libellé affiché
- hierarchy : Code hiérarchique (optionnel)
- actif : Indicateur d'activation
Commandes¶
# Import initial (idempotent — skip si déjà fait)
docker compose exec web python manage.py import_nomenclatures
# Upsert : ajouter les nouvelles + mettre à jour les labels/définitions modifiés
docker compose exec web python manage.py import_nomenclatures --force
# Upsert + nettoyage : idem + supprime les entrées absentes des fichiers SQL
docker compose exec web python manage.py import_nomenclatures --force --prune
# Vérification
docker compose exec web python test_nomenclatures.py
Mode upsert intelligent (--force)¶
La commande utilise INSERT ... ON CONFLICT DO UPDATE pour :
- Ajouter les nouvelles nomenclatures (nouveaux types ou valeurs)
- Mettre à jour les labels, définitions ou hiérarchies modifiés
- Conserver les données existantes liées par FK (suivis, opérations, etc.)
C'est la méthode recommandée après toute modification des fichiers SQL.
Nettoyage des obsolètes (--prune)¶
Le flag --prune (implique --force) supprime en plus les entrées qui ne sont plus présentes dans les fichiers SQL. Si une nomenclature est référencée par des données existantes (FK), elle est conservée avec un avertissement.
Workflow typique après modification des nomenclatures :
# 1. Modifier les fichiers SQL
# backend/nomenclatures_data/types_inserts.sql
# backend/nomenclatures_data/nomenclatures_inserts.sql
# 2. Appliquer les changements (ajouter + mettre à jour)
docker compose exec web python manage.py import_nomenclatures --force
# 3. (Optionnel) Supprimer les entrées obsolètes
docker compose exec web python manage.py import_nomenclatures --force --prune
Utilisation dans le code¶
from apps.core.models import TypeNomenclature, Nomenclature
# Par type
type_espace = TypeNomenclature.objects.get(mnemonique='Espace naturel')
espaces = Nomenclature.objects.filter(id_type=type_espace)
# Par mnémonique
rnn = Nomenclature.objects.get(mnemonique='RNN')
API REST¶
GET /api/nomenclatures/types/— Liste des typesGET /api/nomenclatures/— Liste des nomenclatures (filtrage et recherche)
Fichiers de données¶
backend/nomenclatures_data/types_inserts.sql— Types de nomenclaturesbackend/nomenclatures_data/nomenclatures_inserts.sql— Nomenclatures
Référentiel taxonomique (TaxRef)¶
Présentation¶
TaxRef est le référentiel taxonomique national de l'INPN. Il contient l'ensemble des espèces de la faune, la flore et la fonge de France (~700 000 noms).
- Version actuelle : v18 (2025)
- Mise à jour : ~1 fois/an par l'INPN
- Schema :
taxonomie - Source :
geonature.fr/data/inpn/taxonomie/TAXREF_v18_2025.zip
Tables¶
| Table | Description | Taille |
|---|---|---|
taxonomie.taxref |
Table principale (cd_nom = PK) | ~700k lignes |
taxonomie.bib_taxref_rangs |
Rangs taxonomiques (Règne, Classe, Espèce...) | ~16 entrées |
taxonomie.bib_taxref_habitats |
Types d'habitats associés (Marin, Terrestre...) | 8 entrées |
taxonomie.bib_taxref_statuts |
Statuts taxonomiques (Présent, Endémique...) | ~15 entrées |
taxonomie.t_meta_taxref |
Versioning du référentiel | 1 entrée |
taxonomie.vm_taxref_list_forautocomplete |
Vue matérialisée pour l'autocomplete | ~350k lignes |
Commandes¶
# Import complet TaxRef v18 (version par défaut — ~700k taxons)
docker compose exec web python manage.py import_taxref
# Import allégé (~8000 taxons — pour dev/tests)
docker compose exec web python manage.py import_taxref --lite
# Version spécifique
docker compose exec web python manage.py import_taxref --version 17
# Forcer le rechargement
docker compose exec web python manage.py import_taxref --force
# Passer de lite à complet
docker compose exec web python manage.py import_taxref --force
# Spécifier le répertoire de cache (défaut: /tmp/cicada_taxref_cache/)
docker compose exec web python manage.py import_taxref --cache-dir /data/cache
# Rafraîchir la vue matérialisée (après modification des données)
docker compose exec web python manage.py refresh_taxref_views
Processus d'import détaillé¶
- Téléchargement du ZIP (~100 Mo) avec cache local
- Décompression dans le répertoire de cache
- Chargement des données de référence (rangs, habitats, statuts)
- Chargement du CSV principal via
COPY FROM STDIN(encodage WIN1252, délimiteur tabulation) - Création de la vue matérialisée
vm_taxref_list_forautocomplete(noms valides uniquement, concaténation nom latin + nom vernaculaire) - Indexation trigramme (
gin_trgm_ops) +unaccent()pour la recherche floue - Mise à jour des métadonnées (version, date)
Cache local¶
Les fichiers téléchargés sont conservés dans /tmp/cicada_taxref_cache/ :
- Le ZIP n'est pas re-téléchargé s'il existe déjà
- Le répertoire décompressé est réutilisé
- Pour forcer un nouveau téléchargement, supprimer le cache ou utiliser un autre répertoire
API REST¶
| Endpoint | Description |
|---|---|
GET /api/taxref/version/ |
Version courante du référentiel |
GET /api/taxref/ |
Liste paginée avec filtres (regne, group2_inpn, id_rang, valid_only) |
GET /api/taxref/<cd_nom>/ |
Détail d'un taxon |
GET /api/taxref/autocomplete/?search=<terme>&limit=20 |
Autocomplete trigramme (min 2 caractères) |
GET /api/taxref/search/<field>/<ilike>/ |
Recherche libre sur un champ |
Utilisation dans le code¶
from apps.taxonomy.models import Taxref, TMetaTaxref
# Chercher un taxon par cd_nom
loup = Taxref.objects.get(cd_nom=60577)
# Taxons valides d'un groupe
oiseaux = Taxref.objects.filter(
group2_inpn='Oiseaux',
cd_nom=F('cd_ref') # Noms valides uniquement
)
# Version installée
meta = TMetaTaxref.objects.filter(referential_name='taxref').first()
Bonnes pratiques¶
- Pas de FK vers TaxRef depuis vos tables métier — stocker
cd_nomcomme entier et valider à l'import. Cela permet de mettre à jour TaxRef sans casser les relations. - Rafraîchir la vue matérialisée après toute modification manuelle des données.
- Prévoir les mises à jour annuelles : TaxRef est mis à jour ~1 fois/an. La commande
import_taxref --forcepermet de recharger.
Référentiel des habitats (HabRef)¶
Présentation¶
HabRef est le référentiel des habitats naturels de l'INPN. Il contient les habitats des principales typologies françaises et européennes.
- Version actuelle : 5.0
- Mise à jour : Très rare
- Schema :
ref_habitats - Source :
geonature.fr/data/inpn/habitats/HABREF_50.zip
Tables¶
| Table | Description |
|---|---|
ref_habitats.typoref |
Typologies d'habitats (EUNIS, Corine Biotope, Natura 2000...) |
ref_habitats.habref |
Table principale des habitats (cd_hab = PK) |
ref_habitats.habref_corresp_hab |
Correspondances entre typologies |
ref_habitats.habref_corresp_taxon |
Correspondances habitat-taxon |
ref_habitats.autocomplete_habitat |
Table dénormalisée pour l'autocomplete |
Commandes¶
# Import HabRef (automatique au démarrage Docker)
docker compose exec web python manage.py import_habref
# Forcer le rechargement
docker compose exec web python manage.py import_habref --force
# Spécifier le répertoire de cache
docker compose exec web python manage.py import_habref --cache-dir /data/cache
API REST¶
| Endpoint | Description |
|---|---|
GET /api/habref/<cd_hab>/ |
Détail d'un habitat |
GET /api/habref/autocomplete/?search=<terme>&cd_typo=<id>&limit=20 |
Autocomplete trigramme |
GET /api/habref/typo/ |
Liste des typologies |
GET /api/habref/correspondance/<cd_hab>/ |
Correspondances entre typologies |
Utilisation dans le code¶
from apps.habitats.models import Habref, Typoref
# Chercher un habitat
habitat = Habref.objects.get(cd_hab=1234)
# Habitats d'une typologie
eunis = Habref.objects.filter(cd_typo=7) # EUNIS
Inventaire géologique (INPG)¶
Présentation¶
L'INPG (Inventaire National du Patrimoine Géologique) recense les sites géologiques d'intérêt patrimonial de France. Il est géré par le BRGM pour le compte du MNHN.
- Source : Projet socle (base INPG de l'INPN)
- Schema :
ref_inpg - Filtre : Seuls les sites à diffusion publique sont inclus
- Données : Fichier SQL interne (
backend/inpg_data/inpg_inserts.sql, ~34 Mo)
⚠️ Évolution prévue : Le mode de récupération des données INPG pourrait évoluer à terme (API directe, téléchargement automatique depuis l'INPN, etc.). L'architecture actuelle (fichier SQL embarqué) est une solution temporaire.
Table¶
| Table | Description | Taille |
|---|---|---|
ref_inpg.inpg |
Sites géologiques (id_inpg = PK) | ~3 956 lignes |
La table contient 88 colonnes dont : id_inpg, id_metier, lb_site (nom), geom (MultiPolygon SRID 4326), region, departements, communes, interet_geol_principal, typologie_1/2/3, notes d'évaluation, dates de validation, etc.
Commandes¶
# Import INPG (automatique au démarrage Docker)
docker compose exec web python manage.py import_inpg
# Forcer le rechargement
docker compose exec web python manage.py import_inpg --force
API REST¶
| Endpoint | Description |
|---|---|
GET /api/inpg/ |
Liste paginée des sites INPG |
GET /api/inpg/<id_inpg>/ |
Détail d'un site |
GET /api/inpg/autocomplete/?search=<terme>&limit=20 |
Autocomplete trigramme (min 2 caractères) |
POST /api/inpg/validate-bulk/ |
Validation en masse (id_inpg, id_metier ou nom de site) |
Utilisation dans le code¶
from apps.geology.models import Inpg
# Chercher un site par id_inpg
site = Inpg.objects.get(id_inpg=42)
# Recherche par nom
sites = Inpg.objects.filter(lb_site__icontains='grotte')
Mise à jour des données¶
Pour mettre à jour les données INPG :
1. Exporter la table inpg depuis la base du projet socle (DBeaver ou autre outil), en filtrant sur niveau_de_diffusion = 'Public'
2. Remplacer le fichier backend/inpg_data/inpg_inserts.sql
3. Relancer l'import : docker compose exec web python manage.py import_inpg --force
Catalogue des protocoles (CAMPanule)¶
Présentation¶
CAMPanule (CATalogue des Méthodes et des Protocoles) est le référentiel national des protocoles de collecte de données naturalistes, publié par PatriNat (OFB/CNRS/MNHN) via l'INPN.
- Version actuelle : v1 (septembre 2022)
- Mise à jour : Très rare (v1 depuis 2022, pas de v2 annoncée)
- Schema :
ref_campanule - Source : CSV embarqués dans le projet (
backend/apps/campanule/data/) - Source originale : https://inpn.mnhn.fr/programme/campanule (format Access .accdb)
Note (issue #565) — protocoles standardisés MhéO : côté interface, on parle désormais de « protocole standardisé » plutôt que de « Campanule » (MhéO n'est pas dans CAMPanule, mais a vocation à y être intégré). En plus du catalogue INPN, 5 protocoles standardisés MhéO (boîte à outils Milieux humides — Amphibiens, Flore, Odonates, Pédologie, Piézométrie) sont chargés dans les mêmes tables
ref_campanule.*, dans une plage de codes réservée (cd_protocole >= 900000, cf.MHEO_BASE). Définis en Python dansbackend/apps/campanule/data_mheo.py(et non en CSV), ils sont ajoutés parimport_campanule: au premier import complet, et en top-up idempotent au démarrage suivant si le catalogue est déjà installé mais que MhéO manque (pas besoin de--force).
Tables¶
| Table | Description | Taille |
|---|---|---|
ref_campanule.protocoles |
Protocoles de collecte (cd_protocole = PK) | ~224 |
ref_campanule.methodes |
Méthodes de collecte (cd_methode = PK) | ~15 |
ref_campanule.techniques |
Techniques de collecte (cd_technique = PK) | ~178 |
ref_campanule.attributs |
Vocabulaire contrôlé (domaine, objectif, cible, matériel) | ~145 |
ref_campanule.prot_echantillonnage |
Plans d'échantillonnage par protocole | ~254 |
ref_campanule.docs_web |
Références bibliographiques (liens INPN Docs-Web) | ~252 |
ref_campanule.prot_attributs_rel |
Relation protocole-attribut (N-N) | ~1 536 |
ref_campanule.prot_biblio_rel |
Relation protocole-document (N-N) | ~225 |
ref_campanule.prot_meth_rel |
Relation protocole-méthode (N-N) | ~46 |
ref_campanule.prot_tech_rel |
Relation protocole-technique (N-N) | ~406 |
ref_campanule.meth_attributs_rel |
Relation méthode-attribut (N-N) | ~36 |
ref_campanule.meth_biblio_rel |
Relation méthode-document (N-N) | ~30 |
ref_campanule.tech_attributs_rel |
Relation technique-attribut (N-N) | ~730 |
ref_campanule.tech_biblio_rel |
Relation technique-document (N-N) | ~196 |
ref_campanule.autocomplete_protocole |
Table dénormalisée pour l'autocomplete (protocoles non obsolètes) | ~199 |
Contenu métier¶
Catégories de protocoles (categorie_prot) :
- Protocoles standardisés : reproductibles, documentés, pour des territoires variés
- Enquêtes (ponctuelles ou continues) : science participative, remontées de données
- Guides et recommandations : cadres pour la mise en place de suivis
Groupes cibles (cible) : Oiseaux, Mammifères, Insectes et araignées, Amphibiens et reptiles, Plantes, Habitats, Multi-groupes, etc.
Catégories d'attributs :
- DOMAINE : Continental terrestre, aquatique, littoral, marin
- OBJECTIF : Distribution, dynamique, état de santé, richesse spécifique, etc.
- TYPE_CIBLE : Espèce, communauté, habitat
- MATERIEL : Piège Malaise, détecteur ultrasons, etc. (techniques uniquement)
- COLLECTE : Photographie, spécimen, indice de présence (techniques uniquement)
- GPE_GRAND_PUBLIC : Groupes taxonomiques vulgarisés
Commandes¶
# Import CAMPanule (automatique au démarrage Docker)
docker compose exec web python manage.py import_campanule
# Forcer le rechargement
docker compose exec web python manage.py import_campanule --force
Utilisation dans le code¶
from apps.campanule.models import (
CampanuleProtocole, CampanuleTechnique, CampanuleProtTechRel,
AutocompleteProtocole
)
# Chercher un protocole
stoc = CampanuleProtocole.objects.filter(
lb_protocole_court__icontains='STOC'
).first()
# Techniques utilisées par un protocole
tech_ids = CampanuleProtTechRel.objects.filter(
cd_protocole=stoc.cd_protocole
).values_list('cd_technique', flat=True)
techniques = CampanuleTechnique.objects.filter(cd_technique__in=tech_ids)
# Recherche autocomplete (protocoles non obsolètes)
from django.db import connection
with connection.cursor() as cursor:
cursor.execute("""
SELECT cd_protocole, lb_protocole_court, cible, categorie_prot
FROM ref_campanule.autocomplete_protocole
WHERE search_name ILIKE %s
ORDER BY similarity(search_name, %s) DESC
LIMIT 20
""", ['%oiseaux%', 'oiseaux'])
Mise à jour des données¶
En cas de nouvelle version de CAMPanule :
1. Télécharger le nouveau .accdb depuis https://inpn.mnhn.fr/programme/campanule
2. Exporter les tables en CSV (depuis Access ou via mdbtools)
3. Convertir en UTF-8 : iconv -f CP1252 -t UTF-8 fichier.csv > fichier_utf8.csv
4. Remplacer les CSV dans backend/apps/campanule/data/
5. Si le schéma a changé (nouvelles colonnes/tables), adapter les modèles Django et créer une migration
6. Relancer : docker compose exec web python manage.py import_campanule --force
Autocomplete des référentiels¶
Tous les autocompletes (TaxRef, HabRef, INPG, CAMPanule) fonctionnent sur le même principe :
- Minimum 2 caractères saisis pour déclencher la recherche
- Recherche trigramme (
pg_trgm) avecunaccent()pour l'insensibilité aux accents - Tri par pertinence via
similarity()(les résultats les plus proches en premier) - Limite configurable (défaut : 20 résultats, max : 100)
- Cache côté client pour éviter les requêtes redondantes
| Référentiel | Champs recherchés | Endpoint |
|---|---|---|
| TaxRef | Nom scientifique + nom vernaculaire (via vue matérialisée) | /api/taxref/autocomplete/ |
| HabRef | Nom français + code nomenclature (via table dénormalisée) | /api/habref/autocomplete/ |
| INPG | Nom du site (lb_site) + code métier (id_metier) |
/api/inpg/autocomplete/ |
| CAMPanule | Libellé court + complet + auteur + cible (via table dénormalisée) | (API à venir) |
Import en masse¶
Chaque référentiel dispose aussi d'un endpoint validate-bulk (POST) qui permet de valider une liste d'entrées (codes ou noms) en une seule requête. L'auto-détection du format (numérique = code, texte = nom) permet de mélanger les formats. Les entrées non trouvées sont accompagnées de suggestions (candidats les plus proches par trigramme).
Architecture technique¶
Schemas PostgreSQL¶
Cicada utilise 12 schemas PostgreSQL :
| Schema | Source | Description |
|---|---|---|
utilisateurs |
GeoNature | Utilisateurs et organismes |
referentiels |
ODASE | Espaces protégés |
ref_nomenclatures |
GeoNature | Nomenclatures métier |
ref_geo |
GeoNature | Référentiels géographiques (futur) |
general |
ODASE | Plans de gestion |
fichiers |
ODASE | Fichiers attachés |
ccd_commons |
Cicada | Modules et logs |
ccd_notifications |
Cicada | Notifications et validations |
taxonomie |
GeoNature | Référentiel taxonomique TaxRef |
ref_habitats |
GeoNature | Référentiel des habitats HabRef |
ref_inpg |
Cicada | Inventaire géologique INPG |
ref_campanule |
Cicada/INPN | Catalogue des protocoles CAMPanule |
Extensions PostgreSQL requises¶
| Extension | Usage |
|---|---|
postgis |
Données géospatiales |
pg_trgm |
Index trigramme pour l'autocomplete (TaxRef, HabRef, INPG, CAMPanule) |
unaccent |
Recherche insensible aux accents |
uuid-ossp |
Génération d'UUID |
Performance de l'autocomplete¶
L'autocomplete sur 700k taxons fonctionne en <50ms grâce à :
1. Vue matérialisée : pré-calcule search_name = nom latin + nom vernaculaire
2. Index trigramme (gin_trgm_ops) : recherche partielle performante
3. unaccent() : insensibilité aux accents sans pénalité de performance
4. similarity() : tri par pertinence (les résultats les plus proches en premier)
Découpage administratif (ref_geo)¶
Présentation¶
Référentiel des régions et départements, utilisé par le filtre « zone géographique » de l'exploration des données. Les sites de CICADA n'ont aucun champ administratif : leur rattachement est calculé géométriquement à partir de leur emprise PostGIS.
Le schéma reprend la structure de GeoNature (bib_areas_types + l_areas), avec deux
écarts assumés : les géométries sont en EPSG:4326 comme le reste de CICADA (GeoNature les
stocke dans le SRID local), et l_areas.id_area_parent matérialise le lien
département → région, nécessaire à l'arbre du filtre.
Tables¶
| Table | Contenu |
|---|---|
ref_geo.bib_areas_types |
Types de zones : REG, DEP |
ref_geo.l_areas |
109 départements + 26 régions, avec géométrie et centroïde |
ref_geo.cor_site_area |
Rattachement site ↔ zone, avec l'origine du lien |
Un site rattaché à un département l'est aussi à la région correspondante, pour que le filtre puisse interroger indifféremment l'un ou l'autre niveau.
Origine d'un rattachement (cor_site_area.source)¶
| Valeur | Signification |
|---|---|
intersect |
L'emprise du site intersecte le département. Cas normal. |
nearest |
Aucune intersection terrestre (réserve marine, géométrie approximative au large) : rattachement au département le plus proche, dans la limite de 1° (~110 km). Au-delà, le site n'est rattaché à rien. |
manual |
Saisie manuelle. Jamais écrasé par un recalcul. |
Commandes¶
# Import du référentiel + recalcul du rattachement des sites (auto au démarrage)
docker compose exec web python manage.py import_ref_geo
# Réimport complet
docker compose exec web python manage.py import_ref_geo --force
# Import sans recalculer les sites
docker compose exec web python manage.py import_ref_geo --no-link
# Recalcul du rattachement seul
docker compose exec web python manage.py refresh_site_areas
docker compose exec web python manage.py refresh_site_areas --site 12
docker compose exec web python manage.py refresh_site_areas --missing
Le rattachement est aussi recalculé automatiquement à la création d'un site et à chaque
modification de sa géométrie (signal apps/geo/signals.py). Un échec de recalcul est
journalisé sans jamais bloquer l'enregistrement du site : le rattachement peut être
rejoué avec refresh_site_areas --missing.
API¶
Mise à jour des contours¶
Les données sont versionnées dans le dépôt plutôt que téléchargées au démarrage :
CICADA est installé chez des clients dont les serveurs n'ont pas toujours d'accès
Internet sortant. La procédure de mise à jour est décrite dans
backend/apps/geo/data/README.md.
Administration Django¶
Accès¶
- URL : http://localhost:8000/admin/
- Sections : Core > Nomenclatures, Taxonomy > Taxons, Habitats > Habitats
Fonctionnalités¶
- Consultation des nomenclatures, taxons et habitats
- Recherche par mnémonique, label ou définition
- Filtrage par type, statut, source, règne, groupe INPN
Troubleshooting¶
TaxRef : import échoue au téléchargement¶
# Vérifier la connectivité réseau
docker compose exec web wget -q --spider https://geonature.fr/data/inpn/taxonomie/TAXREF_v18_2025.zip
# Télécharger manuellement et placer dans le cache
docker compose exec web mkdir -p /tmp/cicada_taxref_cache
# Copier le ZIP dans le container puis :
docker compose exec web python manage.py import_taxref --cache-dir /tmp/cicada_taxref_cache
HabRef : tables vides après import¶
# Vérifier que l'import a bien tourné
docker compose logs web | grep -i habref
# Forcer le rechargement
docker compose exec web python manage.py import_habref --force
Autocomplete lent (>200ms)¶
# Vérifier que les index trigramme existent
docker compose exec db psql -U cicada_user -d cicada -c "\di taxonomie.*trgm*"
# Rafraîchir la vue matérialisée
docker compose exec web python manage.py refresh_taxref_views
Nomenclatures manquantes ou labels incorrects¶
# Met à jour les labels/définitions et ajoute les nouvelles entrées
docker compose exec web python manage.py import_nomenclatures --force
docker compose exec web python test_nomenclatures.py