पाठ्यक्रम 250 में से पाठ 221 · प्रोजेक्ट: दस्तावेज़ समझने वाली सेवा
प्रोजेक्ट: दस्तावेज़ समझने वाली सेवा

business नियमों से मिलाएँ

एक record का आकार पूरी तरह सही होकर भी वह ग़लत हो सकता है। line items जुड़कर $118 होते हैं पर बताया total $128 कहता है। तारीख़ 2026-13-40 है। total ऋणात्मक है। schema जाँच इनमें से कुछ नहीं पकड़ेगी -> ये business-नियम उल्लंघन हैं, और इन्हें पकड़ना ही एक खिलौने को उस सेवा से अलग करता है जिस पर एक accounting टीम सचमुच भरोसा करे।

reconcile(record) लिखें -> एक विसंगति स्ट्रिंग की सूची। ख़ाली सूची मतलब record साफ़ मिलता है। विफल होने वाला हर नियम इंसान के पढ़ने लायक एक स्ट्रिंग जोड़ता है। तीन नियम:

  • items का योग total होना चाहिए (एक cent के भीतर)। line_items की हर प्रविष्टि का amount जोड़ें और total से तुलना करें। अगर वे 0.01 से ज़्यादा अलग हैं, तो "total mismatch: items sum to X but total is Y" जोड़ें (संदेश में दोनों 2 दशमलव तक गोल करें)। floats असटीक हैं, इसलिए हमेशा एक छूट के साथ तुलना करें, कभी == नहीं।
  • तारीख़ को parse होना चाहिए एक असली कैलेंडर तारीख़ के रूप में YYYY-MM-DD रूप में। try/except ValueError के अंदर datetime.strptime(record["date"], "%Y-%m-%d") इस्तेमाल करें; विफल होने पर "bad date: <value>" जोड़ें। (strptime महीना 13 जैसी असंभव तारीख़ें आपके लिए अस्वीकार करता है।)
  • total धनात्मक होना चाहिए। अगर total <= 0 है, तो "non-positive total: <value>" जोड़ें।

टेस्ट के लिए क्रम मायने रखता है: पहले योग जाँचें, फिर तारीख़, फिर total का चिह्न, उसी क्रम में जोड़ते हुए ताकि कई नियम तोड़ने वाला record उन्हें अनुमान लगाने लायक ढंग से सूचीबद्ध करे।

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

यह मिलाने वाला क़दम है जो हर invoicing, ख़र्च, और ledger सिस्टम एक पंक्ति लिखने की हिम्मत करने से पहले चलाता है। एक साफ़ record और एक टूटा record मिलाने और विसंगतियों को क़तार में आते देखने के लिए Run दबाएँ।

आपकी बारी

reconcile(record) लिखें जो line_items (हर एक {"desc", "amount"}), total, और date वाले record के लिए विसंगति स्ट्रिंग की सूची लौटाए। इस क्रम में जोड़ें: line items एक cent के भीतर total तक न जुड़ें तो एक "total mismatch: items sum to X but total is Y" स्ट्रिंग (मान 2 दशमलव तक गोल); तारीख़ असली YYYY-MM-DD तारीख़ न हो तो एक "bad date: <value>" स्ट्रिंग; और total <= 0 होने पर एक "non-positive total: <value>" स्ट्रिंग। एक साफ़ record [] लौटाता है।

इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें

यह अभ्यास जल्द खुलेगा

इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।