एम्पायर ई.आर.पी. मनोरंजक लेखा: सामान्य खाता बही, खातों, संतुलन

इस लेख में, हम "खूनी उद्यम" के बहुत दिल में घुसने का प्रयास करेंगे - लेखांकन। सबसे पहले, हम सामान्य खाता बही, खातों और बैलेंस शीट का अध्ययन करेंगे, उनके अंतर्निहित गुणों और एल्गोरिदम की पहचान करेंगे। हम पायथन और टेस्ट ड्रिवेन डेवलपमेंट तकनीक का उपयोग करते हैं। यहां हम प्रोटोटाइप में लगे होंगे, इसलिए डेटाबेस के बजाय हम मूल कंटेनरों का उपयोग करेंगे: सूचियां, शब्दकोश और ट्यूपल्स। यह परियोजना एम्पायर ईआरपी परियोजना की आवश्यकताओं के अनुसार विकसित की जा रही है।

टास्क की स्थिति

अंतरिक्ष ... साम्राज्य का ग्रह ... पूरे ग्रह पर एक राज्य। आबादी 2 सप्ताह में 2 घंटे काम करती है, रिटायर होने के 2 साल बाद। खातों के चार्ट में 12 स्थान होते हैं। खाते 1-4 सक्रिय हैं, 5-8 सक्रिय-निष्क्रिय हैं, 9-12 निष्क्रिय हैं। कंपनी सींग और खुर। सभी लेनदेन एक रिपोर्टिंग अवधि में किए जाते हैं, इस अवधि की शुरुआत में कोई संतुलन नहीं होता है।

प्रोजेक्ट सेटअप

हम इस परियोजना को जीथब से क्लोन करते हैं:

git clone https://github.com/nomhoi/empire-erp.git 

हम Python 3.7.4 में विकसित हो रहे हैं। वर्चुअल वातावरण सेट अप करें, इसे सक्रिय करें और पाइस्टेस्ट स्थापित करें ।

 pip install pytest 

1. सामान्य नेतृत्वकर्ता

Reaserch / day1 / step1 फ़ोल्डर पर जाएं।

लेखांकन थिंक :

 DEBIT = 0 CREDIT = 1 AMOUNT = 2 class GeneralLedger(list): def __str__(self): res = '\nGeneral ledger' for e in self: res += '\n {:2} {:2} {:8.2f}'.format(e[DEBIT], e[CREDIT], e[AMOUNT]) res += "\n----------------------" return res 

test_accounting.py

 import pytest from accounting import * from decimal import * @pytest.fixture def ledger(): return GeneralLedger() @pytest.mark.parametrize('entries', [ [(1, 12, 100.00), (1, 11, 100.00)] ]) def test_ledger(ledger, entries): for entry in entries: ledger.append((entry[DEBIT], entry[CREDIT], Decimal(entry[AMOUNT]))) assert len(ledger) == 2 assert ledger[0][DEBIT] == 1 assert ledger[0][CREDIT] == 12 assert ledger[0][AMOUNT] == Decimal(100.00) assert ledger[1][DEBIT] == 1 assert ledger[1][CREDIT] == 11 assert ledger[1][AMOUNT] == Decimal(100.00) print(ledger) 

मुख्य पुस्तक, जैसा कि हम देखते हैं, अभिलेखों की सूची के रूप में प्रस्तुत की जाती है। प्रत्येक प्रविष्टि को एक टपल के रूप में डिज़ाइन किया गया है। लेन-देन के रिकॉर्ड के लिए अब तक हम डेबिट और क्रेडिट के लिए केवल खाता संख्या और लेनदेन की राशि का उपयोग करते हैं। दिनांक, विवरण और अन्य जानकारी की अभी आवश्यकता नहीं है, हम उन्हें बाद में जोड़ देंगे।

लेज़र कुंडी और पैरामीटर किए गए परीक्षण test_ledger परीक्षण फ़ाइल में बनाए गए थे । प्रविष्टियों के परीक्षण पैरामीटर में, हम लेनदेन की पूरी सूची को तुरंत स्थानांतरित कर देते हैं। जाँच करने के लिए, हम टर्मिनल में pytest -s -v कमांड निष्पादित करते हैं। परीक्षण पास होना चाहिए, और हम टर्मिनल में सामान्य खाता बही में संग्रहीत लेनदेन की पूरी सूची देखेंगे:

 General ledger 1 12 100.00 1 11 100.00 

