L’Ornithèque

Webapp de comparaison de listes d'observations d'oiseaux entre amis, basée sur les données eBird, GBIF, xeno-canto et AVONET.

Déployée sur GitHub Pages : mathiiis7.github.io/ornitheque

Structure du projet

ornitheque/
├── index.html              le squelette HTML et les <template>
├── styles.css              toute la CSS
├── app.js                  le code, et les tables qui servent partout
├── service-worker.js       le cache (stale-while-revalidate)
├── manifest.json           nom, icônes et thème de l'app installable
├── CLAUDE.md               les consignes de travail sur ce dépôt
│
├── assets/
│   ├── trophies/           182 images de trophées
│   ├── icons/              32 icônes d'espèces et de badges
│   └── logos/              le logo et ses déclinaisons
│
├── data/                   les données servies au client
│   ├── regions-<cc>-simplified.json   contours régionaux de 48 pays
│   ├── avonet_traits.json  traits écologiques de 10 584 espèces
│   ├── cartes-index.json   l'index des cartes de répartition
│   └── countries/<cc>/     fréquences et abondances, pays par pays
│
├── demo/                   la démo du portfolio, générée
│   └── bouchons/           Firebase simulé, pour qu'elle tourne sans compte
│
├── docs/                   les documents de travail publiés avec le dépôt
│
└── outils/
    ├── build/              les générateurs de données (Node, ESM)
    ├── verif/              les bancs de mesure
    ├── config/             firestore.rules et les contours sources
    └── generateur-trophees.html   outil local de fabrication des badges

Deux choses ne sont pas dans cette arborescence, et c'est voulu. Les cartes de répartition (cartes/, 82,7 Mo) vivent dans le dépôt séparé ornitheque-data : les garder ici aurait ralenti chaque opération sur le code. notes-privees/ reste hors du dépôt, exclu par .gitignore : le dépôt est public.

Sources de données

• eBird API v2 : liste d'espèces par région, catégorie exotique
• eBird bar chart : fréquence d'observation mensuelle par région, téléchargée depuis eBird
• Observations eBird publiées sur GBIF (CC BY 4.0) : les cartes de répartition, méthode dans docs/sources-cartes.md
• xeno-canto API v3 : sons (chants + cris) par espèce
• Avonet dataset (Tobias et al. 2022) : traits écologiques et morphologiques
• GBIF species API : statut IUCN mondial
• IUCN Red List France (données locales) : statut national

Commandes utiles

# Regénérer la donnée par pays (session eBird ouverte requise)
EBIRD_COOKIE="..." node outils/build/download-bar-charts-regional.mjs

# Regenerer les cartes de répartition (dans ../ornitheque-data/cartes)
node outils/build/cartes-gbif.mjs

# Regenerer traits Avonet
node outils/build/build-avonet-traits.mjs

# Regenerer IUCN redlist mondial
node outils/build/enrich-redlist-global-full.mjs

Architecture technique

• Front pur : aucun backend, tout est statique + Firebase pour l'auth et la synchro utilisateur
• Service Worker : cache stale-while-revalidate pour rechargements instantanés
• PWA : installable sur écran d'accueil (mobile + desktop)
• Lazy loading : les grosses data (freq régionale, avonet traits, range maps) sont fetch à la demande