Velizen : une application web sur mesure pour piloter des dossiers CEE, une API métier et des back-offices

1. Présentation du client

Comprendre le contexte business avant la solution

Velizen est une plateforme dédiée à la gestion de subventions VAE et de dossiers CEE. Elle relie des organisations, des points de vente, des utilisateurs magasin, un catalogue vélo, des pièces réglementaires et un partenaire CEE qui doit accepter, refuser ou demander des corrections sur les dossiers.

Le besoin client ne pouvait pas être couvert proprement par un outil standard. Les règles de forfait, les montants de prime, les taux, les marges, les statuts, les validations et les pièces attendues varient selon les cas. Le produit devait donc être modelé autour du vrai processus, pas l’inverse.

Cyclable a été intégré comme premier client structurant, avec catalogue, variantes, commandes, factures et points de vente. Le projet comprend aussi des briques ERP, notamment autour de Cegid, pour relier les flux commerciaux aux dossiers. L’architecture a été préparée pour accueillir d’autres grandes organisations, dont les noms restent confidentiels, sans réécrire les fondations du produit.

2. Méthode projet Dawap

Analyse, priorisation, delivery agile et sécurisation du run

Le cadrage a commencé par la cartographie du cycle complet d’un dossier CEE : création, choix du vélo, informations bénéficiaire, bon de commande, facture, certificat de marquage, attestation sur l’honneur, validation vendeur, accusé partenaire et réponse réglementaire. Cette lecture étape par étape a servi de base au modèle métier.

Le delivery a ensuite été découpé en lots suivis dans Jira : API d’authentification, espaces utilisateurs, catalogue VAE, import Cyclable, création des dossiers, génération et dépôt de documents, validation partenaire, tableaux de bord et instrumentation du run. Chaque sprint devait livrer une brique utilisable et vérifiable par le métier.

La qualité a été sécurisée par une architecture Symfony 7 en couches, des use cases explicites, des contrôleurs API séparés par rôle, une documentation OpenAPI, des tests PHPUnit, des environnements local, sandbox et production conteneurisés, puis une CI GitLab avec build, tests et images applicatives avant diffusion.

3. Besoin Velizen

Transformer un processus CEE complexe en plateforme exploitable

Le point de départ était clair : Velizen devait industrialiser la gestion de dossiers CEE pour le VAE sans enfermer les équipes dans des tableurs, des échanges mails ou des contrôles impossibles à tracer. Chaque dossier devait porter son statut, ses pièces, ses montants et ses décisions.

Le système devait aussi rester utilisable par des profils très différents : responsables d’organisation, utilisateurs en magasin, administrateurs Velizen, partenaire CEE et futurs clients. Chacun devait voir son périmètre, ses actions et ses priorités sans accéder au reste.

Cette contrainte multi-acteurs a orienté toute l’architecture. L’application n’est pas un back-office unique avec des droits ajoutés après coup : elle repose sur plusieurs espaces cohérents, chacun aligné avec une responsabilité opérationnelle.

4. Complexité CEE et VAE

Règles, forfaits, primes et décisions réglementaires

Un dossier CEE ne se résume pas à une ligne en base. Il combine un vélo et sa variante, une organisation, un point de vente, un bénéficiaire, un bon de commande, une facture, un certificat de marquage, une attestation, des montants de prime, des taux et une réponse réglementaire.

Le modèle Velizen conserve donc des informations précises : prime client, part Velizen, montants taxés et non taxés, marge, identifiant d’accusé, validation vendeur, validation partenaire, date de réponse, motif de refus et pièces générées ou déposées.

Cette granularité évite deux risques classiques : perdre la preuve d’une décision ou ne plus savoir pourquoi un dossier a été accepté, refusé ou laissé en attente. Dans un contexte réglementé, la traçabilité fait partie du produit.

5. Architecture application Symfony

Une application métier web bâtie autour d’une API REST documentée