2. लेखा

अब प्रोजेक्ट में इनवॉइस सपोर्ट जोड़ते हैं। फ़ोल्डर day1 / step2 पर जाएं ।

लेखांकन थिंक :

 class GeneralLedger(list): def __init__(self, accounts=None): self.accounts = accounts def append(self, entry): if self.accounts is not None: self.accounts.append_entry(entry) super().append(entry) 

GeneralLedger वर्ग ने एपेंड पद्धति को अधिभारित किया। जब आप किसी पुस्तक में लेन-देन जोड़ते हैं, तो हम उसे तुरंत खातों में जोड़ देते हैं।

लेखांकन थिंक :

 class Account: def __init__(self, id, begin=Decimal(0.00)): self.id = id self.begin = begin self.end = begin self.entries = [] def append(self, id, amount): self.entries.append((id, amount)) self.end += amount class Accounts(dict): def __init__(self): self.range = range(1, 13) for i in self.range: self[i] = Account(i) def append_entry(self, entry): self[entry[DEBIT]].append(entry[CREDIT], Decimal(entry[AMOUNT])) self[entry[CREDIT]].append(entry[DEBIT], Decimal(-entry[AMOUNT])) 

एक लेखा के रूप में डिज़ाइन किया गया है। कुंजियों में, खाता संख्या, खाते की सामग्री के मूल्यों में, अर्थात्। खाता वर्ग का एक उदाहरण, जिसमें बदले में संतुलन क्षेत्र खोलने और बंद करने और इस खाते से संबंधित लेनदेन की एक सूची शामिल है। ध्यान दें कि इस सूची में डेबिट और क्रेडिट लेनदेन की राशि एक क्षेत्र में संग्रहीत की जाती है, डेबिट राशि सकारात्मक है, ऋण राशि नकारात्मक है।

test_accounting.py

 @pytest.fixture def accounts(): return Accounts() @pytest.fixture def ledger(accounts): return GeneralLedger(accounts) 

परीक्षण फ़ाइल में, हमने खातों के लॉक को जोड़ा और लेज़र लॉक को समायोजित किया।

test_accounting.py

 @pytest.mark.parametrize('entries', [ [(1, 12, 100.00), (1, 11, 100.00)] ]) def test_accounts(accounts, ledger, entries): for entry in entries: ledger.append((entry[DEBIT], entry[CREDIT], Decimal(entry[AMOUNT]))) assert len(ledger) == 2 assert ledger[0][DEBIT] == 1 assert ledger[0][CREDIT] == 12 assert ledger[0][AMOUNT] == Decimal(100.00) assert len(accounts) == 12 assert accounts[1].end == Decimal(200.00) assert accounts[11].end == Decimal(-100.00) assert accounts[12].end == Decimal(-100.00) print(ledger) print(accounts) 

एक नया परीक्षण test_accounts जोड़ा गया।

परीक्षण चलाएं और आउटपुट देखें:

 General ledger 1 12 100.00 1 11 100.00 ---------------------- Account 1 beg: 0.00 0.00 12: 100.00 0.00 11: 100.00 0.00 end: 200.00 0.00 ---------------------- Account 11 beg: 0.00 0.00 1: 0.00 100.00 end: 0.00 100.00 ---------------------- Account 12 beg: 0.00 0.00 1: 0.00 100.00 end: 0.00 100.00 ---------------------- 

खाता और एटोन्स कक्षाओं में, __str__ विधियां भी अतिभारित हैं, आप परियोजना स्रोतों में देख सकते हैं। बेहतर स्पष्टता के लिए पोस्टिंग और शेष राशि को दो कॉलमों में प्रस्तुत किया गया है: डेबिट और क्रेडिट।

3. लेखा: पोस्टिंग सत्यापन

हम निम्नलिखित नियम को याद करते हैं:

         .         .   -         . 

खाता वर्ग के एक उदाहरण में, सक्रिय खातों पर अंतिम मूल्य (अंतिम शेष) नकारात्मक नहीं हो सकता है, और निष्क्रिय खातों पर यह सकारात्मक नहीं हो सकता है।

फ़ोल्डर day1 / step3 पर जाएं ।

लेखांकन थिंक :

 class BalanceException(Exception): pass 

