课程大纲 第 221 课,共 250 课 · 项目:文档智能服务
项目:文档智能服务

用业务规则对账

一条记录可以形状完美,却仍然是错的。明细项加起来是 $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>" 字符串。干净的记录返回 []。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。