Программа курса Урок 221 из 250 · Проект: Document Intelligence Service
Проект: Document Intelligence Service

Соответствие бизнес-правилам

A запись может иметь правильную форму и все равно быть wrong. Пункты добавляются до $118, но указанная общая сумма говорит $128. Дата это 2026-13-40. Общая сумма отрицательная. Валидация Schema не поймает ничего из этого -> это business-rule нарушения, и их обнаружение отделяет игрушку от сервиса, которому команда бухгалтерии действительно доверится.

Напишите reconcile(record) -> список строк расхождений. Пустой список означает, что запись успешно сверяется. Каждое невыполненное правило добавляет одну понятную человеку строку. Три правила:

  • Сумма элементов должна быть равна (с точностью до цента). Сложите amount каждой записи в line_items и сравните с total. Если разница больше чем 0.01, добавьте "total mismatch: items sum to X but total is Y" (округлите оба значения до 2 знаков в сообщении). Числа с плавающей точкой неточны, поэтому всегда сравнивайте с допуском, никогда ==.
  • Дата должна парситься как реальная календарная дата в формате YYYY-MM-DD. Используйте datetime.strptime(record["date"], "%Y-%m-%d") внутри try/except ValueError; при ошибке добавляйте "bad date: <value>". (strptime отклоняет невозможные даты, такие как месяц 13, для вас.)
  • Общая сумма должна быть положительной. Если total <= 0, добавьте "non-positive total: <value>".

Порядок важен для тестов: сначала проверьте sum, затем date, потом sign от общего итога, добавляя их в этом порядке, чтобы запись, нарушающая несколько правил, выводила их предсказуемо.

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

Это шаг сверки, который каждая система выставления счетов, учета расходов и бухгалтерского учета выполняет перед тем, как решится записать строку. Нажмите Run, чтобы сверить чистую запись и сломанную, и увидеть, как выстраиваются расхождения.

Твоя очередь

Напишите reconcile(record), которая возвращает список строк с расхождениями для записи с line_items (каждый {"desc", "amount"}), total и date. Добавьте в этом порядке: строку "total mismatch: items sum to X but total is Y", когда позиции в строке не суммируются до total с точностью до цента (значения округлены до 2 знаков после запятой); строку "bad date: <value>", когда дата не является реальной датой YYYY-MM-DD; и строку "non-positive total: <value>", когда total <= 0. Чистая запись возвращает [].

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.