Dawap a construit le socle en Symfony 7 avec une architecture orientée domaine. Les modules principaux couvrent le catalogue, les organisations, les utilisateurs, les dossiers CEE, les ventes, l’ERP et le monitoring. Les use cases sont séparés entre requêtes, réponses, presenters, repositories et services métier.

L’application expose une API web JSON pour l’authentification, les organisations, les magasins, les utilisateurs, le catalogue VAE, les dossiers CEE, les validations partenaire et la configuration. Les documentations Redoc et OpenAPI donnent un contrat lisible aux intégrateurs sans réduire le projet à un simple connecteur.

Cette approche permet à Velizen de rester un produit ouvert : les back-offices et espaces métier consomment le même socle que les intégrations, tandis que les futurs clients peuvent être branchés sans reconstruire un nouveau chemin technique à chaque fois.

Les pages les plus proches côté Dawap sont l’application métier web, le back-office métier sur mesure et la création d’API sur mesure.

6. Workspaces et rôles

Admin, organisations, magasins et partenaire CEE

Le projet distingue plusieurs workspaces. L’espace admin permet de superviser le catalogue, les organisations, les utilisateurs, les imports et les indicateurs. L’espace organisation donne aux responsables une vue consolidée des dossiers, des points de vente et des primes.

L’espace magasin se concentre sur l’action terrain : créer un dossier, renseigner le bénéficiaire, associer un vélo, déposer ou générer les pièces attendues, puis valider le dossier côté vendeur. Le vendeur reste guidé par des étapes compréhensibles, même si la logique derrière est dense.

L’espace partenaire CEE a un rôle différent : valider les vélos et variantes éligibles, traiter les dossiers reçus, accuser réception, accepter ou refuser selon la réponse réglementaire, et suivre le volume de dossiers par statut. Cette séparation évite de mélanger production magasin et décision partenaire.

7. Intégration Cyclable et ERP Cegid

Catalogue, variantes, commandes, factures, ERP et magasins

Cyclable a servi de première intégration structurante. Le connecteur récupère le catalogue VAE depuis une API dédiée, mappe les vélos, variantes, EAN, marques, images, modèles ERP et caractéristiques utiles comme batterie, cadre, taille, couleur, moteur ou poids.

Les flux commerciaux complètent le catalogue : commandes, factures et pièces associées peuvent être reprises dans le processus dossier. Les imports sont pensés pour reconnaître les points de vente, rattacher les données à la bonne organisation et éviter les ressaisies inutiles.

Le socle prévoit aussi des échanges ERP Cegid, afin de faire circuler les données commerciales utiles entre le système de gestion et le workflow CEE. Cette intégration est importante pour la suite du produit : Velizen n’est pas limité à un écran de saisie, la plateforme peut absorber des données externes, les normaliser et les faire vivre dans un processus réglementaire.

8. Workflow documentaire

Des étapes visibles pour chaque pièce attendue

Le cycle d’un dossier est découpé en étapes explicites : démarrage, informations bénéficiaire, bon de commande signé, facture, certificat de marquage, attestation sur l’honneur, confirmation et validation vendeur. Chaque étape a ses contrôles, ses fichiers et ses dates.

Dawap a aussi branché les briques nécessaires autour de ces documents : génération PDF, dépôt de pièces, extraction de données depuis facture, récupération de certificats de marquage Bicycode, signature électronique Universign, horodatage et génération d’archive ZIP.

Ce découpage rend le produit plus robuste. Quand une pièce manque, quand une donnée ne matche pas ou quand une validation bloque, l’équipe voit l’endroit précis du problème au lieu de reprendre tout le dossier à l’aveugle.

Magasin
  -> création dossier CEE
    -> bénéficiaire + vélo
      -> documents et signatures
        -> validation vendeur
          -> accusé partenaire CEE
            -> réponse réglementaire
              -> statistiques et suivi

9. API partenaire CEE et Engie

Accuser, contrôler et répondre sans exposer tout le produit

Une partie clé du projet concerne l’API partenaire CEE. Elle permet de consulter les vélos et variantes, vérifier l’éligibilité, rechercher les dossiers en attente, télécharger les archives, accuser réception et pousser une réponse réglementaire.

