Lecteur de documentation

journal impact DU

Fichier source: plans/journal_impact_DU.md

Markdown rendu Markdown

Journal d'Impact : Ateliers DU x Audit IA x Ajouts de code

Résumé d'ouverture:

Ce journal ne conserve que les ajouts de code réalisés en lien direct avec :

Toute modification ou ajout de code ayant un impact social ou environnemental non négligeable doit être enregistré ici avec, au minimum, la date, une explication courte du changement et son impact bénéfique ou négatif. Si l'impact est négatif, une solution concrète pour le réduire doit aussi être proposée.

2026-05-25 - Migration du socle Supabase vers une nouvelle base hébergée à Paris et réalignement des migrations SQL locales sur cette cible. Impact bénéfique: baisse potentielle de la latence pour les utilisateurs parisiens, cohérence géographique plus forte avec le runtime Vercel en cdg1, et simplification du pilotage si l'ancienne base en Irlande est retirée ensuite. Impact négatif: migration plus risquée et plus coûteuse à maintenir tant que les données historiques de l'ancienne base ne sont pas encore recopiées; solution de réduction: conserver l'ancienne base le temps d'extraire/importer les données réellement utiles, puis la supprimer seulement après vérification complète.

2026-05-24 - Ajout de réglages workspace VS Code pour exclure .next, node_modules, .vercel, dist, build, coverage et .git des watchers et de la recherche, avec plafond mémoire TypeScript abaissé. Impact bénéfique: moins d'I/O disque, moins de RAM consommée par les indexeurs et moins de contention avec les builds Next.js. Impact négatif: un peu moins de visibilité sur les artefacts générés, compensée par l'exclusion explicite uniquement des répertoires dérivés.

2026-05-24 - Optimisation et déduplication des visuels de documentation: conversion des quatre schémas techniques de session en webp plus légers, mise à jour des légendes et du guide de sessions, bascule du logo du README vers l'asset logo-cleanmymap.webp, et ajout de rewrites Vercel pour conserver les anciens chemins .png des visuels publics tout en servant les versions allégées. Impact bénéfique: baisse du poids des assets, réduction du volume transféré au build et au rendu des pages de documentation, et moindre pression disque/stockage. Impact négatif: légère complexité de routage supplémentaire, compensée par la conservation des anciennes URLs via rewrite.

2026-05-24 - Suppression de l'export Vercel brut web_eqnhvnoym-maxencedrm-7606s-projects_vercel_app_logs.csv, devenu obsolète et trompeur avec son en-tête path_name,size et ses tailles d'analyse figées. Impact bénéfique: moins de bruit documentaire et moins de risque de confondre un artefact de diagnostic avec une source de vérité. Impact négatif: perte d'un historique brut local, compensée par les journaux Vercel et la documentation d'incident plus ciblée.

2026-05-24 - Ajout d'un mode de démarrage local propre (dev:clean) et d'un mode port strict (dev:strict) pour éviter les caches Next/Turbopack corrompus et les faux localhost causés par un second serveur sur un port de secours. La route notifications a aussi été durcie en dev pour renvoyer un état vide au lieu d'erreurs 500 quand Supabase/Clerk n'est pas prêt. Impact bénéfique: moins de bruit, moins de confusion entre anciennes et nouvelles versions, et moins de relances inutiles du serveur local. Impact négatif: un peu plus de surface de commandes de dev, compensée par des consignes de démarrage plus claires.

Il ne sert ni de backlog, ni de plan d'action général, ni de dossier institutionnel. Les priorités actives restent dans documentation/plans/ateliers_DU.md. La seule zone de directives encore exploitables ici est l'annexe A.

Ce cadre poursuit deux objectifs. D'abord, montrer un impact reel des ateliers sur le projet web avec une lecture critique, structuree et credible. Ensuite, disposer d'un support de pilotage capable de justifier les choix techniques, environnementaux et institutionnels devant un jury ou un partenaire externe.

Schéma des liens