एक शेष जोड़ें ।

 class Account: ... def is_active(self): return True if self.id < 5 else False def is_passive(self): return True if self.id > 8 else False ... 

खाता सक्रिय है या निष्क्रिय यह निर्धारित करने के लिए खाता वर्ग में एक चेक जोड़ा गया था।

 class Accounts(dict): ... def check_balance(self, entry): if self[entry[CREDIT]].end - Decimal(entry[AMOUNT]) < 0 and self[entry[CREDIT]].is_active(): raise BalanceException('BalanceException') if self[entry[DEBIT]].end + Decimal(entry[AMOUNT]) > 0 and self[entry[DEBIT]].is_passive(): raise BalanceException('BalanceException') ... 

यदि कोई नया लेन-देन जोड़ने के परिणामस्वरूप एक सक्रिय डेबिट मान सक्रिय खाते पर उत्पन्न होता है, तो अपवाद के रूप में, एक खाता खातों के लिए एक चेक जोड़ा गया है, और एक ही बात अगर निष्क्रिय खाते पर नकारात्मक ऋण मान प्राप्त होता है।

 class GeneralLedger(list): ... def append(self, entry): if self.accounts is not None: self.accounts.check_balance(entry) self.accounts.append_entry(entry) super().append(entry) ... 

GeneralLedger वर्ग में , पोस्टिंग को खातों में जोड़ने से पहले, हम एक चेक करते हैं। यदि अपवाद उठाया जाता है, तो पोस्टिंग खातों या सामान्य खाता बही में नहीं आती है।

