-
Notifications
You must be signed in to change notification settings - Fork 10
Documentation : clarification des objets listés et du lien entre les schémas #70
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
1b25818 to
5925891
Compare
statique/README.md
Outdated
| * 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. |
There was a problem hiding this comment.
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 ?
There was a problem hiding this comment.
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
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Renommer partout « point de charge » en « point de recharge » est corrigé avec le commit f865b3d
- 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.
- Tu peux me faire une proposition de texte ?
- Je ne connais pas la raison, et est-ce utile de la préciser ?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- 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.)
- 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"
- 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 ?
statique/README.md
Outdated
| ## 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. |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
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
There was a problem hiding this comment.
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.
|
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. |
|
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). |
|
@vdegove @AurelienC note pour une autre fois : on peut sans souci faire le "bump" de versions dans une autre PR, après merge dans |
|
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 |
statique/README.md
Outdated
|
|
||
| * 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. |
There was a problem hiding this comment.
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"
There was a problem hiding this comment.
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 ?
There was a problem hiding this comment.
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. | ||
|
|
There was a problem hiding this comment.
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 !
There was a problem hiding this comment.
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
|
Bonjour à tous, Quelques remarques (cf également commentaires) :
|
|
@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. |
This reverts commit 7ca7e24.
|
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. |
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. |
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
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.
|
@vdegove @loco-philippe ce ne sera jamais parfait, on pourra reprendre et c'est déjà mieux |
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. |
Cette pull request améliore la documentation des schémas statiques et dynamiques :
Closes #20