carbonfr_eligibility/lib.rs
1//! # carbonfr-eligibility
2//!
3//! Couche A « électrolyseur » de carbon-fr (ADR-0025, méthodologie ADR-0026) :
4//! évaluation d'**éligibilité au niveau réseau** par créneau, sous deux cadres
5//! explicitement étiquetés et **neutres** — `rfnbo` (renouvelable) et
6//! `low-carbon` (bas-carbone inclusif nucléaire/CCS).
7//!
8//! ## Neutralité (cardinal, ADR-0025)
9//!
10//! `carbon-fr` expose l'éligibilité **au regard de chaque cadre** ; il ne tranche
11//! pas la « couleur » de l'hydrogène ni le débat renouvelable/nucléaire. La donnée
12//! est ouverte et vérifiable ; les conclusions appartiennent à l'utilisateur.
13//!
14//! ## Périmètre
15//!
16//! Support à la **décision sur signaux de réseau**, **pas** une certification.
17//! Hors périmètre (donnée au niveau du site absente) : gCO₂eq/kgH₂, certification,
18//! et additionnalité contractuelle (PPA).
19//!
20//! ## Architecture
21//!
22//! Crate de **domaine pur** : aucune IO (pas de `serde`/`sqlx`/`axum`/`reqwest`),
23//! `time` plutôt que `chrono`, dépend uniquement de `carbonfr-core`. L'évaluation
24//! est **totale** (jamais de `Result` : l'indétermination est portée par
25//! [`EligibilitySignal::Indeterminate`]).
26
27mod evaluate;
28mod ruleset;
29mod share;
30mod share_forecast;
31mod share_meteo;
32mod verdict;
33
34pub use evaluate::{best_eligible, evaluate, evaluate_slot, rank_by_score};
35pub use ruleset::{
36 DEFAULT_ELECTROLYZER_KWH_PER_KG, EligibilityFramework, EligibilityRuleset,
37 FOSSIL_COMPARATOR_G_PER_MJ, H2_LHV_MJ_PER_KG, LOW_CARBON_BUDGET_G_PER_KG,
38 REQUIRED_GHG_REDUCTION, RulesetStatus, TemporalGranularity, low_carbon_intensity_threshold,
39 resolve_ruleset, ruleset_catalog,
40};
41pub use share::renewable_share;
42pub use share_forecast::{
43 SHARE_FORECAST_MODEL, ShareBacktestReport, ShareClimatology, ShareEstimate, ShareHorizonError,
44 ShareSource, backtest_share, calibrate_share_bands,
45};
46pub use share_meteo::{
47 SHARE_METEO_MODEL, ShareMeteoBacktestReport, ShareMeteoHorizonError, ShareMeteoModel,
48 WeatherIndex, backtest_share_meteo, calibrate_share_meteo_bands,
49};
50pub use verdict::{
51 EligibilitySignal, EligibilityVerdict, FR_BIDDING_ZONE, IndeterminateReason, Pillar, SlotInput,
52 basis_of,
53};