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.
- Application métier

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.
- 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.

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é.
- Constituer le dossier
Bénéficiaire, chantier, installateur et justificatifs.
- Vérifier les pièces
Examiner le dossier et identifier ce qu’il faut compléter.
Corrections puis nouvelle vérification - 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 - Prêt pour le dépôt
Retrouver les dossiers déposables pour préparer un dépôt CEE.
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.
Dossiers sélectionnés et volumes regroupés.
Statut, demandes de complément et validation du dépôt.
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





