شو بترث فعلاً

شو بينتقل إلك

قاعدة البيانات، وشو بتعني لسجلّ الأداء

سجلّ المعايرة هو أقوى ادعاء بالمنتَج — 264 خرقاً للحدّ في 4,975 قراءة مقيَّمة لليورو/دولار، يعني 5.3% مقابل 5% معلنة، بالإضافة لـ 220 من 3,922 للذهب. وهاد السجل عايش في قاعدة البيانات، مش في الكود.

يعني في قرار لازم ينتّخذ صراحةً بدل ما ينفترض:

ما في جواب غلط هون. في بس جواب لازم ينتّفق عليه. وApiKeys فاضي عند التسليم — أي مفتاح بتصدره بعدها هو بيانات اعتماد آلة تبعك إنت.

إعدادات ما إلها قيمة افتراضية آمنة على بنيتك

المرجع الكامل بيعدّد كل قسم إعدادات بيقراه الكود. وهدول اللي رح يوقّفوك.

الإشي الوحيد اللي بيوقّع الناس

ConnectionStrings__Quant=Data Source=/data/quant.db

سلوكيات بتنقرأ كأخطاء إذا ما حدا حكالك

زر «توليد تقرير» بدّه عمليتين، مش وحدة

اللوحة بتخدم الصفحة وبتحجز الشغل. والعملية اللي بتنفّذه خدمة مستضافة جوّا مستضيف البوت. شغّل اللوحة لحالها وكل طلب بينقبل وبينخزّن وما بينفّذ أبداً.

# both, not one
dotnet run --project QuantMarketEngine/src/QuantMarketEngine.Dashboard --urls http://localhost:5199
dotnet run --project QuantMarketEngine/src/QuantMarketEngine.TelegramBot

والتقرير ما بيظهر لحظة ما تضغط الزر. الصفحة بترجع فوراً وبتقول إن الأداة قيد التحليل. والعامل بياخد المهمة وبيصرف خمس لعشر ثواني. بعدها بتعمل تحديث للصفحة — ما في تحديث حيّ والصفحة ما بتستطلع.

واللي بيضغط الزر وبيبقى يحدّق بجدول ما تغيّر رح يستنتج إنه ما عمل إشي. وهاد أكتر انطباع أول وارد يطلع غلط.

بوابة الموافقة البشرية — الادعاء الدقيق

كل تقرير بينشره المحرّك على جدوله بينتظر إنساناً، والقراءة اللي فحوصها بتقول إنها غير صالحة ما بتنُشر بأي مسار.

ومسار واحد مستثنى عن قصد: التقرير اللي بيطلبه مشترك من صفحة التقارير بينولّد وبينُشر بلا انتظار مشغّل. وهاد قرار مالك، مش سهو — المشترك اللي لازم يستنّى حدا ينتبه ما بيقدر يستخدم الزر. وفحوص ما قبل النشر بتضل تنطبق عليه، فالشمعة القديمة ما بتطلع أبداً على إنها سوق اليوم.

أما التشغيلة المجدولة، والمراقب المدفوع بالأحداث، وزر «Report now» تبع المشغّل — كلهم بيوقفوا عند البوابة.

تصدير الـ PDF بدّه متصفّح على المستضيف

بيطبع عبر Chrome أو Edge بوضع بلا واجهة. وصور Docker ما فيها متصفّح، فالتصدير مطفي في الحاوية الافتراضية لحد ما ينثبّت واحد وينحط PdfExport:BrowserPath. والرابط بيخفي حاله، والنقطة بترد 503، وتصديرات النص والـ JSON ما بتتأثر.

وفي الحاوية ممكن كمان تحتاج PdfExport:NoSandbox=true — صندوق حماية Chrome بدّه صلاحيات نواة الحاوية اللي بتشتغل كـ root عادةً ما بتملكها. وهو مطفي افتراضياً لأن الخيار بيخلّي الميزة تشتغل بكل مكان وبيضعّفها بكل مكان، وهاد قرار المشغّل مش قيمة افتراضية تنورَث.

والـ PDF إنجليزي فقط. العربي بالـ PDF بدّه تخطيطاً ثنائي الاتجاه، والمُصيِّر بيعكس الأرقام داخل نص مختلط عربي/لاتيني. والتقرير العربي بينسلّم كنص بدلاً عن ذلك.

