Programma Lezione 221 di 250 · Progetto: servizio di intelligenza sui documenti
Progetto: servizio di intelligenza sui documenti

Riconciliare con le regole di business

Un record può avere una forma perfetta ed essere comunque sbagliato. Le voci sommano a $118 ma il totale dichiarato dice $128. La data è 2026-13-40. Il totale è negativo. La validazione dello schema non becca niente di tutto questo -> sono violazioni delle regole di business, e beccarle è ciò che separa un giocattolo da un servizio di cui un team di contabilità si fiderebbe davvero.

Scrivi reconcile(record) -> una lista di stringhe di discrepanza. Una lista vuota significa che il record si riconcilia senza problemi. Ogni regola che fallisce aggiunge una stringa leggibile da una persona. Tre regole:

  • Le voci devono sommare al totale (entro un centesimo). Somma l'amount di ogni voce di line_items e confrontalo con total. Se differiscono di più di 0.01, aggiungi "total mismatch: items sum to X but total is Y" (arrotonda entrambi a 2 cifre nel messaggio). I float sono imprecisi, quindi confronta sempre con una tolleranza, mai con ==.
  • La data deve essere leggibile come vera data di calendario nella forma YYYY-MM-DD. Usa datetime.strptime(record["date"], "%Y-%m-%d") dentro un try/except ValueError; in caso di fallimento aggiungi "bad date: <value>". (strptime rifiuta per te le date impossibili come il mese 13.)
  • Il totale deve essere positivo. Se total <= 0, aggiungi "non-positive total: <value>".

L'ordine conta per i test: controlla prima la somma, poi la data, poi il segno del totale, aggiungendo in quell'ordine così un record che rompe più regole le elenca in modo prevedibile.

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

È il passo di riconciliazione che ogni sistema di fatturazione, di note spese e di contabilità fa girare prima di osare scrivere una riga. Premi Run per riconciliare un record pulito e uno rotto e vedere le discrepanze mettersi in fila.

Tocca a te

Scrivi reconcile(record) che restituisce una lista di stringhe di discrepanza per un record con line_items (ognuna {"desc", "amount"}), total e date. Aggiungi, in quest'ordine: una stringa "total mismatch: items sum to X but total is Y" quando le voci non sommano a total entro un centesimo (valori arrotondati a 2 decimali); una stringa "bad date: <value>" quando la data non è una vera data YYYY-MM-DD; e una stringa "non-positive total: <value>" quando total <= 0. Un record pulito restituisce [].

Hai notato un problema in questa lezione? Segnalalo · Chiedi qualcosa su questa lezione

Questo esercizio si apre presto

Finisci la lezione precedente e questa si sblocca. L'intero corso è gratuito, senza account, e puoi leggere questa lezione subito.