EVALUD

Plateforme de suivi d'impact pour la décarbonation de la logistique urbaine, développée dans le cadre du programme national InTerLUD+ (certificats CEE).

InTerLUD+ mettent en place des actions concrètes pour réduire les émissions du transport de marchandises en ville. EVALUD leur permet de mesurer si ces actions atteignent leurs objectifs.

---

Fonctionnement

Pour chaque action environnementale, les collectivités saisissent des indicateurs selon 4 situations temporelles :

Situation	Description
init	Situation initiale (état de départ)
ref	Année de référence (sans l'action)
prev	Prévisionnel (résultats projetés)
expost	Ex-post (résultats réels mesurés)

La plateforme calcule ensuite les gains obtenus sur les émissions (GES, NOx, PM, énergie…) et les compare aux objectifs via des tableaux de bord interactifs.

Les calculs sont basés sur les facteurs d'émission ADEME (Base Carbone), validés par le Cerema.

---

Utilisateurs

• Agents de collectivité — saisie et suivi de leurs actions et indicateurs
• Pilotes du programme (Rozo, Cerema) — vue agrégée nationale

---

Architecture

Le projet est un monorepo composé de trois sous-projets :

.
├── api/      # Backend Node.js / Express (port 8080)
├── app/      # Frontend React principal pour les collectivités (port 3000)
└── admin/    # Dashboard React pour les administrateurs

API (api/)

• Runtime : Node.js + Express 4
• Base de données : MongoDB via Mongoose
• Auth : Passport.js + JWT (deux stratégies : user et admin)
• Emails : Brevo (Sendinblue)
• Fichiers : stockage S3 compatible (AWS / MinIO)
• Office : Microsoft Graph API (synchronisation SharePoint / Excel)
• Erreurs : Sentry

Principales routes exposées :

Route	Description
/user	Authentification, inscription, invitations, réinitialisation mot de passe
/action	CRUD des actions environnementales
/indicator	Définitions des indicateurs
/indicator_value	Valeurs saisies par les collectivités
/collectivity	Collectivités territoriales
/economic_actor	Acteurs économiques
/excel	Import / export, calculs d'agrégation
/dashboard	Statistiques et analytiques
/log	Journal d'audit

App (app/)

• Framework : React 18 + Vite
• État global : Zustand
• Routing : React Router v6
• Design system : @codegouvfr/react-dsfr (DSFR gouvernemental)
• Styles : TailwindCSS
• Graphiques : Recharts

Principales sections :

Route	Description
/	Tableau de bord avec graphiques GES / PM / énergie
/actions	Liste et détail des actions
/actions/:id/completion	Saisie des indicateurs par situation
/general-data	Saisie de données générales (import Excel)
/admin/*	Gestion des utilisateurs, collectivités, indicateurs

Admin (admin/)

Dashboard React léger pour les administrateurs système : gestion des utilisateurs, statistiques globales, configuration des collectivités.

---

Modèle de données

Collectivité ─── possède ──► Utilisateurs
     │
     └── possède ──► Actions
                         │
                         └── possède ──► Indicateurs
                                              │
                                              └── possède ──► ValeurIndicateurs
                                                               (par situation × année)

Action — une mesure environnementale (types : custom, reference, global, config). Le taux de complétion est suivi par situation.

Indicateur — une variable mesurable liée à une action. Supporte une logique d'affichage conditionnel (affiché uniquement si un autre indicateur a une certaine valeur).

ValeurIndicateur — la donnée réellement saisie pour un indicateur × action × situation × année.

Collectivité — une communauté territoriale française (EPCI), identifiée par son SIREN. Peut être liée à un dossier SharePoint pour la synchronisation Excel.

ActeurEconomique — une entreprise ou organisation pouvant être propriétaire d'actions.

---

Démarrage

Prérequis

• Node.js 18+
• MongoDB
• Un fichier .env dans api/ (voir api/.env.example)

Installation et lancement

# API
cd api
npm install
npm run dev        # démarre sur le port 8080

# App
cd app
npm install
npm run dev        # démarre sur le port 3000

# Admin
cd admin
npm install
npm run dev

Variables d'environnement (api/.env.example)

ENVIRONMENT=development
PORT=8080
MONGODB_ENDPOINT=mongodb://localhost:27017/interlud
SECRET=your_jwt_secret
APP_URL=http://localhost:3000

# Intégrations optionnelles
BREVO_KEY=
SENTRY_DSN=
S3_ENDPOINT=
S3_ACCESSKEYID=
S3_SECRETACCESSKEY=
TENANT_ID=
CLIENT_ID=
CLIENT_SECRET=

---

Notes techniques

• L'interface est entièrement en français.
• Toutes les réponses API suivent le format { ok: boolean, data, code }.
• L'alias @/ dans l'app pointe vers app/src/.
• La synchronisation bidirectionnelle Excel ↔ SharePoint est gérée via Microsoft Graph.

---

Licence

MIT