تشغيل المنصة

المستضيفات الأربعة

البوت بيشتغل لحاله. واللوحة والـ API هم اللي بيلمسهم العميل.

المتطلّبات

‏.NET 10 SDK. وبس — قاعدة البيانات SQLite، بتنعمل عند أول تشغيل.

واتنين بيانات اعتماد إنت اللي بتوفّرهم، وكلاهما فاضي في appsettings.json عن قصد:

خلّيهم برّا المستودع. في التطوير:

# from QuantMarketEngine/src/QuantMarketEngine.TelegramBot
dotnet user-secrets set "AlphaVantage:ApiKey" "YOUR_KEY"
dotnet user-secrets set "Telegram:BotToken"   "YOUR_TOKEN"

وفي الإنتاج، متغيّرات بيئة: AlphaVantage__ApiKey و Telegram__BotToken.

شو لازم تسجّل فيه، وقدّيش بيكلّف

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

بيانات السوق — مطلوبة للأسعار الحيّة

تيليجرام — اختياري

بس إذا بدّك قناة النشر. التوكن مجاني من @BotFather جوّا تيليجرام نفسه، بدقيقة تقريباً. وبدونه المحرّك بيشتغل طبيعي تماماً — بيكتب تقاريره على القرص وعلى الموقع الثابت، وبس ما بينشر على تيليجرام.

التشغيل بلا أي حساب إطلاقاً

CsvFileProvider بيجي مع المستودع ومعه الشموع التاريخية، يعني المحرّك بيشتغل وبيطلّع تقارير وبينقاس من الطرف للطرف بلا تسجيل بأي مكان. وهيك بالضبط انعملت كل دراسات المعايرة بهاد المشروع — وكل وحدة فيهم بتقول «صفر نداءات للمزوّد». استخدمه عشان تقيّم المحرّك قبل ما تسجّل بأي إشي.

الفاتورة الشهرية كاملة

و Stripe ما إله رسم شهري — بياخد نسبة على كل معاملة. والبريد الصادر إله باقات مجانية بمئات الرسائل يومياً، وهاد أكتر بكتير من حاجة استعادة كلمات المرور.

اختيار الأدوات اللي بتغطّيها

اليورو/دولار والذهب والفضة إعداد، مش تصميم. ما في إشي بالتحليل مكتوب لأداة معيّنة — الطبقات بتستقبل شموع ورمزاً، وما بتسأل أبداً شو معنى الرمز.

وين بتعيش القائمة

في قاعدة البيانات، بتنُدار من واجهة الويب — /admin/symbols باللوحة. ضيف أداة، وقّف وحدة، رجّع وحدة؛ والتغيير بيسري بالتشغيلة المجدولة الجاي، بلا إعادة تشغيل وبلا ملف تعدّله.

ومين بيقدر يوصل هديك الصفحة محدَّد بـ Admin:Emails في إعدادات اللوحة. خلّيه فاضي وما حدا بيوصل، وإنت منهم. وهاد مقصود: القائمة الفاضية لو انقرأت «بلا قيود» كانت رح تفتح الصفحة لكل مشترك على نشرة نسيت الإعداد ببساطة.

وTelegram:ActiveSymbols صار بذرة وبس. عند أول تشغيلة على قاعدة فاضية بيصير محتواه هو الصفوف الأولى؛ وبعدها الجدول هو المرجع والإعداد ما بينسأل عنه تاني — يعني إطفاء أداة من المتصفّح ما بيرجّعه تشغيل الخادم الجاي.

والتشغيلة المفردة بتقدر تستهدف أداة وحدة بغضّ النظر عن القائمة:

dotnet run -- report GBPUSD 1D

وتذكّر التكلفة: 4 نداءات لكل رمز لكل تقرير. على حصة 25 باليوم، تلات رموز مريحة وستّة هي السقف.

إضافة أداة بالطريقة الصح

dotnet run -- seedhistory   # full daily history, every active symbol
dotnet run -- backfill      # walk-forward scoring — fills the calibration cards

شو اللي ما بيكون عند أداة جديدة في يومها الأول

سجلّ معايرة. والمحرّك ما بيدّعي سجلاً ما اكتسبه — صفحة المعايرة بتطبع «العيّنة صغيرة» لحد ما يصير في 20 نتيجة مقيَّمة لهاد الرمز، ورقم الثقة بيرجع لقراءة مطلقة بدل رتبة داخل تاريخ لسّه ما عنده إياه. وbackfill بيقصّر هاي المدة بتقييم الماضي بتمريرة وحدة؛ وبعدها السجل بينراكم يومياً.

استخدام مزوّد بيانات مختلف

ما في إشي بيربط هاد المحرّك بـ AlphaVantage. طبقات التحليل ما بتشوف مزوّداً أبداً — بتطلب شموعاً عبر واجهة، والمزوّد بيقعد وراها. وفي تطبيقين موجودين أصلاً، فالنمط مش نظرياً: AlphaVantageProvider عبر HTTP و CsvFileProvider من ملفات على القرص.

