रिपॉज़िटरी स्वच्छता
DispatchAtlas का संस्करण-नियंत्रण हस्त-रचित स्रोत, परीक्षण, विन्यास, दस्तावेज़, और पुनरुत्पाद्य मेटाडेटा रखता है। स्थानीय निष्पादन उत्पाद Git के बाहर रहते हैं जब तक कोई नीति उन्हें स्पष्ट रूप से स्रोत में पदोन्नत न करे।
🧹 उत्पन्न आउटपुट नीति
उत्पन्न प्रयोग डेटा, चेकपॉइंट, परिणाम बंडल, कवरेज रिपोर्ट, दस्तावेज़ निर्माण आउटपुट, पैकेज कलाकृतियाँ, और रिलीज़ अभ्यर्थी डिफ़ॉल्ट रूप से अनदेखे रहते हैं। जब परवर्ती गेट उन्हें पदोन्नत करते हैं तब वे स्रोत से पुनर्जनित होते हैं और उद्गम के माध्यम से दर्ज होते हैं।
ट्रैक की गई उत्पन्न फ़ाइलों को चाहिए:
- एक स्रोत स्वामी।
- एक पुनर्जनन कमांड।
- एक धारण तर्काधार।
- बासी आउटपुट के लिए एक समीक्षा पथ।
🗃️ कैश नीति
Python, Ruff, mypy, pytest, कवरेज, दस्तावेज़ निर्माण, और वर्चुअल परिवेशों से स्थानीय कैश अनदेखे रहते हैं। CI निर्भरताएँ कैश कर सकता है, पर कैश कुंजियाँ lockfile व वर्कफ़्लो इनपुट से व्युत्पन्न होनी चाहिए।
🔬 स्थानीय प्रयोग आउटपुट नीति
स्थानीय प्रयोग रन प्रयोग कार्यक्षेत्र की अनदेखी आउटपुट परतों में लिखते हैं — रन परिणाम,
लॉग, चेकपॉइंट, और प्रमाण बंडल, जैसा कार्यक्षेत्र के अपने README में विन्यस्त है — outputs/
या artifacts/ जैसे अन्य अनदेखे स्क्रैच स्थानों के साथ। अंतिम अनुसंधान प्रमाण किसी भी
सार्वजनिक उपयोग से पहले सत्यापित कैंपेन व विश्लेषण कमांडों के माध्यम से उत्पन्न होते हैं।
📋 कलाकृति धारण नियम
| कलाकृति वर्ग | डिफ़ॉल्ट स्थान | Git स्थिति | धारण |
|---|---|---|---|
| पैकेज निर्माण | dist/ | अनदेखा | माँग पर पुनर्निर्माण। |
| दस्तावेज़ निर्माण | site/out/ | अनदेखा | माँग पर पुनर्निर्माण। |
| कवरेज | htmlcov/, .coverage* | अनदेखा | गुणवत्ता जाँचों के दौरान पुनर्निर्माण। |
| स्मोक आउटपुट | outputs/ | अनदेखा | केवल डीबग करते समय स्थानीय रूप से रखें। |
| कैंपेन परिणाम | प्रयोग कार्यक्षेत्र की परिणाम व चेकपॉइंट परतें | अनदेखा | केवल उद्गम-गेटित निर्यातों के माध्यम से पदोन्नत करें। |
| रिलीज़ प्रमाण | artifacts/ | अनुमोदन तक अनदेखा | रिलीज़-अभ्यर्थी नीति द्वारा धारण करें। |