test_accounting.py

 @pytest.mark.parametrize('entries, exception', [ ([(12, 1, 100.00)], BalanceException('BalanceException')), ([(12, 6, 100.00)], BalanceException('BalanceException')), ([(12, 11, 100.00)], BalanceException('BalanceException')), ([(6, 2, 100.00)], BalanceException('BalanceException')), #([(6, 7, 100.00)], BalanceException('BalanceException')), #([(6, 12, 100.00)], BalanceException('BalanceException')), ([(1, 2, 100.00)], BalanceException('BalanceException')), #([(1, 6, 100.00)], BalanceException('BalanceException')), #([(1, 12, 100.00)], BalanceException('BalanceException')), ]) def test_accounts_balance(accounts, ledger, entries, exception): for entry in entries: try: ledger.append((entry[DEBIT], entry[CREDIT], Decimal(entry[AMOUNT]))) except BalanceException as inst: assert isinstance(inst, type(exception)) assert inst.args == exception.args else: pytest.fail("Expected error but found none") assert len(ledger) == 0 assert len(accounts) == 12 

Test_accounts_balance परीक्षण को परीक्षण मॉड्यूल में जोड़ा गया था। लेनदेन की सूची ने पहले लेनदेन के सभी संभावित संयोजनों को सूचीबद्ध किया और उन सभी लेनदेन की टिप्पणी की जो अपवाद नहीं उठाते हैं। परीक्षण को चलाएं और सुनिश्चित करें कि शेष 5 पोस्टिंग विकल्प एक बैलेंसएक्स अपवाद उठाते हैं ।

4. संतुलन

फ़ोल्डर day1 / step4 पर जाएं ।

लेखांकन थिंक :

 class Balance(list): def __init__(self, accounts): self.accounts = accounts self.suma = Decimal(0.00) self.sump = Decimal(0.00) def create(self): self.suma = Decimal(0.00) self.sump = Decimal(0.00) for i in self.accounts.range: active = self.accounts[i].end if self.accounts[i].end >= 0 else Decimal(0.00) passive = -self.accounts[i].end if self.accounts[i].end < 0 else Decimal(0.00) self.append((active, passive)) self.suma += active self.sump += passive 

संतुलन बनाते समय, हम बस एक तालिका में सभी खातों से शेष राशि एकत्र करते हैं।

test_accounting.py

 @pytest.fixture def balance(accounts): return Balance(accounts) 

एक संतुलन कुंडी बनाएँ।

 @pytest.mark.parametrize('entries', [ [ ( 1, 12, 200.00), # increase active and passive ],[ ( 1, 12, 200.00), # increase active and passive (12, 1, 100.00), # decrease passive and decrease active ],[ ( 1, 12, 300.00), # increase active and passive (12, 1, 100.00), # decrease passive and decrease active ( 2, 1, 100.00), # increase active and decrease active ],[ ( 1, 12, 300.00), # increase active and passive (12, 1, 100.00), # decrease passive and decrease active ( 2, 1, 100.00), # increase active and decrease active (12, 11, 100.00), # decrease passive and increase passive ] ]) def test_balance(accounts, ledger, balance, entries): for entry in entries: ledger.append(entry) balance.create() print(accounts) print(balance) 

हमने test_balance परीक्षण बनाया। सभी संभावित प्रकार के लेनदेन में सूचीबद्ध मानकों की सूची: परिसंपत्ति और देयता में वृद्धि, परिसंपत्ति और देयता में कमी, संपत्ति में वृद्धि और परिसंपत्ति में कमी, देयता में वृद्धि और देयता में कमी। पोस्टिंग के लिए 4 विकल्प जारी किए गए हैं, ताकि आप चरणबद्ध तरीके से आउटपुट देख सकें। अंतिम विकल्प के लिए, आउटपुट निम्नानुसार है:

 General ledger 1 12 300.00 12 1 100.00 2 1 100.00 12 11 100.00 ---------------------- Account 1 beg: 0.00 0.00 12: 300.00 0.00 12: 0.00 100.00 2: 0.00 100.00 end: 100.00 0.00 ---------------------- Account 2 beg: 0.00 0.00 1: 100.00 0.00 end: 100.00 0.00 ---------------------- Account 11 beg: 0.00 0.00 12: 0.00 100.00 end: 0.00 100.00 ---------------------- Account 12 beg: 0.00 0.00 1: 0.00 300.00 1: 100.00 0.00 11: 100.00 0.00 end: 0.00 100.00 ---------------------- Balance 1 : 100.00 0.00 2 : 100.00 0.00 3 : 0.00 0.00 4 : 0.00 0.00 5 : 0.00 0.00 6 : 0.00 0.00 7 : 0.00 0.00 8 : 0.00 0.00 9 : 0.00 0.00 10 : 0.00 0.00 11 : 0.00 100.00 12 : 0.00 100.00 ---------------------- sum: 200.00 200.00 ====================== 

5. उल्टा

अब देखते हैं कि कैसे उलटा प्रदर्शन किया जाता है।

 @pytest.mark.parametrize('entries', [ [ ( 1, 12, 100.00), ( 1, 12,-100.00), ] ]) def test_storno(accounts, ledger, balance, entries): for entry in entries: ledger.append(entry) balance.create() print(ledger) print(accounts) print(balance) 

निष्कर्ष इस प्रकार था:

 General ledger 1 12 100.00 1 12 -100.00 ---------------------- Account 1 beg: 0.00 0.00 12: 100.00 0.00 12: 0.00 100.00 end: 0.00 0.00 ---------------------- Account 12 beg: 0.00 0.00 1: 0.00 100.00 1: 100.00 0.00 end: 0.00 0.00 ---------------------- Balance 1 : 0.00 0.00 2 : 0.00 0.00 3 : 0.00 0.00 4 : 0.00 0.00 5 : 0.00 0.00 6 : 0.00 0.00 7 : 0.00 0.00 8 : 0.00 0.00 9 : 0.00 0.00 10 : 0.00 0.00 11 : 0.00 0.00 12 : 0.00 0.00 ---------------------- sum: 0.00 0.00 ====================== 

सब कुछ सही होने लगता है।

और यदि हम पोस्टिंग के ऐसे सेट का उपयोग करते हैं, तो परीक्षण पास हो जाएगा:

 ( 1, 12, 100.00), (12, 1, 100.00), ( 1, 12,-100.00), 

और अगर ऐसा कोई सेट है, तो पिछली 2 लाइनों को स्थानों पर स्वैप करें, तो हमें एक अपवाद मिलेगा:

 ( 1, 12, 100.00), ( 1, 12,-100.00), (12, 1, 100.00), 

इस प्रकार, इस तरह की त्रुटि को पकड़ने के लिए, लेन-देन सही होने के तुरंत बाद रिवर्सल को रखा जाना चाहिए।

निष्कर्ष

निम्नलिखित लेखों में हम लेखांकन का अध्ययन जारी रखेंगे और आईजीपी के लिए आवश्यकताओं की सूची के अनुसार सिस्टम के विकास के सभी पहलुओं पर विचार करेंगे।