Chương trình học Bài 221 trên tổng số 250 · Dự án: Dịch vụ Trí tuệ Tài liệu
Dự án: Dịch vụ Trí tuệ Tài liệu

Đối chiếu với Quy tắc Kinh doanh

A có thể có cấu trúc hoàn hảo nhưng vẫn bị wrong. Các mục hàng cộng lại là $118 nhưng tổng số ghi là $128. Ngày là 2026-13-40. Tổng số là số âm. Schema validation sẽ không bắt được bất kỳ lỗi nào trong số này. Chúng là các vi phạm business-rule, và việc bắt được chúng là điều phân biệt một món đồ chơi với một dịch vụ mà đội kế toán thực sự tin tưởng.

Viết reconcile(record) -> một danh sách các chuỗi sai lệch. Một danh sách trống nghĩa là bản ghi khớp hoàn toàn. Mỗi quy tắc bị lỗi sẽ thêm một chuỗi dễ đọc. Ba quy tắc:

  • Các mục phải có tổng bằng (trong khoảng một xu). Tính tổng amount của mọi mục trong line_items và so sánh với total. Nếu chúng khác nhau hơn 0.01, hãy thêm "total mismatch: items sum to X but total is Y" (làm tròn cả hai đến 2 chữ số trong thông báo). Số thực không chính xác, vì vậy luôn so sánh với một mức sai số, đừng bao giờ ==.
  • Ngày tháng phải được phân tích thành một ngày lịch thực tế ở dạng YYYY-MM-DD. Sử dụng datetime.strptime(record["date"], "%Y-%m-%d") bên trong một try/except ValueError; nếu thất bại hãy thêm "bad date: <value>". (strptime từ chối các ngày không hợp lệ như tháng 13 cho bạn.)
  • Tổng số phải là số dương. Nếu total <= 0, hãy thêm "non-positive total: <value>".

Thứ tự rất quan trọng đối với các bài kiểm tra: kiểm tra sum trước, sau đó đến date, rồi đến sign của tổng số, nối thêm theo đúng thứ tự đó để một bản ghi vi phạm nhiều quy tắc sẽ liệt kê chúng một cách có thể dự đoán được.

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

Đây là bước đối soát mà mọi hệ thống hóa đơn, chi phí và sổ cái đều chạy trước khi dám ghi một dòng dữ liệu. Nhấn Run để đối soát một bản ghi sạch và một bản ghi lỗi rồi xem các điểm khác biệt khớp nhau như thế nào.

Đến lượt bạn

Viết reconcile(record) trả về một danh sách các chuỗi sai lệch cho một bản ghi với line_items (mỗi {"desc", "amount"}), total, và date. Thêm vào, theo thứ tự này: một chuỗi "total mismatch: items sum to X but total is Y" khi các mục dòng không cộng tổng bằng total trong phạm vi một xu (giá trị làm tròn đến 2 chữ số thập phân); một chuỗi "bad date: <value>" khi ngày không phải là ngày YYYY-MM-DD hợp lệ; và một chuỗi "non-positive total: <value>" khi total <= 0. Một bản ghi sạch trả về [].

Bạn thấy vấn đề gì trong bài học này? Hãy báo cáo nó · Hỏi về bài học này

Bài tập này sẽ sớm mở.

Hoàn thành bài học trước đó để mở khóa bài này. Toàn bộ khóa học là miễn phí, không cần tài khoản, và bạn có thể đọc bài học này ngay bây giờ.