شو لازم يوفّره المزوّد

واجهتين، في Domain/Interfaces، صغيرتين عن قصد:

public interface IMarketDataProvider
{
    Task<IReadOnlyList<MarketSnapshot>> FetchAsync(
        string symbol, string timeframe, CancellationToken ct = default);
}

public interface IHistoricalMarketDataProvider
{
    Task<IReadOnlyList<MarketSnapshot>> FetchHistoryAsync(
        string symbol, string timeframe, CancellationToken ct = default);
}

وهم منفصلين عن قصد: الأولى بتجيب بس النافذة الحديثة اللي بيحتاجها التحليل الحيّ، والتانية بترجّع أكبر تاريخ بيعطيه المصدر للاختبار الرجعي. وممكن صنف واحد يطبّق الاتنين، وهاد اللي بيعمله المزوّدان الموجودان.

وMarketSnapshot هو اللي بتتوقّعه — ما فيه إشي بشكل مزوّد معيّن:

التلات خطوات

services.AddScoped<IMarketDataProvider, MyVendorProvider>();
services.AddScoped<IHistoricalMarketDataProvider, MyVendorProvider>();

وهاد كل التغيير. ولا طبقة تحليل، ولا مُصيِّر، ولا تقرير، ولا اختبار بيلمس اسم مزوّد.

إذا عندك بياناتك أنت

CsvFileProvider بيقرأ OHLC من ملفات على القرص أصلاً. فإذا عندك تاريخ بصيغة CSV — من تصدير وسيط، أو من منصة، أو من مزوّد بتدفعله أصلاً — يمكن ما بتحتاج صنفاً جديداً أبداً: أشّر مجلد بيانات الـ CSV على ملفاتك والمحرّك بيشتغل عليها. وهيك بالضبط انعملت كل دراسة معايرة بهاد المشروع.

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

وهاد المستودع رابطهم أصلاً بمسار نسبي:

وهاد بيمشي لما التلاتة يشتغلوا من مجلداتهم على جهاز واحد، وهاد هو ترتيب التطوير. وعلى الخادم، حطّ التلاتة على مسار مطلق واحد — وحدة تخزين بتتشاركها الحاويات، أو مسار على الجهاز:

ConnectionStrings__Quant=Data Source=/data/quant.db

وإذا انتقلت لـ PostgreSQL، مزوّد Npgsql مرجَّع أصلاً.

التشغيل محلياً

تلات طرفيات، أو شغّل اللي بتحتاجه بس.

المحرّك — بيولّد تقرير اليوم لكل رمز نشط:

# from QuantMarketEngine/src/QuantMarketEngine.TelegramBot
dotnet run -- report

اللوحة — الموقع اللي بيسجّل فيه المشترك:

dotnet run --project QuantMarketEngine/src/QuantMarketEngine.Dashboard --urls http://localhost:5199

الـ API — اللي بيناديه X-Api-Key:

dotnet run --project QuantMarketEngine/src/QuantMarketEngine.API --urls http://localhost:5006

افتح http://localhost:5199، اعمل حساباً، وبتنزل على خطة Observer المجانية.

الترحيلات والزرع

على عقدة وحدة ما بتعمل إشي. Database:MigrateOnStartup افتراضيه true، فاللوحة والـ API بيرحّلوا وبيزرعوا عند الإقلاع.

وعلى أكتر من عقدة، طفّيه — وإلا كل نسخة بتتسابق على Migrate() على نفس القاعدة وقت البدء. حطّ Database__MigrateOnStartup=false على العقد وشغّل الـ migrator مرة كخطوة نشر:

dotnet run --project QuantMarketEngine/src/QuantMarketEngine.Migrator

وهو متكرّر بأمان وبتقدر تعيده.

والزرع بيعمل التلات خطط اللي بتُعرض منها صفحة الأسعار — Observer بـ $0، وAnalyst بـ $49 شهرياً، وDesk بـ $79 شهرياً — مع استحقاقاتها. غيّر سعراً في SaasPlanSeeder وبيتوفّق عند الإقلاع الجاي؛ وصفحة الأسعار وفحوص الاستحقاق بيقرأوا نفس الكتالوج، فما بيقدروا يختلفوا.

النشر

أربع ملفات Dockerfile موجودة بالمستودع.

ومستضيفا الويب بيعرضوا /health/live (هل العملية شغّالة) و/health/ready (هل بتوصل لقاعدة البيانات) — أشّر فحوص المنسّق عليهم بالترتيب.

وأبسط نشر هو: شغّل الـ migrator مرة، بعدين اللوحة والـ API والبوت، التلاتة و ConnectionStrings__Quant مؤشّر على وحدة تخزين مشتركة وحدة.

الناقص — بصراحة

اقرأ بعدها