सदस्यताएँ: लेखांकन और एकीकरण
एक सदस्यता एकीकरण को परिभाषित करता है जो प्रदाता वस्तुओं, आंतरिक सेवा अवधियों, धन आंदोलनों, और अधिकार स्थिति को अलग करता है ताकि पुनः प्रयास, प्रोरैशन्स, रद्दीकरण, और मेल-मिलाप ऑडिट योग्य बने रहें।
पैकेज स्थिति: संदर्भ संदर्भ मानव समीक्षा के लिए तैयार। अनुबंध और परीक्षण परिदृश्य पूर्ण हैं, लेकिन यह दावा नहीं किया जाता कि किसी अपनाने वाली कार्यान्वयन ने इन्हें पारित किया है।
निर्णय
सत्यापित प्रदाता घटनाओं से एक आंतरिक सदस्यता प्रक्षेप बनाए रखें, लेकिन धन आंदोलनों और सेवा अधिकार को अलग अपरिवर्तनीय तथ्यों के रूप में रिकॉर्ड करें। प्रदाता स्थिति इनपुट साक्ष्य है, केवल व्यावसायिक खाता नहीं।
दायरा
- ग्राहक मैपिंग, योजना/मूल्य संस्करण, सदस्यता जीवनचक्र, चालान, भुगतान, क्रेडिट/रिफंड, सेवा अवधियाँ, अधिकार, रद्दीकरण, घटना क्रम, और मेल-मिलाप।
- आवर्ती प्रदाता-चालित सदस्यताएँ।
- लेखांकन-केंद्रित पहचान और जीवनचक्र एकीकरण, औपचारिक वित्तीय विवरण नहीं।
इस ब्लॉक के बाहर
- कर/लेखांकन सलाह या सामान्य खाता कार्यान्वयन।
- यह मानना कि केवल प्रदाता सदस्यता स्थिति उत्पाद पहुंच निर्धारित करती है।
अनुबंध
- प्रदाता खाता, ग्राहक, सदस्यता, चालान, भुगतान, रिफंड, और घटना आईडी अलग-अलग आंतरिक इकाइयों से मैप होते हैं।
- योजना और मूल्य संस्करण ऐतिहासिक अवधियों के लिए अपरिवर्तनीय हैं; परिवर्तन नए संदर्भ बनाते हैं।
- एक सेवा अवधि में स्पष्ट प्रारंभ/समाप्ति और अधिकार परिणाम होता है जो प्रदाता वस्तु की परिवर्तनीय वर्तमान स्थिति से स्वतंत्र होता है।
- रद्दीकरण में नवीनीकरण रोकना, अवधि के अंत, और तत्काल समाप्ति को अलग किया जाता है; उपयोगकर्ता-दृश्य तिथियाँ पुष्टि किए गए आंतरिक स्थिति से आती हैं।
- घटनाओं को डुप्लिकेट से मुक्त किया जाता है और प्रदाता वस्तु संस्करण/समय नियमों के साथ लागू किया जाता है; पुरानी घटनाएँ नवीनतम स्वीकृत संक्रमण को उलट नहीं सकतीं।
- मेल-मिलाप चालान, कैप्चर/रिफंड की गई राशि, सदस्यता अवधियाँ, और अधिकारों की तुलना करता है, अंतर को स्वतः मिटाने के बजाय प्रदर्शित करता है।
कार्यान्वयन मार्गदर्शन
- प्रदाता खाता और घटना आईडी द्वारा की गई एक घटना इनबॉक्स और स्वीकृत वस्तु स्थिति/संस्करण के साथ संक्रमण तालिका का उपयोग करें।
- धन राशियाँ पूर्णांक लघु इकाइयों में स्पष्ट मुद्रा और प्रकार के साथ लिखें।
- स्वीकृत सेवा-अवधि तथ्यों से अधिकार कमांड आउटबॉक्स के माध्यम से बनाएं।
- मैनुअल समायोजन को प्रदाता इतिहास में संपादन के बजाय नए तर्कसंगत प्रविष्टियों के रूप में रखें, जिसमें अभिनेता और साक्ष्य हो।
विफलता प्रबंधन और सुरक्षा उपाय
- यदि घटनाएँ क्रम से बाहर आती हैं, तो उन्हें रखें और केवल वर्तमान स्थिति के बाद मान्य संक्रमण लागू करें।
- यदि भुगतान सफल होता है लेकिन अधिकार प्रक्षेप विफल होता है, तो आउटबॉक्स को बिना धन रिकॉर्ड बदले पुनः चलाएं।
- यदि प्रदाता और आंतरिक राशियाँ असहमत हैं, तो मेल-मिलाप मामला खोलें; किसी भी पक्ष को चुपचाप अधिलेखित न करें।
सत्यापन और संचालन
- घटना विलंब/डुप्लिकेट/पुराना क्रम, चालान-से-भुगतान असंगति, बिना अधिकार के भुगतान, समर्थित अवधि के बिना अधिकार, रद्दीकरण समय, रिफंड, और मेल-मिलाप आयु को मापें।
- दैनिक धन और सेवा-अवधि मेल-मिलाप चलाएं साथ ही मूल्य निर्धारण परिवर्तनों के बाद लक्षित जांचें।
- मैनुअल समायोजन क्षमता को प्रतिबंधित और ऑडिट करें।
इस पैकेज में निष्पादन-समान उदाहरण फिक्स्चर और स्वीकृति अनुबंध हैं। पैकेज संरचना और मेटाडेटा जांचने के लिए संग्रह रूट से python tools/validate.py चलाएं; फिर लक्षित रिपॉजिटरी में परिदृश्यों को लागू और निष्पादित करें।
अपनाने की धारणाएँ
example.yamlमें नाम और संख्यात्मक मान एक अपनाने की प्रोफ़ाइल हैं, सार्वभौमिक डिफ़ॉल्ट नहीं।- अपनाने वाली टीम को अपने सिस्टम के लिए अभिनेता, डेटा वर्ग, त्रुटि शब्दावली, और स्वामित्व मैप करना होगा।