Economy as a Code
Retour au blog
·2 min de lecture·Tristan Méneret

Tutoriel : calculer l'impact ESG d'une entreprise avec le GitHub EaaC

tutorielGitHubtechniquePython

Prérequis

Pour suivre ce tutoriel, vous avez besoin de :

  • Python 3.10 ou supérieur
  • Git

Aucune clé API n'est nécessaire : toutes les sources de données sont ouvertes.

Installation

git clone https://github.com/tmegit/economy-as-a-code.git
cd economy-as-a-code
pip install -e .

Préparer les données de l'entreprise

Créez un fichier JSON contenant les informations de l'entreprise :

{
  "name": "Ma Société SAS",
  "country": "FR",
  "revenue": 2000000,
  "employees": 25,
  "taxes": 60000,
  "sector": "6201Z"
}

Les champs requis sont : name, country, revenue, employees, taxes et sector (code NAF ou NACE).

Calcul via la CLI

Le mode le plus simple : vous fournissez un fichier JSON avec les données de l'entreprise et le moteur EaaC fait le reste.

eaac compute --data company.json

La sortie affiche quatre sections :

EaaC Impact Report: Ma Société SAS (N/A)
================================================================================

  MACRO INDICATORS
  Economic:  940.2k EUR
  Social:    7.4 ETP
  Fiscal:    55.1k EUR
  Carbon:    6.6 tCO2e

  IMPACT MATRIX
  Indicator        Direct       Indirect        Induced          Total
  ------------------------------------------------------------------------
  Economic        2.0M EUR      800.0k EUR      140.2k EUR      940.2k EUR
  Social           25.0 ETP       5.2 ETP         2.2 ETP        7.4 ETP
  Fiscal          60.0k EUR      35.0k EUR       10.1k EUR      55.1k EUR
  Carbon            3.2 tCO2e     2.6 tCO2e       0.8 tCO2e      6.6 tCO2e

  MULTIPLIER EFFECTS
  Economic:  1 EUR of revenue generates 1.47 EUR in the economy
  Social:    1 direct job generates 1.30 total jobs
  Fiscal:    1 EUR of revenue generates 0.0276 EUR in taxes

  COUNTRY BREAKDOWN (1 countries)
  Country              Economic        Social        Fiscal        Carbon
  ----------------------------------------------------------------------------
  France               940.2k EUR      7.4 ETP      55.1k EUR      6.6 tCO2e
  ----------------------------------------------------------------------------
  Total                940.2k EUR      7.4 ETP      55.1k EUR      6.6 tCO2e

Calcul précis (avec données fournisseurs)

Pour un rapport plus détaillé, vous pouvez fournir la liste de vos fournisseurs :

eaac compute --data company.json --suppliers fournisseurs.csv

Le fichier CSV contient les colonnes suivantes :

supplier_siren,country,amount,revenue,employees,name
123456789,FR,150000,0,0,Fournisseur Français
,ES,22000,500000,12,Fournisseur Espagnol
  • Fournisseurs français : renseignez le supplier_siren, les données sont récupérées automatiquement
  • Fournisseurs internationaux : renseignez country, amount, revenue, employees

Utilisation Python

Vous pouvez aussi utiliser l'API Python directement :

from eaac import EaaCEngine

engine = EaaCEngine()

company_data = {
    "name": "Ma Société SAS",
    "country": "FR",
    "revenue": 2_000_000,
    "employees": 25,
    "taxes": 60_000,
    "sector": "6201Z",
}

impact = engine.compute(company_data=company_data)
print(impact.summary())

Export des résultats

# Export JSON
eaac compute --data company.json --format json --output rapport.json

# Export CSV
eaac compute --data company.json --format csv --output rapport.csv

Ou via Python :

impact.to_json("rapport.json")
impact.to_csv("rapport.csv")

Prochaines étapes