# earth-now.co
# Author:  Simon-Pierre Boucher
# Contact: contact@spboucher.ai
# File:    packages/registry/metrics/society.yaml
# Purpose: MVP society metrics (catalog §8-9, 🥇) — extreme poverty, water access, hunger, food waste

metrics:
  - id: extreme_poverty
    name:
      fr: "Personnes en extrême pauvreté (< 2,15 $/j)"
      en: "People in extreme poverty (< $2.15/day)"
    domain: society
    priority: mvp
    kind: stock
    level: 2
    model: seasonal-spline-v2
    unit: people
    sources:
      - id: wb_pip
        name: "World Bank — Poverty and Inequality Platform"
        url: https://pip.worldbank.org/
        license: "CC BY 4.0"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 3
      unit: { fr: "personnes", en: "people" }
    constraints: { maxAbsRatePerSec: 5, maxJumpOnRefit: 20000000 }
    windows: [total]

  - id: people_without_clean_water
    name:
      fr: "Personnes sans eau potable gérée en sécurité"
      en: "People without safely managed drinking water"
    domain: society
    priority: mvp
    kind: stock
    level: 2
    model: seasonal-spline-v2
    unit: people
    sources:
      - id: jmp_wash
        name: "WHO/UNICEF Joint Monitoring Programme (JMP)"
        url: https://washdata.org/
        license: "CC BY 4.0"
        licenseNote: "verify JMP reuse terms before launch"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 3
      unit: { fr: "personnes", en: "people" }
    constraints: { maxAbsRatePerSec: 10, maxJumpOnRefit: 50000000 }
    windows: [total]

  - id: undernourished
    name: { fr: "Personnes sous-alimentées", en: "Undernourished people" }
    domain: society
    priority: mvp
    kind: stock
    level: 2
    model: seasonal-spline-v2
    unit: people
    sources:
      - id: fao_sofi
        name: "FAO — State of Food Security and Nutrition (SOFI)"
        url: https://www.fao.org/publications/sofi/
        license: "CC BY-NC-SA 3.0 IGO"
        licenseNote: "non-commercial clause — legal review required before any monetization"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 3
      unit: { fr: "personnes", en: "people" }
    constraints: { maxAbsRatePerSec: 10, maxJumpOnRefit: 50000000 }
    windows: [total]
    uncertaintyFraction: 0.08
    editorialNote:
      fr: "Estimation FAO avec intervalle large — l'intervalle et la mention « estimation » sont affichés."
      en: "FAO estimate with a wide interval — the interval and the 'estimate' label are displayed."

  - id: food_waste_ytd
    name: { fr: "Nourriture gaspillée cette année", en: "Food wasted this year" }
    domain: society
    priority: mvp
    kind: cumulative
    level: 0
    model: linear-ytd-v1
    unit: t
    sources:
      - id: unep_fwi
        name: "UNEP Food Waste Index"
        url: https://www.unep.org/resources/publication/unep-food-waste-index-report-2024
        license: "© UNEP — citation required"
        licenseNote: "verify reuse terms before launch"
        cadence: "~2 years"
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 3
      unit: { fr: "tonnes", en: "tonnes" }
    constraints: { maxAbsRatePerSec: 100, maxJumpOnRefit: 5000000 }
    windows: [ytd, today, session]
    uncertaintyFraction: 0.15
    editorialNote:
      fr: "Extrapolation linéaire (L0) d'une estimation à large intervalle — mention « estimation » obligatoire."
      en: "Linear extrapolation (L0) of a wide-interval estimate — 'estimate' label mandatory."

  - id: water_use_ytd
    name: { fr: "Eau douce consommée cette année", en: "Freshwater used this year" }
    domain: society
    priority: v1
    kind: cumulative
    level: 1
    model: seasonal-ytd-v1
    unit: m3
    sources:
      - id: fao_aquastat
        name: "FAO AQUASTAT"
        url: https://www.fao.org/aquastat/
        license: "CC BY 4.0 (verify)"
        licenseNote: "verify reuse terms before launch"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 5
      unit: { fr: "m³", en: "m³" }
    constraints: { maxAbsRatePerSec: 400000, maxJumpOnRefit: 50000000000 }
    windows: [today, ytd, session]
    editorialNote:
      fr: "Prélèvements mondiaux (~4 300 km³/an), saisonnalité d'irrigation modélisée."
      en: "Global withdrawals (~4,300 km³/yr), irrigation seasonality modelled."

  - id: animals_slaughtered_ytd
    name: { fr: "Animaux terrestres abattus cette année", en: "Land animals slaughtered this year" }
    domain: society
    priority: v1
    kind: cumulative
    level: 1
    model: seasonal-ytd-v1
    unit: animals
    sources:
      - id: faostat_livestock
        name: "FAOSTAT — Livestock Primary"
        url: https://www.fao.org/faostat/en/#data/QCL
        license: "CC BY-NC-SA 3.0 IGO"
        licenseNote: "non-commercial clause — legal review before monetization"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 4
      unit: { fr: "animaux", en: "animals" }
    constraints: { maxAbsRatePerSec: 8000, maxJumpOnRefit: 1000000000 }
    windows: [today, ytd, session]
    editorialNote:
      fr: "Ton sobre : ~83 milliards d'animaux terrestres par an (FAOSTAT), volailles en très grande majorité."
      en: "Sober tone: ~83 billion land animals per year (FAOSTAT), overwhelmingly poultry."

  - id: fish_caught_ytd
    name: { fr: "Poissons pêchés cette année", en: "Fish caught this year" }
    domain: society
    priority: v1
    kind: cumulative
    level: 1
    model: seasonal-ytd-v1
    unit: t
    sources:
      - id: fao_sofia
        name: "FAO SOFIA — State of World Fisheries"
        url: https://www.fao.org/publications/sofia/
        license: "CC BY-NC-SA 3.0 IGO"
        licenseNote: "non-commercial clause — legal review before monetization"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 4
      unit: { fr: "tonnes", en: "tonnes" }
    constraints: { maxAbsRatePerSec: 10, maxJumpOnRefit: 2000000 }
    windows: [ytd, today, session]

  - id: coffee_cups_ytd
    name: { fr: "Tasses de café bues", en: "Cups of coffee drunk" }
    domain: society
    priority: v1
    kind: cumulative
    level: 1
    model: seasonal-ytd-v1
    unit: cups
    sources:
      - id: ico_coffee
        name: "Dérivé ICO — International Coffee Organization"
        url: https://www.ico.org/
        license: "Derived estimate — citation required"
        licenseNote: "verify estimate basis before launch"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 4
      unit: { fr: "tasses", en: "cups" }
    constraints: { maxAbsRatePerSec: 80000, maxJumpOnRefit: 10000000000 }
    windows: [today, ytd, session]
    uncertaintyFraction: 0.2
    editorialNote:
      fr: "Dérivé de la consommation ICO (~2,25 milliards de tasses/jour) — cycle matinal mondial modélisé, estimation."
      en: "Derived from ICO consumption (~2.25 billion cups/day) — global morning cycle modelled, estimate."

  - id: food_produced_ytd
    name: { fr: "Nourriture produite cette année", en: "Food produced this year" }
    domain: society
    priority: v1
    kind: cumulative
    level: 1
    model: seasonal-ytd-v1
    unit: t
    sources:
      - id: faostat_crops
        name: "FAOSTAT — Crops and livestock products"
        url: https://www.fao.org/faostat/en/#data/QCL
        license: "CC BY-NC-SA 3.0 IGO"
        licenseNote: "non-commercial clause — legal review before monetization"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 4
      unit: { fr: "tonnes", en: "tonnes" }
    constraints: { maxAbsRatePerSec: 1500, maxJumpOnRefit: 100000000 }
    windows: [ytd, today, session]
    editorialNote:
      fr: "Production agricole primaire (~9,8 Gt/an), pic de récoltes hémisphère nord modélisé."
      en: "Primary agricultural output (~9.8 Gt/yr), northern-hemisphere harvest peak modelled."