C’est ici que les échanges avec le fournisseur partenaire, notamment Engie / CertiNergy, prennent tout leur sens. Velizen peut transmettre un dossier structuré, recevoir un identifiant d’accusé, enregistrer une validation, un refus et un motif, puis répercuter l’état aux espaces métier.

L’API garde une frontière claire : le partenaire CEE traite ce qu’il doit traiter, sans accéder aux écrans ou données qui ne relèvent pas de son rôle. C’est un point essentiel pour les futurs grands clients, surtout lorsque leurs noms ou leurs volumes ne doivent pas être communiqués publiquement.

10. Stats, pilotage et run

Mesurer les dossiers, les primes et les validations

Velizen dispose de plusieurs niveaux de statistiques. Côté organisation, les tableaux de bord suivent le nombre de dossiers, les dossiers acceptés, refusés ou en attente, les primes acceptées par point de vente et les tendances mensuelles.

Côté partenaire CEE, les écrans suivent les dossiers envoyés, la répartition accepté / refusé / en attente, les produits mères ou variantes à valider, l’évolution des traitements vélo et les connexions. Ces vues ne sont pas décoratives : elles servent à prioriser le travail et à détecter les retards.

L’administration garde aussi des vues de pilotage comptable et de performance. L’objectif est de rendre l’exploitation lisible, car un produit avec des règles CEE complexes devient vite fragile si personne ne voit les volumes, les blocages et les délais.

11. Sécurité, tests et CI/CD

Un socle prêt pour des intégrations sensibles

L’API est protégée par une authentification JWT stateless avec refresh token. Les routes sont séparées par périmètre : admin, organisation, partenaire CEE, catalogue, documentation et webhooks. Les rôles hiérarchiques évitent d’empiler des conditions dispersées dans les écrans.

Les traitements asynchrones reposent sur Symfony Messenger et RabbitMQ pour les imports Cyclable de commandes et factures. L’application s’appuie aussi sur Azure Blob Storage, Mailjet, Cegid, Universign et Bicycode selon les flux activés.

La CI GitLab construit les images PHP et Nginx, lance les tests d’intégration et d’application sur MySQL et Redis, puis pousse des images testées pour sandbox ou production. Cette discipline était nécessaire pour un produit appelé à accueillir plusieurs clients et intégrations.

12. Scénario terrain

Un dossier CEE depuis un magasin jusqu’à la validation partenaire

Un utilisateur magasin démarre un dossier pour un client qui achète un VAE. Il sélectionne le vélo et la variante, complète les informations bénéficiaire, associe les pièces commerciales et laisse l’application guider les étapes documentaires.

Le système vérifie les données utiles, génère ou récupère les documents attendus, trace les fichiers déposés, calcule les montants liés au dossier et prépare l’ensemble pour la validation. Le responsable organisation peut suivre le volume et les primes par point de vente.

Une fois le dossier validé côté vendeur, le partenaire CEE le traite depuis son workspace ou via l’API dédiée : accusé de réception, réponse réglementaire, validation ou refus motivé. Velizen conserve les dates, statuts et réponses, ce qui rend la décision exploitable par les équipes sans échange manuel supplémentaire.

13. Résultats et suite

Un produit sur mesure prêt à grandir

Le résultat est un socle métier solide pour Velizen : un catalogue VAE synchronisé, des organisations et magasins structurés, des dossiers CEE en étapes, des validations partenaire, des documents maîtrisés, des statistiques, des back-offices et une API documentée pour intégrer les acteurs externes.

Pour Cyclable, le projet apporte une première trajectoire concrète avec catalogue, magasins, commandes et factures. Pour Velizen, il prépare l’arrivée de grandes organisations supplémentaires sans imposer une refonte du modèle à chaque nouveau compte.

La suite naturelle concerne l’enrichissement des règles de forfait, l’extension à d’autres clients, l’amélioration des automatisations documentaires, le suivi plus fin des délais de traitement et la consolidation des indicateurs de performance CEE.