Skip to content

Conversation

@vdegove
Copy link
Contributor

@vdegove vdegove commented Oct 17, 2025

Cette pull request améliore la documentation des schémas statiques et dynamiques :

  • Elle rend explicite le fait que chaque ligne des CSV publiés au schéma correspondent à un point de recharge, à la fois dans le README et dans la documentation
  • Elle extrait du décret la description des objets principaux (point de recharge, station…) dans le README du schéma statique en expliquant comment ils s’articulent dans le fichier
  • Elle inclut une nouvelle section dans le README des deux schémas expliquant l’existence de l’autre schéma et le lien avec celui-ci.

Closes #20

@vdegove vdegove force-pushed the clarify-objects-listed branch from 1b25818 to 5925891 Compare October 20, 2025 07:34
* Les fichiers publiés au schéma listent des points de charge, « une interface associée à un emplacement de stationnement qui permet de recharger un seul véhicule électrique à la fois ». Chaque ligne du fichier représente donc un point de charge.
* Un point de charge peut présenter plusieurs prises (exemple : une prise domestique E/F et une prise Type 2), mais une seule de ces prises peut être utilisée à la fois. Les types de prises disponibles sur un point de charge sont décrites par des colonnes booléennes.
* Les points de charge sont regroupés en stations, « une zone comportant une borne de recharge associée à un ou des emplacements de stationnement ou un ensemble de bornes de recharge associées à des emplacements de stationnement, exploitée par un ou plusieurs opérateurs ». Une station comportant plusieurs points de charge fait donc l’objet de plusieurs lignes (une ligne par point de charge) dans le fichier, avec les informations la concernant (identifiant, nom…) dupliquées sur chaque ligne.
* Les stations comprenent une ou plusieurs bornes. Une borne est « un appareil fixe raccordé à un point d'alimentation électrique, comprenant un ou plusieurs points de recharge et pouvant intégrer notamment des dispositifs de communication, de comptage, de contrôle ou de paiement ». Une borne peut donc comprendre plusieurs points de charge, c’est à dire que plusieurs véhicules peuvent se charger en même temps à la même borne. Les bornes ne sont pas modélisées dans le présent schéma.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@stephane-pignal je me demande suite à nos discussions si il ne faudrait pas même clarifier un peu plus la définition de la borne, en rajoutant une mention explicite du genre « Cette définition légale de la borne pour les points de recharges publics peut différer de l’acceptation grand public où la borne se rapproche d’un point de charge ou d’une prise. » Ton avis ?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@vdegove merci pour ce job de clarification. Mes remarques
1- Côté sémantique, on parle de "point de recharge" et non de "point de charge"
2- En effet un point de charge peut présenter plusieurs prises mais une seule de ces prises peut être utilisée à la fois. Le schéma décrit bien cela, par contre j'ai entendu à plusieurs reprises qu'il existerait désormais des point de recharge (deux connecteurs actifs simultanément. On doit vérifier cela avec la DGEC et aussi checker dans le règlement AFIR (nouveau schéma ou pour être plus précis "concepts")
3- la ligne 21 est cruciale surtout si on conserve le champ "nb_pdc". Par contre le texte me parait à reprendre
4- C'est aussi une bonne idée de préciser pourquoi il n'existe pas la notion de borne. Par contre le texte montre l'utilité mais pas la raison pourquoi cette notion n'est pas reprise dans le schéma

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. Renommer partout « point de charge » en « point de recharge » est corrigé avec le commit f865b3d
  2. En vrai je me demande si ce n’est pas encore une fois une confusion entre borne et point de recharge. La définition même d’un point de recharge est de ne pouvoir accueillir qu’un véhicule à la fois, donc on ne peut pas utiliser plusieurs prises en même temps, dans ce cas par définition ce n’est pas un point de recharge mais deux… Sauf cas très limite : où une des prises n’est pas utilisée par une voiture, par exemple si un utilisateur recharge sa voiture électrique sur la prise 2 et sa trottinette électrique sur la prise domestique. Je pense que les gens qui te parlent de ce cas là ne pensent pas à des points de recharge mais à des bornes qui ont plusieurs points de recharge, sans connaître la différence entre borne et point de recharge. Allez, si, il y aurait un cas ennuyant à modéliser : si il y a une borne qui a deux places de stationnement (donc par définition, deux PDC) mais seulement 1 prise type 2 et 1 prise type combo-CCS pour les deux places. Alors ça ne rentre pas dans le schéma actuel.
  3. Tu peux me faire une proposition de texte ?
  4. Je ne connais pas la raison, et est-ce utile de la préciser ?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. Non il s'agit d'un point de recharge avec plusieurs prise dont 2 recharges simultanément un équipement différent (en effet une voiture et un VAE/trottinette par ex.)
  2. Un station comporte un ou plusieurs points de charge, chaque point de recharge a une référence unique du type "FRxxxxxxxxx". Pour une station, il y a donc dans le fichier autant de lignes que nombre de point de recharge pour cette station. Par ex. une station comportant 4 points de recharge sera matérialisée par 4 lignes différentes dans le fichier et pour chaque ligne un champ nbre_pdc renseigné avec la valeur "4"
  3. C'est une question qui revient très souvent. Je ne connais pas la raison, donc c'est pertinent que l'on ait la réponse. Peut-être que Thibaut sait ?

## Définition des objets et représentation

* Les fichiers publiés au schéma listent des points de charge, « une interface associée à un emplacement de stationnement qui permet de recharger un seul véhicule électrique à la fois ». Chaque ligne du fichier représente donc un point de charge.
* Un point de charge peut présenter plusieurs prises (exemple : une prise domestique E/F et une prise Type 2), mais une seule de ces prises peut être utilisée à la fois. Les types de prises disponibles sur un point de charge sont décrites par des colonnes booléennes.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

À changer, la réglementation parle de connecteurs et non de prises.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

je pense qu'on peut lier et citer les 2 notions. A confirmer

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

J’ai fait ça, voir la dernière version.

@AurelienC
Copy link

Ne faut-il pas prévoir un changement mineur du numéro de version, du type 2.3.0 → 2.3.1 ?

@vdegove
Copy link
Contributor Author

vdegove commented Nov 4, 2025

Ne faut-il pas prévoir un changement mineur du numéro de version, du type 2.3.0 → 2.3.1 ?

@AurelienC puisqu’il ne s’agit que de documentation de l’existant, je ne pense pas que ce soit nécessaire – le schéma lui-même ne change pas.

@AurelienC
Copy link

Les deux json ayant changé (même si d'un point de vue validation, rien ne change), j'aurai quand même tendance à signaler ce changement via 2.3.2 ?

Par exemple, les changements de doc ont amené au changement 2.2.0 → 2.2.1

@vdegove
Copy link
Contributor Author

vdegove commented Nov 4, 2025

Les deux json ayant changé (même si d'un point de vue validation, rien ne change), j'aurai quand même tendance à signaler ce changement via 2.3.2 ?

Par exemple, les changements de doc ont amené au changement 2.2.0 → 2.2.1

Fair enough, du coup je fais une version mineure (et @thbar au passage je n’avais pas fait de version mineure pour les mises à jour techniques).

@thbar
Copy link
Contributor

thbar commented Nov 5, 2025

@vdegove @AurelienC note pour une autre fois : on peut sans souci faire le "bump" de versions dans une autre PR, après merge dans master. Ca permet de faire plusieurs PR de changements, puis une PR "de livraison".

@stephane-pignal
Copy link
Contributor

Perso je n'aurais pas fait de nouvelle version. Surtout en ce moment avec le questionnement sur la mise en place de nouveaux schémas


* Les fichiers publiés au schéma listent des points de recharge, « une interface associée à un emplacement de stationnement qui permet de recharger un seul véhicule électrique à la fois ». Chaque ligne du fichier représente donc un point de recharge (abbrévié « pdc »).
* Un point de recharge peut présenter une ou plusieurs prises (appelés également connecteurs), par exemple : une prise domestique E/F et une prise Type 2. Par définition d’un point de recharge, une seule des prises d’un point de recharge est utilisée à la fois (si plusieurs prises sont utilisées en même temps, il ne s’agit pas d’un point de recharge, mais d’une borne, voir plus loin). Les types de prises disponibles sur un point de recharge sont décrites par des colonnes booléennes.
* Les points de recharge sont regroupés en stations, « une zone comportant une borne de recharge associée à un ou des emplacements de stationnement ou un ensemble de bornes de recharge associées à des emplacements de stationnement, exploitée par un ou plusieurs opérateurs ». Une station comportant plusieurs points de recharge fait donc l’objet de plusieurs lignes (une ligne par point de recharge) dans le fichier, avec les informations la concernant (identifiant, nom…) dupliquées sur chaque ligne.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Une station appartient à une seule unité d'exploitation exploitée par un seul opérateur. -> j'enlèverai le "ou plusieurs"

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@loco-philippe j’ai fait le choix de citer le dernier décret d’application en date, tout ce qui est entre guillemets vient de là, ça me semble hasardeux de modifier les définitions légales, non ?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cette définition introduit la notion de borne et s'appuie sur un découpage physique qui n'est pas géré actuellement (le schéma de données est avant tout centré sur un découpage fonctionnel ou d'usage et n'aborde pas le découpage matériel).

Pourquoi ne pas faire plutôt référence à la définition européenne (Règlement UE 2023/1804), ce qui évacue également la notion de borne ?

«station de recharge»: une installation physique en un lieu spécifique, composée d’un ou de plusieurs points de recharge;

* Les stations comprenent une ou plusieurs bornes. Une borne est « un appareil fixe raccordé à un point d'alimentation électrique, comprenant un ou plusieurs points de recharge et pouvant intégrer notamment des dispositifs de communication, de comptage, de contrôle ou de paiement ». Une borne peut comprendre plusieurs points de recharge, c’est à dire que plusieurs véhicules peuvent se charger en même temps à la même borne sur plusieurs emplacements dédiés. La définition de la borne au sens du décret n° 2021-546 du 4 mai 2021 peut donc différer de l’acceptation grand public du mot borne, qui parfois désigne un point de recharge ou une prise au sens de ce décret. Les bornes ne sont pas modélisées dans le présent schéma.

Pour le reste des définitions (opérateur, aménageur, etc.) les publicateurs pourront se rapporter au [décret n° 2021-546 du 4 mai 2021](https://www.legifrance.gouv.fr/jorf/id/JORFTEXT000043475363) en cas de besoin.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Là par contre, ça mérite une clarification (+ unité d'exploitation) car c'est pas simple !

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

D'une façon ou d'une autre, tout le monde s'est un peu essayé à cet exercice, faut juste trancher la question. Faut juste choisir une stratégie, perso je ne rentrerais dans le détail qui me parait soulever l'incompréhension

@loco-philippe
Copy link

Bonjour à tous,

Quelques remarques (cf également commentaires) :

  • en terme de doc explicative du schéma, on a ajouté dans Qualicharge un document qui se veut plus ou moins indépendant de la structure des données de Qualicharge. Je pense qu'un certain nombre de points devraient être communs (je suis prêt à le transformer en un document à mettre à jour ensemble et qui soit indépendant de nos deux implémentations) et il pourrait également peut-être servir à préparer l'intégration du modèle AFIR.
  • la confusion entre stations et point de recharge provient en grande partie à mon avis de la notion de 'charging station' dans OCPP. Pour OCPP qui adopte une vision matérielle, l'EVSE correspond à la définition de notre point de recharge et charging station correspond à l'équipement physique (borne ?) qui acceuille les EVSE. Par contre OCPI est plutôt centré sur une approche d'administration et de gestion. Pour OCPI, cette notion de charging station n'existe pas et les EVSE gérés ensemble sont regroupés dans une même entité 'location' qui correspond à notre notion de station de recharge.
  • je pense qu'il est très difficile de statuer sur une définition de la borne car cela impose de rentrer dans les différentes architectures matérielles (complexe vu la diversité existante)
  • je suis d'accord avec la remarque de @vdegove "La définition même d’un point de recharge est de ne pouvoir accueillir qu’un véhicule à la fois", mais on commence à voir apparaître des architecture plus complexes avec par exemple deux bornes équipées chacune de deux connecteurs et desservant trois places. La puissance globale de cet ensemble permet d'alimenter 3 charges en parallèle et la place du milieu peut être alimentée par un connecteur de la borne de droite ou de celle de gauche. Dans ce cas, on demande aux opérateurs de déclarer un point de recharge par connecteur et d'indiquer dans le 'nbre_pdc' le nombre de points de recharge utilisables en même temps (ce qui revient au nombre de places)
  • Ca serait utile d'indiquer que tout n'est pas décrit par le schéma et qu'il existe d'autres contraintes de cohérence entre champs à respecter.

@vdegove
Copy link
Contributor Author

vdegove commented Nov 6, 2025

@loco-philippe merci pour ta review également :) J’ai fait au mieux pour prendre en compte vos diverses remarques. Je prends en compte mais propose de ne pas non plus faire un effort trop important ici. Il y a des grosses évolutions à venir (donc tout ceci risque d’être bientôt caduc). Le but était ici de remettre à plat et comprendre «ce qu’on a» (j’ai gratté ma propre démangeaison à vrai dire pour comprendre le vocabulaire et les entités métier pour rentrer dans le sujet) et réactiver le dépôt afin de préparer l’arrivée de la suite.

@vdegove
Copy link
Contributor Author

vdegove commented Nov 6, 2025

J’ai fait le choix de ne pas faire de version mineure pour cette documentation, je suis d’accord avec @stephane-pignal il vaut mieux ne pas laisser croire que ce schéma est en train de bouger alors qu’il y a des questionnements sur des nouvelles versions.

@loco-philippe
Copy link

@loco-philippe merci pour ta review également :) J’ai fait au mieux pour prendre en compte vos diverses remarques. Je prends en compte mais propose de ne pas non plus faire un effort trop important ici. Il y a des grosses évolutions à venir (donc tout ceci risque d’être bientôt caduc). Le but était ici de remettre à plat et comprendre «ce qu’on a» (j’ai gratté ma propre démangeaison à vrai dire pour comprendre le vocabulaire et les entités métier pour rentrer dans le sujet) et réactiver le dépôt afin de préparer l’arrivée de la suite.

Oui, exercice difficile (comment ne pas en faire trop !).

Concernant mes commentaires, c'est plus des commentaires et questionnements généraux que des commentaires liés à cette PR (il ne faut pas que ça bloque ou perturbe)

* Les points de recharge sont regroupés en stations, « une zone comportant une borne de recharge associée à un ou des emplacements de stationnement ou un ensemble de bornes de recharge associées à des emplacements de stationnement, exploitée par un ou plusieurs opérateurs ». Une station comportant plusieurs points de recharge fait donc l’objet de plusieurs lignes (une ligne par point de recharge) dans le fichier, avec les informations la concernant (identifiant, nom…) dupliquées sur chaque ligne.
* Les stations comprenent une ou plusieurs bornes. Une borne est « un appareil fixe raccordé à un point d'alimentation électrique, comprenant un ou plusieurs points de recharge et pouvant intégrer notamment des dispositifs de communication, de comptage, de contrôle ou de paiement ». Une borne peut comprendre plusieurs points de recharge, c’est à dire que plusieurs véhicules peuvent se charger en même temps à la même borne sur plusieurs emplacements dédiés. La définition de la borne au sens du décret n° 2021-546 du 4 mai 2021 peut donc différer de l’acceptation grand public du mot borne, qui parfois désigne un point de recharge ou une prise au sens de ce décret. Les bornes ne sont pas modélisées dans le présent schéma.
* Les fichiers publiés au schéma listent des points de recharge, « une interface associée à un emplacement de stationnement qui permet de recharger un seul véhicule électrique à la fois ». Chaque ligne du fichier représente donc un point de recharge (abbrévié « pdc »). Les points de recharge accessibles en itinérance (la majorité) ont un identifiant unique id_pdc_itinerance type `FRxxxxxxxxxxxxx`.
* Un point de recharge peut présenter une ou plusieurs prises (appelés également connecteurs), par exemple : une prise domestique E/F et une prise Type 2. Par définition d’un point de recharge, une seule des prises d’un point de recharge est utilisée pour recharger un véhicule électrique à la fois, puisque le point de recharge ne présente qu’une seule place de stationnement. Les types de prises disponibles sur un point de recharge sont décrites par des colonnes booléennes.
Copy link

@loco-philippe loco-philippe Nov 7, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Petite remarque de forme (puisque ce chapitre présente les objets et représentations, je propose d'inverser prise et connecteur) :

  • Un point de recharge peut présenter un ou plusieurs connecteurs (appelés également prises), par exemple : un connecteur domestique E/F et un connecteur Type 2. Par définition d’un point de recharge, un seul des connecteurs d’un point de recharge est utilisé pour recharger un véhicule électrique à la fois, puisque le point de recharge ne présente qu’une seule place de stationnement. Les types de connecteurs disponibles sur un point de recharge sont décrites par des colonnes booléennes.

* Les fichiers publiés au schéma listent des points de recharge, « une interface associée à un emplacement de stationnement qui permet de recharger un seul véhicule électrique à la fois ». Chaque ligne du fichier représente donc un point de recharge (abbrévié « pdc »). Les points de recharge accessibles en itinérance (la majorité) ont un identifiant unique id_pdc_itinerance type `FRxxxxxxxxxxxxx`.
* Un point de recharge peut présenter une ou plusieurs prises (appelés également connecteurs), par exemple : une prise domestique E/F et une prise Type 2. Par définition d’un point de recharge, une seule des prises d’un point de recharge est utilisée pour recharger un véhicule électrique à la fois, puisque le point de recharge ne présente qu’une seule place de stationnement. Les types de prises disponibles sur un point de recharge sont décrites par des colonnes booléennes.
* Les points de recharge sont regroupés en stations, « une zone comportant une borne de recharge associée à un ou des emplacements de stationnement ou un ensemble de bornes de recharge associées à des emplacements de stationnement, exploitée par un ou plusieurs opérateurs ». Comme chaque ligne du fichier correspond à un point de recharge, pour une station, il y a dans le fichier autant de lignes que nombre de point de recharge pour cette station. Par exemple, une station comportant 4 points de recharge sera matérialisée par 4 lignes différentes dans le fichier et pour chaque ligne un champ `nbre_pdc` renseigné avec la valeur « 4 ». Les informations concernant la station (identifiant, nom…) sont dupliquées à l’identique sur chacune des lignes de la station.
* Les stations comprenent une ou plusieurs bornes. Une borne est « un appareil fixe raccordé à un point d'alimentation électrique, comprenant un ou plusieurs points de recharge et pouvant intégrer notamment des dispositifs de communication, de comptage, de contrôle ou de paiement ». Une borne peut comprendre plusieurs points de recharge, c’est à dire que plusieurs véhicules peuvent se charger en même temps à la même borne sur plusieurs emplacements dédiés. Le choix du nombre de bornes est un choix architectural dépendant de la configuration des lieux (combien de « supports verticaux », et sont-ils mutualisés entre plusieurs points de recharge) et n’a pas d’incidence sur le service offert, puisque le nombre de véhicules pouvant se charger simultanément dépend du nombre de points de recharge. La définition de la borne au sens du décret n° 2021-546 du 4 mai 2021 peut donc différer de l’acceptation grand public du mot borne, qui parfois désigne un point de recharge ou une prise au sens de ce décret. Les bornes ne sont pas modélisées dans le présent schéma.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Idem sur la forme, je propose de remplacer prise par connecteur.

@stephane-pignal
Copy link
Contributor

@vdegove @loco-philippe ce ne sera jamais parfait, on pourra reprendre et c'est déjà mieux
Chouette job !

@loco-philippe
Copy link

@vdegove @loco-philippe ce ne sera jamais parfait, on pourra reprendre et c'est déjà mieux Chouette job !

Tout à fait d'accord avec Stéphane, ce type de document, c'est l'enfer, tout le monde veut que son avis soit pris en compte.

Bravo pour avoir pris la peine de l'améliorer tout en essayant de contenter chacun.

@vdegove vdegove merged commit c3f80e6 into master Nov 24, 2025
2 checks passed
@vdegove vdegove deleted the clarify-objects-listed branch November 24, 2025 15:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Améliorations de la documentation à prévoir

6 participants