شاشات اللوحة إنجليزية، والمحتوى لأ

تحميلات التقارير على المنصة إنجليزية بالتصميم. والعربي لسّه بينتَج بكل مكان تاني — على القرص، وعلى تيليجرام، وعلى الموقع العام، ومن الـ API بـ ?lang=ar. والعرض بلغتين من محرّك واحد هو أحد ملامح المشتري المستهدف، مش إشي انشال.

سياسة الأمان بتمنع كل JavaScript

script-src 'none' صحيحة اليوم لأن اللوحة Blazor مُصيَّرة على الخادم بلا أي JavaScript. وإضافة @rendermode InteractiveServer لأي مكوّن رح تكسر السياسة لحد ما تتوسّع. وهاد مكتوب في الوسيط ومغطّى باختبار، فبتعرف عند البناء مش في الإنتاج.

الحدود المعروفة، بصراحة

• لا عملاء ولا إيرادات. هاد بيع أصل.
• تكامل الفوترة ما عالج معاملة حقيقية أبداً. Checkout المستضاف عند Stripe، وبوابة الفوترة المستضافة، وwebhook بتحقق توقيع — كلهم مبنيين خلف واجهة مزوّد، وبيانات البطاقة ما بتمرّ على المنصة. والفجوة بطاقة حيّة، مش كود.
• الفضة بتشتغل على المحرّك بس لسّه غير مقيَّمة. تغذيتها ما بتحمل مدى داخل اليوم، فعدة قراءات بتنحجب عن قصد بدل ما تنقدَّر، ومعايرتها لسّه بتقرأ «العيّنة صغيرة». والذهب بيشارك نفس شكل التغذية وبيستقر عند جودة FAIR. وهاد حدّ بيانات مش حدّ محرّك — تاريخ أكتر ما بيحرّكه؛ مزوّد بحركة داخل اليوم هو اللي بيحرّكه.
• مخروط الاحتمالات أضعف سطح، والتقرير بيقول هاد بنفسه. الحافة السفلية لليورو/دولار عند 20 يوم بتسجّل 6.3% مقابل 5%؛ وحواف الذهب العليا أسوأ. أما مخاطرة اليوم الواحد — الرقم الرئيسي — فبتجتاز على الاتنين.
• تلات أقسام بتتشحن معطّلة: التحليل الأساسي، والمشغّل المدفوع بالأحداث، وأجزاء من التقويم الاقتصادي. والتلاتة قيم إعدادات مش كود ناقص. والتقويم حامل حالياً 14 إصداراً لبنوك مركزية وبيانات أمريكية لحد 17 ديسمبر 2026، وبعدها بيسكت لحد ما تنمدّد القائمة.
• 38 من 166 ثابتاً في المحرّك بلا تبرير مكتوب. مفهرَسين على هالأساس، والعدد منشور مش مخفيّ، وولا واحد فيهم بيوصل للصفحة اللي بيشوفها العميل. والـ 128 الباقيين حاملين اشتقاقهم أو قياسهم.

ساعتك الأولى — كيف بتفحص كل هاد بنفسك

ما في إشي فوق بيطلب منك تصدّقه. هاي الأوامر بتشتغل على المستودع اللي بتستلمه.

cd QuantMarketEngine/src/QuantMarketEngine.TelegramBot && python -c "
import sqlite3
c=sqlite3.connect('quant.db')
for s, in c.execute('select distinct Symbol from AnalysisOutcomes order by Symbol'):
    t=c.execute('select count(*) from AnalysisOutcomes where Symbol=?',(s,)).fetchone()[0]
    b=c.execute('select count(*) from AnalysisOutcomes where Symbol=? and VaRBreached=1',(s,)).fetchone()[0]
    if t>=200: print(f'{s}: {b}/{t} = {b/t*100:.1f}%')
"

cd QuantMarketEngine && dotnet test --nologo -v q

git rev-list --count HEAD && git ls-files '*.cs' '*.razor' | xargs wc -l | grep -w total | awk '{s+=$1} END {print s}'

cd QuantMarketEngine && dotnet list package --vulnerable --include-transitive

cd QuantMarketEngine/src/QuantMarketEngine.TelegramBot
dotnet run -- report        # writes 5 files per symbol into reports/
dotnet run -- audit         # the calibration cards — the engine grading itself