इस प्रोजेक्ट के बारे में

यह चीनी A-शेयर ट्रेडिंग नियमों के लिए एक स्थानीय-प्रथम सिमुलेशन और मात्रात्मक अनुसंधान बुनियादी ढांचा है। यह प्रोजेक्ट किसी ब्रोकर से नहीं जुड़ता और वास्तविक धन का उपयोग नहीं करता है; सार्वजनिक रिपॉजिटरी में केवल सोर्स कोड, कंटेनर कॉन्फ़िगरेशन और डी-सेंसिटाइज्ड दस्तावेज़ शामिल हैं। इसका मुख्य विचार A-शेयर नियमों को सीधे मिलान (matching) और ऑर्डर सत्यापन पथ में रखना है, न कि बैकटेस्टिंग के बाद अनुमानित सुधार करना। स्टॉक T+1, 100 शेयरों का लॉट, प्राइस लिमिट (涨跌停), सस्पेंशन, कमीशन, स्टैम्प ड्यूटी और स्लिपेज को ऑर्डर से पहले सत्यापित किया जाता है। मार्केट डेटा डिफ़ॉल्ट रूप से 'fail-closed' है, जिसका अर्थ है कि पुराने, गायब या अपर्याप्त कवरेज वाले डेटा को चुपचाप "वास्तविक मूल्य" के रूप में नहीं जोड़ा जाएगा; पर्याप्त सबूत न होने पर सिमुलेशन ट्रेड को अस्वीकार कर दिया जाएगा। मार्केट डेटा पक्ष मल्टी-सोर्स स्क्रैपिंग और स्वतंत्र सत्यापन का उपयोग करता है। वास्तविक समय की कीमतों में स्पष्ट टाइमस्टैम्प और स्रोत होते हैं, और पूरे बाजार के स्नैपशॉट के लिए कवरेज गेट्स निर्धारित हैं। डेटा स्रोत विफल होने पर, सिग्नल की समृद्धि को कम करने या संबंधित पथ को अवरुद्ध करने को प्राथमिकता दी जाती है। जोखिम नियंत्रण (Risk Control) को स्तरित स्टेट मशीन के माध्यम से लागू किया गया है। प्रत्येक खरीद-बिक्री पहले एक स्वतंत्र जोखिम परत से गुजरती है और संरचनात्मक परिणाम जैसे approved, rejected, deferred_capacity, downside_warning आदि उत्पन्न करती है। यह हार्ड स्टॉप-लॉस, ट्रेलिंग स्टॉप-लॉस, स्टेप-वाइज प्रॉफिट टेकिंग, क्वालिटी रोटेशन, क्षमता संपीड़न और कंसंट्रेशन गार्ड का समर्थन करता है। डाउनसाइड प्रोटेक्शन के लिए आंशिक कटौती से लेकर पूर्ण निकासी तक की स्टेट मशीन का उपयोग किया जाता है, और जोखिम कारणों को स्थिर टैग और ऑडिट लेजर के माध्यम से ट्रैक किया जाता है। फंडिंग पक्ष में एक साझा फंड पूल है जो रणनीतियों के आधार पर बजट एट्रिब्यूशन करता है, जिसमें सीट सीमा, सिंगल-स्टॉक बजट, निष्पक्षता सुरक्षा और फंड की हार्ड लिमिट शामिल है। फंड रिजर्वेशन और वास्तविक कटौती को अलग रखा गया है, और समवर्ती स्कैनिंग के दौरान दोहराव से बचने के लिए SQLite savepoint का उपयोग किया जाता है। शेड्यूलिंग auction, open, risk, intraday, close, weekly-review छह प्रकार के स्लॉट का समर्थन करती है। एक-क्लिक स्टार्टअप डिफ़ॉल्ट रूप से अंतर्निहित 3-मिनट इंट्राडे शेड्यूलर को सक्षम करता है, जिसे बाहरी शेड्यूलर होने पर बंद किया जा सकता है। रनटाइम लीज, heartbeat और fencing token का उपयोग डुप्लिकेट ऑर्डर, ज़ोंबी राइटर्स और समवर्ती ओवरराइटिंग को रोकने के लिए किया जाता है। रणनीति स्तर पर, पांच सेटों को पूरी तरह से बनाए रखा गया है और उन्हें रणनीति रजिस्ट्री, ऐतिहासिक रिप्ले और ऑडिट प्रदर्शन में एकीकृत किया गया है: tq_breakout (Strong Breakout), trend_pullback (Trend Pullback), sector_rotation (Sector Rotation), reported_profit_breakout (Quality Breakout), और main_force_top10 (Main Force Funds)। वे मिलान, फंड पूल, जोखिम नियंत्रण और ऑडिट बुनियादी ढांचे को साझा करते हैं, लेकिन उनके अपने कैंडिडेट लेन, पोजीशन सीट और एग्जिट नियम होते हैं। प्रोजेक्ट स्पष्ट रूप से लाइव रूटिंग, लीवरेज, शॉर्ट सेलिंग और सामान्य शेयरों के लिए T+0 इंट्राडे टर्नओवर का समर्थन नहीं करता है। सिग्नल, कैंडिडेट, जोखिम निर्णय, ऑर्डर, ट्रेड, होल्डिंग्स, NAV और प्रत्येक राउंड के स्कैन परिणाम ट्रैक करने योग्य साक्ष्य बनाते हैं। adaptive_*, news_learning, neural_shadow, dual_ai_tuner जैसे अनुसंधान मॉड्यूल स्वतंत्र शैडो ऑब्जर्वेशन सहेजते हैं, लेकिन औपचारिक मिलान पथ को बायपास नहीं करते हैं। LLM क्षमताएं वैकल्पिक हैं; बुनियादी सिमुलेशन डिस्क LLM पर निर्भर नहीं है। परिनियोजन के लिए Python 3.11+ की आवश्यकता है। Windows के लिए start.ps1/start.bat और Linux/macOS के लिए start.sh प्रदान किए गए हैं, जो स्वचालित रूप से Docker या स्थानीय मोड चुन सकते हैं। उपयोगकर्ता पोर्ट, ब्राउज़र ओपनिंग और अंतर्निहित शेड्यूलर को कॉन्फ़िगर कर सकते हैं। Docker Compose एप्लिकेशन इमेज और नामित वॉल्यूम प्रदान करता है, जो डिफ़ॉल्ट रूप से पोर्ट 8600 को मैप करता है। रिपॉजिटरी चेतावनी देती है कि वर्तमान Compose मैपिंग सभी नेटवर्क इंटरफेस को सुनती है, इसलिए व्यक्तिगत उपयोग के लिए इसे 127.0.0.1 में बदलने की सलाह दी जाती है, और यह भी बताया गया है कि एप्लिकेशन में अभी तक पूर्ण अंतर्निहित प्रमाणीकरण (authentication) नहीं है। उन उपयोगकर्ताओं के लिए जो वास्तविक मार्केट डेटा से नहीं जुड़ना चाहते, ASTOCK_DEMO=1 सेट करने पर स्टार्टअप के समय पूरी तरह से सिंथेटिक डेमो डेटा इंजेक्ट किया जा सकता है। इसके लिए नेटवर्क या API key की आवश्यकता नहीं है। इसमें 10 सिंथेटिक स्टॉक और एक पूर्ण नैरेटिव लेजर शामिल है जिसमें सामान्य खरीद, T+1 बिक्री अस्वीकृति, पुराने कोटेशन के कारण ऑर्डर अस्वीकृति, हार्ड स्टॉप-लॉस बिक्री और लिमिट प्राइस खरीद जैसे परिदृश्य शामिल हैं। यह इंजेक्शन इडेम्पोटेंट है, और इसकी संरचनात्मक सामग्री को CI में 'golden replay' के माध्यम से बाइट-बाय-बाइट तुलना द्वारा सत्यापित किया जाता है ताकि नैरेटिव ड्रिफ्ट को रोका जा सके। रिपॉजिटरी में बैकएंड मिलान/जोखिम/ऑडिट मुख्य इंजन, डैशबोर्ड रीड मॉडल, मार्केट डेटा स्क्रैपिंग, निर्णय इंजन, रणनीति परिभाषाएं, HTTP API और FastAPI/Web डैशबोर्ड प्रवेश द्वार, साथ ही ऑफलाइन रिग्रेशन टेस्ट शामिल हैं। CI Python 3.11/3.12 पर रिग्रेशन, Ruff स्टेटिक चेक, लॉक फाइल कंसिस्टेंसी चेक, pip-audit और Docker स्मोक टेस्ट चलाता है। प्रोजेक्ट MIT लाइसेंस का उपयोग करता है। README में जोखिम घोषणा शामिल है, जो इस बात पर जोर देती है कि सिमुलेशन डिस्क, बैकटेस्ट और ऐतिहासिक परिणाम भविष्य के लाभ की गारंटी या निवेश सलाह नहीं हैं।