Lehrplan Lektion 221 von 250 · Projekt: Document Intelligence Service
Projekt: Document Intelligence Service

Abgleich mit den Geschäftsregeln

Eine

A-Aufzeichnung kann perfekt geformt sein und trotzdem wrong sein. Die Posten ergeben zusammen $118, aber die angegebene Summe sagt $128. Das Datum ist 2026-13-40. Die Summe ist negativ. Die Schema-Validierung wird nichts davon erfassen. Das sind business-rule-Verletzungen. Sie zu finden ist das, was ein Spielzeug von einem Dienst unterscheidet, dem ein Buchhaltungsteam tatsächlich vertrauen würde.

Schreibe reconcile(record) -> eine list of discrepancy strings. Eine leere Liste bedeutet, dass der Datensatz sauber abgeglichen wird. Jede Regel, die fehlschlägt, fügt einen menschenlesbaren String hinzu. Drei Regeln:

  • Elemente müssen die Summe ergeben (bis auf einen Cent). Addiere die amount jedes Eintrags in line_items und vergleiche sie mit total. Wenn sie sich um mehr als 0.01 unterscheiden, füge "total mismatch: items sum to X but total is Y" hinzu (runde beide auf 2 Stellen in der Nachricht). Floats sind ungenau, also vergleiche immer mit einer Toleranz, niemals ==.
  • Das Datum muss als echtes Kalenderdatum in YYYY-MM-DD Form parsen. Nutze datetime.strptime(record["date"], "%Y-%m-%d") innerhalb einer try/except ValueError; bei Fehler füge "bad date: <value>" an. (strptime lehnt unmögliche Daten wie Monat 13 für dich ab.)
  • Die Summe muss positiv sein. Wenn total <= 0, füge "non-positive total: <value>" hinzu.

Die Reihenfolge ist für die Tests wichtig: prüfe zuerst die sum, dann das date, dann die sign der Summe, hänge sie in dieser Reihenfolge an, damit ein Datensatz, der mehrere Regeln verletzt, diese vorhersehbar auflistet.

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

Dies ist der Abgleichschritt, den jedes Rechnungs-, Ausgaben- und Hauptbuchsystem ausführt, bevor es eine Zeile schreibt. Drücke Run, um einen sauberen Datensatz und einen fehlerhaften abzugleichen und die Abweichungen gegenüberzustellen.

Du bist dran

Schreibe reconcile(record), das eine Liste von Diskrepanz-Strings für einen Datensatz mit line_items (jeder {"desc", "amount"}), total und date zurückgibt. Füge in dieser Reihenfolge hinzu: einen "total mismatch: items sum to X but total is Y"-String, wenn die Posten nicht auf einen Cent genau total ergeben (Werte auf 2 Dezimalstellen gerundet); einen "bad date: <value>"-String, wenn das Datum kein echtes YYYY-MM-DD-Datum ist; und einen "non-positive total: <value>"-String, wenn total <= 0. Ein sauberer Datensatz gibt [] zurück.

Ein Problem in dieser Lektion entdeckt? Melde es · Frage zu dieser Lektion

Diese Übung öffnet bald

Beende die vorherige Lektion, damit diese freigeschaltet wird. Der ganze Kurs ist kostenlos, kein Konto erforderlich, und du kannst diese Lektion jetzt direkt lesen.