用业务规则对账
一条记录可以形状完美,却仍然是错的。明细项加起来是 $118,但写明的总额是 $128。日期是 2026-13-40。总额是负数。schema 验证一个都抓不到:它们是违反业务规则,而抓住它们,就是把一个玩具和一个会计团队真正会信任的服务区分开来的东西。
写 reconcile(record) -> 一个差异字符串列表。空列表意味着这条记录干净地对上了账。每条失败的规则都添加一个人类可读的字符串。三条规则:
- 明细项之和必须等于总额(误差在一分钱以内)。把
line_items里每一项的amount加起来,和total比较。如果相差超过0.01,就追加"total mismatch: items sum to X but total is Y"(在消息里把两者都四舍五入到 2 位小数)。浮点数不精确,所以总要带着容差比较,永远不要用==。 - 日期必须能解析为
YYYY-MM-DD形式的真实日历日期。在try/except ValueError里使用datetime.strptime(record["date"], "%Y-%m-%d");失败时追加"bad date: <value>"。(strptime会替你拒绝像第 13 个月这样不可能的日期。) - 总额必须为正。如果
total <= 0,就追加"non-positive total: <value>"。
顺序对测试很重要:先检查和,再检查日期,然后检查总额的符号,按这个顺序追加,这样违反了好几条规则的记录会以可预测的方式把它们列出来。
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 相差超过一分钱时,追加一个 "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,然后重新加载。