Conventions numériques
Précision des nombres : quantités, identifiants et valeurs conservées
Un nombre lisible peut avoir perdu de la précision lors d’une conversion. Le dictionnaire doit distinguer quantités mesurées, montants et identifiants avant de décider comment les lire et les exporter.
Source et portée du repère
La RFC 8259 relève les limites de précision des implémentations numériques et décrit une plage d’entiers dont la valeur peut être partagée exactement entre implémentations courantes.
RFC 8259 : nombres JSON — consultée le . Interopérabilité JSON ; la référence ne fixe pas une convention métier d’arrondi ni un type obligatoire pour chaque identifiant fournisseur.
Les contrôles qui suivent constituent une méthode éditoriale de Performance Voyage. Ils ne rapportent aucune opération exécutée sur un compte fournisseur.
Qualifier le champ avant la conversion
Décrivez si la valeur est une quantité, un prix ou une référence. Des chiffres dans un identifiant ne signifient pas qu’un calcul est utile. Le contrat du champ précise le type attendu et les transformations autorisées. Si cette règle manque, gardez une question au fournisseur plutôt qu’utiliser automatiquement le type numérique du langage.
Préparer les valeurs qui révèlent un écart
Le jeu fictif comprend une valeur décimale et une grande référence dont la restitution peut être vérifiée. Comparez entrée, stockage et sortie aux conventions confirmées. Le contrôle distingue présentation arrondie et valeur conservée. Une différence minime sur une quantité peut encore changer un calcul ou une décision de capacité.
Documenter chaque étape de calcul
Gardez unité, précision et moment de l’arrondi dans le dictionnaire applicable. Une règle d’affichage ne doit pas remplacer silencieusement celle du calcul. Le relais retrouve la valeur source et la conversion utilisée avant un export. Cette méthode prépare le contrôle des données ; elle ne prescrit aucune convention financière universelle.
Deux cas fictifs à faire rapprocher
Une référence numérique est arrondie
Scénario fictif : un identifiant long est lu comme nombre puis exporté avec des chiffres différents. Comparez les représentations et le type du contrat. Le cas doit préserver l’identité sans inventer un nouveau format fournisseur.
L’affichage devient la valeur de calcul
Scénario fictif : une quantité fictive de 1,234 est affichée avec deux décimales, puis cette forme remplace l’entrée dans une opération suivante. Faites préciser les étapes et la précision utile. La correction conserve les conventions de calcul et de présentation séparément.
Conserver les preuves et la prochaine décision
| Point | Preuve à retrouver | Contrôle proposé |
|---|---|---|
| Champ | Rôle et type documentés | Qualifier la valeur. |
| Source | Représentation initiale | Garder le point de comparaison. |
| Unité | Convention métier | Expliquer les quantités. |
| Précision | Échelle et limites prévues | Identifier le risque d’écart. |
| Conversion | Étape et type utilisés | Examiner la restitution. |
| Arrondi | Moment et règle | Séparer calcul et affichage. |
| Export | Valeur produite | Comparer à l’attendu. |
| Question | Convention inconnue et responsable | Éviter une règle supposée. |
Le champ conserve son sens, son type et les transformations utiles. La précision perdue est détectée avant de réutiliser la valeur. Les règles inconnues restent attribuées dans le dictionnaire.
Erreurs à éviter
- Calculer sur un identifiant sans contrat.
- Réutiliser une valeur affichée comme entrée exacte.
- Déduire un arrondi métier de la syntaxe JSON.
La fiche de contrôle permet de suivre les huit points. Le registre associé peut être préparé dans l’atelier avec des références fictives ou anonymisées.
Sources et périmètre des faits documentés
La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.
- RFC 8259 : nombres JSON — Interopérabilité JSON ; la référence ne fixe pas une convention métier d’arrondi ni un type obligatoire pour chaque identifiant fournisseur. (consultée le )
Questions fréquentes
Questions utiles avant de décider
Un champ composé de chiffres est-il un nombre ?
Relisez son type et son rôle dans le contrat.
Quelle précision appliquer ?
Celle confirmée pour l’usage et le champ, avec le moment de l’arrondi.
Que comparer dans la recette ?
Entrée, conversions, stockage et sortie sur un jeu fictif connu.