Le journal détaillé renvoie aux autres pièces de travail ci-dessous pour garder une lecture cohérente entre les ateliers DU, le rapport d'impact IA, la méthode du graphique et les estimateurs techniques du projet.

          
mermaid
flowchart TD AJ["documentation/plans/ateliers_DU.md"] RI["documentation/plans/rapport_impact/impact_IA.md"] GI["documentation/plans/rapport_impact/graphique_impact_CO2e.md"] JI["documentation/plans/journal_impact_DU.md"] EI["Estimateur d'impact environnemental"] QG["Impact numérique des services suivis<br/>des services web utilisés"] JI --> AJ JI --> RI RI --> GI RI --> EI RI --> QG AJ --> EI EI --> GI EI --> QG QG --> RI style AJ fill:#111827,stroke:#34d399,color:#e5e7eb style RI fill:#111827,stroke:#f59e0b,color:#e5e7eb style GI fill:#111827,stroke:#f97316,color:#e5e7eb style JI fill:#111827,stroke:#a78bfa,color:#e5e7eb style EI fill:#0b1220,stroke:#fb7185,color:#fee2e2 style QG fill:#0b1220,stroke:#22c55e,color:#dcfce7

Lecture rapide:

Concepts cles appliques

Historique condense des implementations

Difficultes structurantes et enseignements

Synthese des apports conserves

1. Axe : Évaluation critique et Sobriété Numérique

Enseignement : Savoir porter un regard critique sur son propre impact et institutionnaliser la sobriété.

