Programme Leçon 221 sur 250 · Projet : Service d'intelligence de documents
Projet : Service d'intelligence de documents

Se concilier avec les règles métier

Le

A peut être parfaitement structuré et être quand même wrong. Les éléments de la ligne s'additionnent à 118 $ mais le total indiqué dit 128 $. La date est 2026-13-40. Le total est négatif. La validation du Schema ne détectera aucun de ces éléments -> ce sont des business-rule violations, et les détecter est ce qui sépare un jouet d'un service qu'une équipe de comptabilité pourrait réellement faire confiance.

Écris reconcile(record) -> une liste de chaînes de divergence. Une liste vide signifie que l'enregistrement est réconcilié proprement. Chaque règle qui échoue ajoute une chaîne lisible par un humain. Trois règles :

  • Les éléments doivent être égaux au total (à un centime près). Additionne le amount de chaque entrée dans line_items et compare à total. S'ils diffèrent de plus de 0.01, ajoute "total mismatch: items sum to X but total is Y" (arrondis les deux à 2 décimales dans le message). Les Floats sont imprécis, donc compare toujours avec une tolérance, jamais ==.
  • La date doit être analysée comme une date réelle du calendrier au format YYYY-MM-DD. Utilise datetime.strptime(record["date"], "%Y-%m-%d") à l'intérieur d'une try/except ValueError; en cas d'échec, ajoute "bad date: <value>". (strptime rejette les dates impossibles comme le mois 13 pour toi.)
  • Le total doit être positif. Si total <= 0, ajoute "non-positive total: <value>".

L'ordre est important pour les tests : vérifie d'abord la sum, puis la date, puis la sign du total, en les ajoutant dans cet ordre pour qu'un enregistrement qui enfreint plusieurs règles les liste de manière prévisible.

from datetime import datetime

def reconcile(record):
    issues = []
    items_sum = sum(it["amount"] for it in record["line_items"])
    if abs(items_sum - record["total"]) > 0.01:
        issues.append(...)
    # then the date, then the sign
    return issues

C'est l'étape de réconciliation que chaque système de facturation, de dépenses et de grand livre effectue avant d'oser écrire une ligne. Appuie sur Run pour réconcilier un enregistrement propre et un enregistrement cassé et vois les écarts s'aligner.

À ton tour

Écris reconcile(record) qui retourne une liste de chaînes de divergence pour un enregistrement avec line_items (chaque {"desc", "amount"}), total, et date. Ajoute, dans cet ordre : une chaîne "total mismatch: items sum to X but total is Y" quand les articles de ligne ne somment pas à total à un centime près (valeurs arrondies à 2 dp) ; une chaîne "bad date: <value>" quand la date n'est pas une date YYYY-MM-DD réelle ; et une chaîne "non-positive total: <value>" quand total <= 0. Un enregistrement propre retourne [].

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.