التوافق مع قواعد العمل
A ذا شكل صحيح تماما ومع ذلك يكون wrong. مجموع بنود السطر هو $118 لكن الإجمالي المذكور يقول $128. التاريخ هو 2026-13-40. الإجمالي سالب. لن تكتشف عملية التحقق من Schema أيا من هذه العناصر لأنها business-rule انتهاكات، والتقاطها هو ما يميز لعبة عن خدمة قد يثق بها فريق محاسبة فعليا.
اكتب 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يرفض التواريخ المستحيلة مثل الشهر 13 لك.) - يجب أن يكون المجموع موجباً. إذا كان
total <= 0، أضف"non-positive total: <value>".
الترتيب مهم للاختبارات: افحص المجموع (sum) أولاً، ثم التاريخ (date)، ثم الإشارة (sign) للإجمالي، مضيفاً بهذا الترتيب لكي يسرد السجل الذي يخالف عدة قواعد مخالفاته بشكل متوقَّع.
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. السجل السليم يعيد [].
سيفتح هذا التمرين قريبا
أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.
يقوم هذا المتصفح بحظر ملفات تعريف الارتباط لـ learn.floati.life، لذا لا يمكن فتح الدروس التي أنهيتها هنا بالترتيب. اسمح بملفات تعريف الارتباط لهذا الموقع وأعد التحميل.