DateAmélioration apportéeImpact concret
13/05/26Normalisation de l'Audit d'Impact IACréation d'un référentiel de 3100+ lignes analysant les coûts carbone, eau et éthique de l'IA.
13/05/26Indice IUR (Indice d'Utilité Réelle)Mise en place de la formule Impact Terrain / Coût Numérique comme juge de paix pour tout nouveau développement.
13/05/26Charte de Sobriété (SOBRIETY_RULES.md)Création d'un protocole de développement imposant le choix de modèles légers et la mise en cache systématique.

2. Axe : Pilotage par la donnée et Indicateurs

Enseignement : Passer de la perception subjective à la mesure objective.

DateAmélioration apportéeImpact concret
13/05/26Automatisation des statistiques d'auditCréation de update-audit-stats.mjs pour synchroniser dynamiquement les métriques de code avec le dossier d'impact.
13/05/26Audit des Écarts (Roadmap vs Réalité)Identification technique des manquements (Campagnes, Qualité de donnée) pour prioriser les futurs sprints.
13/05/26Reporting qualité CI/CD orienté pilotageCréation de scripts/cicd-metrics-report.mjs et de documentation/maintenance/ci-cd-metrics-report.md pour suivre les runs GitHub Actions, le cache et les déploiements Vercel dans une logique de mesure continue.
13/05/26Audit exécutable des messages Ateliers DUFormalisation de documentation/plans/ateliers_DU_execution_rapide.md pour distinguer les lots déjà absorbés, les écarts encore ouverts et l'ordre d'attaque réaliste.
20/05/26Socle d'estimateur d'impact environnementalMise en place de l'architecture du calcul transparent pour le site et l'utilisateur, avec postes visibles, hypothèses versionnées et panneau UI prêt à brancher dans le rapport d'impact IA.
21/05/26Séparation Codex / GPT-5.4 miniDistinction explicite entre les sessions Codex et le modèle GPT-5.4 mini utilisé pendant le développement du site, avec badge ACV dédié, pour éviter de mélanger développement et production.
26/05/26Journal hebdomadaire CodexAjout d'un historique spécifique à l'usage Codex — développement du site pour enregistrer les semaines manuellement, reconstruire les périodes passées et convertir ces signaux projet-spécifiques en équivalent CO2e sans moyenne externe.
21/05/26Deuxième ordre d'impactAjout d'une décomposition lisible du CO2e en CO2 brut, électricité, autres GES, produits chimiques et eau, afin de détailler la structure du graphe et ses priorités de réduction.
24/05/26Chaîne Sentry post-build sans blocageRemplacement du build plugin Sentry par un upload post-build des source maps via sentry-cli avec injection des debug IDs. Impact positif: le build n'est plus fragile sur les dépendances natives et les symboles restent récupérables en production. Limite: il faut un SENTRY_AUTH_TOKEN et des variables Sentry correctement renseignées, sinon l'upload est sauté.

3. Axe : Gouvernance et Participation Citoyenne

Enseignement : Clarifier les rôles et interfaces pour augmenter l'engagement.

DateAmélioration apportéeImpact concret
13/05/26Rôle de Responsable SobriétéInstitutionnalisation d'un droit de veto technique pour garantir que l'usage de l'IA reste éthique et sobre.
13/05/26Protocole Human-in-the-loopGarantie que toute décision d'IA est supervisée par un humain, renforçant la légitimité du projet.

4. Axe : Souveraineté et Pérennité

Enseignement : Anticiper les dépendances et garantir la continuité de l'action.

DateAmélioration apportéeImpact concret
13/05/26Stratégie de sortie techniquePlanification de la mitigation du vendor lock-in (Vercel/Supabase) pour assurer l'indépendance à long terme.
24/05/26Localisation Vercel orientée ParisAlignement du runtime Vercel sur cdg1 pour rapprocher les fonctions des utilisateurs parisiens et des données européennes. Le gain environnemental est réel mais partiel, car le build cloud Vercel reste exécuté en iad1 Washington.
13/05/26Standardisation Sémantique (SLB)Reformatage de 230 KB de documentation pour une lecture optimale par les humains et les futurs agents IA.
13/05/26Matrice de traçabilité cœur produitCréation de documentation/architecture/traceability-matrix.md pour relier rubrique, route, composant, API et source de donnée.
13/05/26Dossier de validation institutionnelleCréation d'un point d'entrée unique liant audit d'impact, gouvernance IA, sobriété, maintenance, traçabilité et stratégie de sortie technique.

Vue d'ensemble des effets des dernières modifications



5. Synthèse des Solutions Issues de l'Audit d'Impact (Section 22)

Enseignement : Transformer un diagnostic en plan de remédiation technique.

ActionÉtatImpact sur le Projet
Sécurité (Directive 2)✅ RéaliséCréation de scripts/pre-release-check.mjs pour scanner les secrets et fichiers critiques avant déploiement. Baisse du risque de fuite de souveraineté.
Sécurité publication (durcie)✅ RéaliséCorrection du script pre-release-check.mjs, ajout de npm run pre-release:check et formalisation de documentation/operations/pre-release-security-check.md pour l'inventaire des variables sensibles et des contrôles.
IUR (Directive 7)✅ RéaliséIntégration de l'Indice d'Utilité Réelle dans le moteur de pilotage et le dashboard admin. Pilotage par la sobriété (Impact > Coût).
Observabilité (Directive 3)✅ RéaliséAjout d'une alerte de sobriété automatique dans le moteur de priorisation, enrichissement de /api/services avec résumé global, niveaux de sévérité et timeline courte, plus affichage admin de supervision.
Data Quality (Directive 4)✅ RéaliséDétection automatique des anomalies métier (impact irréaliste, données manquantes) via dataIntegrityPriority.
Standardisation UI (Directive 6)✅ RéaliséMutualisation du code avec AdminPanelShell pour 3 panels majeurs. Réduction stricte du poids du bundle JS (Sobriété logicielle).
Audit des Écarts Ateliers✅ RéaliséClôture des écarts de sécurité, observabilité, data quality et standardisation UI. Le lot campagnes multi-actions a été cadré comme chantier partiellement couvert, à finaliser sur un modèle/API d'agrégation.
Reporting qualité automatisé (Directive 7)✅ RéaliséAjout de scripts/cicd-metrics-report.mjs et d'une documentation dédiée pour produire un suivi comparable des runs CI/CD, du cache et des déploiements.
Check-list Sortie IA✅ RéaliséCréation du PULL_REQUEST_TEMPLATE.md pour forcer la vérification humaine du code généré.
Gouvernance IA Explicite✅ RéaliséRédaction de GOVERNANCE.md définissant la responsabilité humaine sur chaque bloc de code.
Optimisation Poids Plume🚀 En coursRéduction du logo de 88% et bundle splitting pour les cartes (Leaflet), réduisant la conso batterie mobile.
Tests de non-régression ciblés (Directive 5)🟡 Partiellement réaliséRenforcement de tests sur la modération admin, la validation d'actions, les filtres de carte, le stockage brouillon, l'analytics consent, /api/services, les endpoints critiques d'export (actions.csv, actions.json, elus-dossier) et les boutons UI d'export CSV/PDF. La couverture UI de /dashboard et /reports reste à consolider.
Convergence exports web (Directive 11)✅ RéaliséUniformisation des headers de livrables et des noms de fichiers pour CSV/JSON/PDF côté serveur via un helper commun, puis harmonisation des libellés/messages front d'export CSV/PDF avec buildExportUiCopy, couverte par des tests serveur et UI statiques.
Standardisation des Prompts (Action C)✅ RéaliséRéduction du bruit numérique via PROMPT_GUIDE.md.
Fiabilité des Indicateurs (Action J)✅ RéaliséProtocole de revue via METRICS_RELIABILITY_PROTOCOL.md.
Protection des Données (Action D)✅ RéaliséPolitique de sécurité via DATA_PROTECTION_POLICY.md.


Clôture documentaire du plan supprimé : Le plan d'écarts supprimé a été absorbé dans ce journal. Les améliorations effectivement implémentées sont désormais tracées ici comme références de preuve, avec distinction explicite entre réalisé, partiellement réalisé et à faire.

Nettoyage du backlog de session : Les prompts deja executes ont ete retires des fichiers de pilotage actifs. Les prompts restants ont ete regroupes par priorite operationnelle dans documentation/plans/ateliers_DU.md. documentation/plans/ateliers_DU_execution_rapide.md devient une trace d'execution et non un second backlog.

6. Annexe A - Bibliothèque de pilotage IA

Cette annexe centralise les directives opérationnelles retirées de la section 22 de l'audit principal. Elle porte le niveau d'exécution, tandis que l'audit conserve le niveau de décision, de contrôle et de preuve.

ActionDirectiveÉtatPreuve attendueContrôle associé
B - Validation humaine des contenus environnementauxAjouter un workflow de validation humaine des contenus environnementaux et institutionnels.✅ RéaliséCONTENT_VALIDATION_WORKFLOW.mdVérification des chiffres et interprétations.
C - Standardisation des usages IA utilesCréer un guide de prompts internes par cas d'usage (code, documentation, UX, debug).✅ RéaliséPROMPT_GUIDE.mdRéduction des itérations redondantes.
D - Protection des données sensiblesAjouter une politique d'usage IA du projet : données interdites, anonymisation minimale.✅ RéaliséDATA_PROTECTION_POLICY.mdContrôle des données personnelles et secrets.
G - Clarté des messages environnementauxRéaliser un audit de clarté des contenus environnementaux et proposer une version harmonisée.✅ RéaliséCONTENT_VALIDATION_WORKFLOW.mdContrôle du vocabulaire et de la cohérence.
J - Fiabilité des indicateursAjouter des contrôles de cohérence des indicateurs et un protocole de revue mensuelle.✅ RéaliséMETRICS_RELIABILITY_PROTOCOL.mdVérification de la cohérence analytics.

7. Analyses Systémiques et Réflexions de Fond

Enseignement : Comprendre les enjeux de pouvoir, de dépendance et d'effet rebond dans le numérique.

ThématiqueEnseignement DU appliquéApplication dans CleanMyMap
Effet Rebond (Jevons)Se méfier de la vitesse de l'IA qui pousse au feature creep.Décision de geler les fonctions "gadgets" (badges, chat) pour se concentrer sur le noyau utile.
Souveraineté (Section 15)Analyser la géopolitique du cloud (90% stack US).Cartographie des risques de rupture (Vercel, Clerk, Supabase) et plan de mode dégradé (export statique).
Éthique du "Ghost Work"Reconnaître le coût social caché de l'IA (annotation).Engagement à limiter l'IA aux tâches de structure et non à la modération massive non supervisée.
Dualité de LogiqueChoisir entre "Infra légère" et "Plateforme extensive".Arbitrage en faveur de l'infrastructure légère de coordination pour rester sobre.
IA comme AccélérateurS'inspirer d'AlphaFold pour l'action écologique.Utilisation de l'IA pour compresser 2 ans de R&D environnementale en 3 mois de développement citoyen.

8. Alignement avec les Objectifs de Développement Durable (ODD)

Enseignement : Inscrire son action dans le cadre universel de l'ONU.

Le projet CleanMyMap, audité via le prisme des ODD, valide les points suivants :


Note de synthèse finale : Grâce aux ateliers DU, CleanMyMap est passé d'une "application web de nettoyage" à une "infrastructure civique responsable, auditée et souveraine". Chaque décision technique est désormais le fruit d'un arbitrage entre utilité sociale maximale et empreinte environnementale minimale. Le projet n'est plus seulement un outil numérique, c'est une démonstration de sobriété en acte.