Préparer le fichier des commandes

Un suivi de commandes ne peut pas reposer durablement sur des valeurs écrites directement dans un script. Vous allez préparer un fichier de données séparé, lisible et structuré, pour que les prochaines étapes puissent charger plusieurs commandes et en calculer les totaux.

Dans la leçon précédente, vous avez utilisé calculerTotal avec des montants fournis dans le script. Ici, vous conservez les fichiers existants et ajoutez uniquement data/commandes.json : la fonction de calcul et src/serveur.js ne changent pas.

Créer un tableau de commandes

Créez le dossier data à la racine du projet, au même niveau que package.json et src, puis créez-y le fichier commandes.json. En JSON, un tableau est délimité par des crochets et contient ici plusieurs objets délimités par des accolades. Chaque objet représente une commande et porte les mêmes champs : reference, statut et montants.

[
  {
    "reference": "BR-1042",
    "statut": "En préparation",
    "montants": [18.5, 12]
  },
  {
    "reference": "BR-1043",
    "statut": "À expédier",
    "montants": [9.5, 7]
  },
  {
    "reference": "BR-1044",
    "statut": "En préparation",
    "montants": [24]
  }
]

Respectez la syntaxe : les noms de champs et les chaînes de caractères sont entre guillemets doubles, les valeurs sont séparées par des virgules et le dernier champ d’un objet n’a pas de virgule finale. Les crochets de montants forment un tableau de nombres ; ils correspondent aux valeurs que le calcul pourra additionner. Gardez des montants numériques, sans symbole euro ni texte, afin qu’ils puissent être utilisés comme nombres.

Comprendre les valeurs enregistrées

Les références identifient les commandes : BR-1042, BR-1043 et BR-1044. Le statut est une chaîne destinée à décrire l’étape de préparation. Le champ montants regroupe les montants des lignes de chaque commande ; par exemple, les deux premières lignes de BR-1042 valent 18,5 et 12 euros, soit 30,5 euros au total.

Le fichier contient des données, pas du code JavaScript : n’y ajoutez ni commentaires, ni variables, ni appels de fonction. Écrivez des décimales avec un point, comme 18.5, et non avec une virgule. Ces choix rendent les valeurs non ambiguës pour les outils qui liront le fichier.

Vérifier le fichier

Comparez votre fichier avec l’exemple et vérifiez qu’il se trouve exactement sous data/commandes.json. Le tableau comporte trois commandes, chacune avec les trois champs attendus ; les valeurs d’une commande restent regroupées dans le même objet. À ce stade, vous ne modifiez pas le script principal et vous n’avez pas encore besoin d’afficher le contenu dans le terminal.

La lecture et la validation par un programme viendront dans les leçons suivantes. Vous verrez ensuite comment charger ce fichier et convertir son contenu en données JavaScript ; pour l’instant, votre vérification porte sur la structure et la ponctuation du document.

À retenir

• Placez les données dans `data/commandes.json`, sans modifier les autres fichiers du projet.
• Représentez plusieurs commandes par un tableau d’objets JSON.
• Gardez pour chaque commande les champs `reference`, `statut` et `montants`.
• Respectez les guillemets doubles, les séparateurs et les valeurs numériques sans symbole monétaire.

Dans la prochaine leçon, vous lirez ce fichier depuis Node.js afin de récupérer ses données dans le programme.