سرفصل‌ها درس 221 از 250 · پروژه: سرویس اطلاعات
پروژه: سرویس اطلاعات

هماهنگ‌سازی با قواعد کسب‌وکار

یک رکورد می‌تواند کاملاً خوش‌شکل باشد و با این حال اشتباه باشد. آیتم‌های خطی جمعاً ۱۱۸ دلار می‌شوند اما مجموع اعلام‌شده ۱۲۸ دلار است. تاریخ است 2026-13-40. مجموع منفی است. اعتبارسنجی اسکیما هیچ‌یک از این موارد را شناسایی نخواهد کرد -> این‌ها نقض قواعد کسب‌وکار هستند و شناسایی آن‌ها چیزی است که یک ابزار اسباب‌بازی را از خدماتی که یک تیم حسابداری واقعاً به آن اعتماد می‌کند، متمایز می‌سازد.

نوشتن reconcile(record) -> فهرستی از رشته‌های اختلاف. یک فهرست خالی به این معنی است که رکورد به‌خوبی تطبیق داده شده است. هر قاعده‌ای که شکست بخورد، یک رشته قابل خواندن توسط انسان اضافه می‌کند. سه قاعده:

  • موارد باید جمع شوند و به مبلغ کل برسند (با اختلاف یک سنت). جمع کنید amount هر رکورد در line_items و مقایسه با total. اگر بیش از 0.01، اضافه کنید "total mismatch: items sum to X but total is Y" (هر دو را در پیام تا دو رقم اعشار گرد کنید). اعداد اعشاری دقیق نیستند، بنابراین همیشه با یک تلرانس مقایسه کنید، هرگز ==.
  • تاریخ باید به‌عنوان یک تاریخ واقعی تقویمی در YYYY-MM-DD شکل. استفاده کنید datetime.strptime(record["date"], "%Y-%m-%d") درون یک try/except ValueError; در صورت خطا اضافه کنید "bad date: <value>". (strptime تاریخ‌های غیرممکن مانند ماه سیزدهم را برای شما رد می‌کند.)
  • مجموع باید مثبت باشد. اگر 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 mismatch: items sum to X but total is Y" زنجیرهٔ متنی وقتی که اقلام خطی جمع نمی‌شوند به total در یک سنت (اعداد تا دو رقم اعشار گرد شده‌اند)؛ یک "bad date: <value>" زنجیرهٔ متنی وقتی تاریخ واقعی نیست YYYY-MM-DD تاریخ؛ و یک "non-positive total: <value>" زنجیرهٔ متنی وقتی total <= 0. یک رکورد تمیز برمی‌گردد [].

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.