Rémi Girard
Menu

Teksial · Outils métier

Un back-office pour suivre les dossiers de rénovation énergétique, organiser les contrôles et préparer les dépôts CEE.

J’ai conçu le socle déclaratif de données, de React à PHP, puis mené ses refontes DDD et Clean Architecture.

2020
  • Application métier
BO CEE : recherche, filtres et sélection de dossiers pour créer un lot de contrôle In Situ.

En bref

Contexte
Teksial · outils internes et B2B · dossiers CEE
Résultat
Une définition commune des données ; des exports passés d’environ dix minutes à quelques secondes.

Suivre les dossiers de rénovation énergétique

Chez Teksial, le back-office accompagne le traitement des dossiers de certificats d’économies d’énergie (CEE). Il rassemble les informations sur les bénéficiaires, les travaux, les installateurs et les primes, avec les pièces justificatives et l’historique du dossier.

Les équipes y vérifient les dossiers, organisent les contrôles In Situ et préparent les dépôts CEE. Elles travaillent sur de nombreux tableaux, avec des filtres, des cellules modifiables et des échanges de fichiers Excel.

J’ai conçu un socle déclaratif commun à React et PHP pour ces usages : une clé identifie une donnée et relie son affichage, sa lecture en base, son filtrage et sa modification. J’ai aussi participé avec l’équipe à la migration des interfaces Symfony et Twig vers React et TypeScript.

Déclarer les données une fois

Avant cette refonte, chaque tableau avait sa route, son template Twig et parfois son JavaScript spécifique. Récupération des données, libellés et édition étaient recâblés d’un écran à l’autre. Les exports avaient aussi leurs boucles PHP et leurs propres chemins d’accès aux données.

J’ai extrait cette logique pour la partager. Une clé de donnée associe un libellé, une façon de lire la valeur en SQL et un comportement d’édition. Les filtres utilisent ce même vocabulaire. Une table, une fiche ou un document choisit les clés dont il a besoin ; il ne redéfinit pas comment obtenir chaque valeur.

Une définition partagée, plusieurs usages
Écrans ReactTableaux, filtres et vues de détail
Documents YAMLFormats d’import et d’export Excel
Les mêmes clés de données
  • Libellé
  • Lecture SQL
  • Filtrage
  • Édition

useOsTable : un tableau à partir de sa déclaration

useOsTable est la partie React de ce système. Le développeur déclare les colonnes, les filtres et les actions utiles à son écran. Les clés des colonnes servent à la fois à l’affichage et à la sélection des données à récupérer. Les clés des filtres sont également reconnues : pas de récupération manuelle à réécrire pour chaque combinaison.

Le hook partage le tri, la sélection, le chargement et les mises à jour. L’édition d’une cellule réutilise la clé de la donnée concernée. Côté PHP, le module résout les champs demandés, les conditions et les jointures nécessaires avec le QueryBuilder de Doctrine.

Un écran de contrôle peut ainsi sélectionner des dossiers, calculer leur volume cumac — la quantité d’économies d’énergie associée — et permettre de renseigner le résultat d’un contrôle directement dans la ligne. Un autre écran réutilise ce fonctionnement avec ses propres colonnes et commandes.

Suivi d’un lot de contrôle In Situ : dossiers sélectionnables et résultat du contrôle modifiable dans chaque ligne.

Les mêmes clés pour les imports et les exports

Les formats des documents sont décrits en YAML. Leurs colonnes font référence aux mêmes clés que les interfaces. Imports et exports Excel réutilisent ainsi le lien avec les données métier, au lieu de maintenir une correspondance manuelle dans chaque traitement PHP.

Les différents types de documents et leurs versions sont conservés dans le dépôt. Leurs évolutions peuvent être comparées et suivies avec le code. Un changement de format ne demande plus de réécrire toute la récupération des données.

Réduire le temps des exports

Les anciens exports parcouraient des milliers de dossiers dans des boucles PHP, avec des récupérations de données répétées. Les traitements étaient lancés la nuit.

Le module commun construit la requête à partir des clés demandées, plutôt que d’aller chercher les valeurs dossier par dossier.

Côté navigateur, les tableaux sont aussi virtualisés : seules les lignes proches de la zone visible sont rendues. Ce travail améliore le défilement et l’affichage ; le gain des exports vient, lui, du traitement des données côté PHP.

Faire évoluer le socle avec DDD et Clean Architecture

J’ai ensuite mené les refontes sur React et PHP, en séparant les déclarations métier de leur implémentation commune. DDD aide à organiser le code autour des notions du métier ; la Clean Architecture sépare ces règles des mécanismes d’interface et d’accès aux données.

Pour ce projet, cela permettait de faire évoluer un champ ou une règle métier sans reprendre chaque tableau, fiche et document à la main. Le socle devenait une bibliothèque interne, utilisée pour construire les écrans et les échanges de données de l’application.

Ce que ces outils permettent aux équipes

Un dossier peut revenir en correction plusieurs fois avant d’être validé. Selon l’opération, il passe aussi par un contrôle In Situ, organisé par lots. Les équipes doivent savoir ce qui manque, ce qui attend un contrôle et ce qui peut être déposé.

Le parcours d’un dossier
  1. Constituer le dossier

    Bénéficiaire, chantier, installateur et justificatifs.

  2. Vérifier les pièces

    Examiner le dossier et identifier ce qu’il faut compléter.

    Corrections puis nouvelle vérification
  3. Valider et contrôler

    Suivre la validation du dossier et son contrôle qualité.

    Selon l’opérationContrôle In Situ et suivi du lot
  4. Prêt pour le dépôt

    Retrouver les dossiers déposables pour préparer un dépôt CEE.

Documents, échanges et historique restent liés au dossier.

L’application permet ensuite de sélectionner les dossiers déposables pour préparer un dépôt CEE. Les équipes consultent son état, ses volumes et les demandes de complément, tout en gardant accès à chaque dossier.

Du suivi individuel au traitement par lots
Dossiers déposablesSélection et volumes cumac
RegrouperDépôt CEE

Dossiers sélectionnés et volumes regroupés.

Suivre l’instruction

Statut, demandes de complément et validation du dépôt.

Répondre aux demandes de complément
En parallèle : le suivi des primesMontants, facturation et état des paiements, rattachés aux dossiers.

Les tableaux de bord complètent ce suivi : volumes en attente ou traités, flux de réception et qualité des dossiers par partenaire.

Environnement technique

  • Symfony
  • PHP
  • PHPUnit
  • React
  • TypeScript
  • Jest
  • SQL
  • Git
  • Docker
  • MySQL

Codé sans IA