ビジネスルールで突き合わせる
レコードは形が完璧でも、間違っている ことがあります。明細の合計は $118 なのに、記載された合計は $128。日付は 2026-13-40。合計がマイナス。スキーマ検証ではどれも見つけられません -> これらは ビジネスルール の違反で、それを見つけられるかどうかが、おもちゃと、経理チームが本当に信頼するサービスとを分けます。
reconcile(record) を書いてください -> 不一致を表す文字列のリスト を返します。空のリストは、レコードがきれいに突き合わせられたことを意味します。失敗した各ルールが、人が読める文字列をひとつ追加します。ルールは 3 つです:
- 明細の合計が total と一致すること(1 セント以内)。
line_itemsの各要素のamountを合計し、totalと比べます。差が0.01より大きければ"total mismatch: items sum to X but total is Y"を追加します(メッセージ内ではどちらも小数 2 桁に丸めます)。float は不正確なので、必ず許容誤差で比べ、==は決して使いません。 - 日付が
YYYY-MM-DD形式の実在する暦日として解析できること。try/except ValueErrorの中でdatetime.strptime(record["date"], "%Y-%m-%d")を使い、失敗したら"bad date: <value>"を追加します(strptimeは 13 月のようなありえない日付を拒否してくれます)。 - total が正であること。
total <= 0なら"non-positive total: <value>"を追加します。
テストでは順番が大事です。まず 合計、次に 日付、最後に total の 符号 を確認し、その順に追加します。そうすれば、いくつものルールを破るレコードでも、予測できる順で並びます。
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 を押して、きれいなレコードと壊れたレコードを突き合わせ、不一致が並ぶのを見てみましょう。
line_items(それぞれ {"desc", "amount"})、total、date を持つレコードについて、不一致を表す文字列のリストを返す reconcile(record) を書いてください。次の順に追加します。明細が 1 セント以内で total に一致しないときは "total mismatch: items sum to X but total is Y" の文字列(値は小数 2 桁に丸める)、日付が実在する YYYY-MM-DD の日付でないときは "bad date: <value>" の文字列、total <= 0 のときは "non-positive total: <value>" の文字列です。きれいなレコードは [] を返します。
この演習はまもなく開きます
その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。
このブラウザは learn.floati.life の Cookie をブロックしているため、ここで修了したレッスンを順番どおりに開けません。このサイトの Cookie を許可して再読み込みしてください。