عن المشروع

هذه بنية تحتية لمحاكاة التداول والبحث الكمي تعطي الأولوية للعمل المحلي وموجهة لقواعد تداول الأسهم الصينية (A-shares). المشروع لا يتصل بشركات الوساطة ولا يتعامل مع أموال حقيقية، ويحتوي المستودع العام فقط على الكود المصدري، وتكوينات الحاويات، والوثائق المجهولة. الفكرة الأساسية هي دمج قواعد الأسهم الصينية مباشرة في مسار المطابقة والتحقق من الطلبات، بدلاً من إجراء تصحيحات تقريبية بعد الاختبار العكسي. يتم إدراج قواعد T+1، واللوتات الكاملة (100 سهم)، وحدود الارتفاع والانخفاض، وتعليق التداول، والعمولات، وضريبة الدمغة، والانزلاق السعري في مرحلة التحقق قبل إرسال الطلب. تعتمد بيانات السوق مبدأ fail-closed، حيث لا يتم تجميع البيانات القديمة أو المفقودة أو غير الكافية لتكوين "سعر لحظي" بصمت، بل يتم رفض التنفيذ المحاكي عند نقص الأدلة. في جانب بيانات السوق، يتم استخدام جلب متعدد المصادر وتحقق مستقل، مع طوابع زمنية ومصادر واضحة للأسعار اللحظية. توجد بوابات تغطية لقطات السوق الكاملة، وفي حال تعطل مصدر البيانات، يتم خفض ثراء الإشارات أو قطع المسار المعني. تتم إدارة المخاطر عبر آلة حالة (state machine) طبقية، حيث تمر كل عملية بيع أو شراء أولاً عبر طبقة مخاطر مستقلة تنتج نتائج هيكلية مثل approved، rejected، deferred_capacity، وdownside_warning. يدعم النظام وقف الخسارة الصارم، ووقف الخسارة المتحرك، وجني الأرباح المتدرج، وتدوير الجودة، وضغط السعة، وحماية التركيز. تعتمد حماية الجانب الهبوطي على آلة حالة لتقليل المراكز تدريجياً وصولاً إلى التصفية الكاملة، مع استخدام علامات مستقرة وسجلات تدقيق لأسباب المخاطر. تتم إدارة الأموال عبر مجمع سيولة مشترك يقوم بتخصيص الميزانيات لكل استراتيجية، بما في ذلك حدود المقاعد، وميزانية السهم الواحد، وحماية العدالة، والحد الأقصى الصارم للأموال. يتم فصل حجز الأموال عن الخصم الفعلي، مع استخدام SQLite savepoint لتجنب التكرار في حجز الأموال أثناء المسح المتزامن. يدعم الجدولة بشكل موحد ستة أنواع من الفتحات (slots): auction، open، risk، intraday، close، وweekly-review. يتم تفعيل المجدول الداخلي (3 دقائق) افتراضياً عند التشغيل بنقرة واحدة، ويمكن إغلاقه في حال وجود مجدول خارجي. تُستخدم عقود التشغيل (leases)، ونبضات القلب (heartbeat)، وfencing token لمنع الطلبات المكررة، والكتابة الشبحية، والتغطية المتزامنة. على مستوى الاستراتيجيات، تم الاحتفاظ بخمس مجموعات كاملة ومدرجة في سجل الاستراتيجيات، وإعادة التشغيل التاريخي، وعرض التدقيق: tq_breakout (الاختراق القوي)، trend_pullback (تراجع الاتجاه)، sector_rotation (تدوير القطاعات)، reported_profit_breakout (اختراق الجودة)، وmain_force_top10 (أموال القوى الرئيسية). تشترك هذه الاستراتيجيات في البنية التحتية للمطابقة، ومجمع الأموال، والمخاطر، والتدقيق، ولكن لكل منها مسارات مرشحة، ومقاعد مراكز، وقواعد خروج خاصة. يوضح المشروع أنه لا يقوم بتوجيه التداول الحقيقي، أو الرافعة المالية، أو البيع على المكشوف، أو تداول T+0 للأسهم العادية. تتحول الإشارات، والمرشحون، وقرارات المخاطر، والطلبات، والتنفيذات، والمراكز، وصافي قيمة الأصول (NAV)، ونتائج المسح لكل جولة إلى أدلة قابلة للتتبع. تحفظ وحدات البحث مثل adaptive_* وnews_learning وneural_shadow وdual_ai_tuner ملاحظات ظل مستقلة دون تجاوز مسار المطابقة الرسمي. قدرات LLM اختيارية، ولا تعتمد المحاكاة الأساسية عليها. يتطلب النشر Python 3.11+، ويوفر ملفات start.ps1/start.bat لويندوز وstart.sh للينكس وماك، مع إمكانية الاختيار التلقائي بين Docker أو الوضع المحلي، وتحديد المنافذ، وفتح المتصفح، وتفعيل المجدول الداخلي. يوفر Docker Compose صور التطبيق ومجلدات مسمى، مع تعيين المنفذ 8600 افتراضياً. ينبه المستودع أن تعيين Compose الحالي يستمع لجميع بطاقات الشبكة، وينصح بتغييره إلى 127.0.0.1 للاستخدام الشخصي، مع الإشارة إلى أن التطبيق لا يحتوي على نظام مصادقة داخلي كامل. للمستخدمين الذين لا يرغبون في ربط بيانات حقيقية، يمكن ضبط ASTOCK_DEMO=1 لحقن بيانات تجريبية اصطناعية بالكامل عند التشغيل الأول دون الحاجة لإنترنت أو مفاتيح API. تتضمن 10 أصول اصطناعية وسجل أحداث كامل يشمل سيناريوهات مثل الشراء الناجح، ورفض البيع في يوم T+1، ورفض الطلب بسبب تسعير قديم، وبيع وقف الخسارة الصارم، والشراء بسعر الحد الأعلى. عملية الحقن هذه متماثلة (idempotent)، ويتم مقارنة المحتوى الهيكلي في CI بايت ببايت عبر golden replay لمنع انحراف السيناريو. يحتوي المستودع على المحرك الرئيسي للمطابقة/المخاطر/التدقيق، ونموذج القراءة للوحة التحكم، وجلب البيانات، ومحرك القرار، وتعريفات الاستراتيجيات، وHTTP API مع مدخل FastAPI/Web، واختبارات تراجع أوفلاين. يعمل CI على Python 3.11/3.12 لإجراء اختبارات التراجع، وفحص Ruff الساكن، والتحقق من اتساق ملفات القفل، وpip-audit، واختبارات Docker. المشروع مرخص بموجب MIT، ويتضمن README إخلاء مسؤولية يؤكد أن المحاكاة والاختبارات العكسية والنتائج التاريخية لا تشكل ضماناً للأرباح المستقبلية أو نصيحة استثمارية.