منصوبے کے بارے میں

سیل سائیڈ ریسرچ انجن ایک اوپن سورس پائتھون پائپ لائن کے ساتھ اسٹیٹک ویب ڈیش بورڈ ہے جو ایکویٹی ریسرچ کے بنیادی چکر کو خودکار بناتا ہے۔ یہ SEC EDGAR XBRL سے آڈٹ شدہ بنیادی اعداد و شمار، Yahoo Finance (yfinance کے ذریعے) سے قیمتیں اور اتفاق رائے کے تخمینے، FRED سے 2 سالہ ٹریژری اور ECB سے EUR/USD حاصل کرتا ہے، پھر 21 امریکی اسٹاکس اسکرین کرتا ہے اور ٹاپ 10 کی ویلیو نکالتا ہے۔ کسی API کلید کی ضرورت نہیں۔ کوریج اور آؤٹ پٹس - یونیورس: 8 شعبوں میں 21 امریکی اسٹاکس، trg_workbench/config.py میں DEFAULT_US_TICKERS کے ذریعے قابل ترتیب۔ ڈیش بورڈ ریسرچ اسکور کے لحاظ سے ٹاپ 10 دکھاتا ہے، ہر ریفریش پر دوبارہ درجہ بندی؛ comps، فیکٹر ہیٹ میپ اور اسکیٹرز تمام 21 کا احاطہ کرتے ہیں۔ - ویلیویشن: بیئر/بیس/بل FCF DCF 5 سالہ فیڈنگ پیش گوئی اور گورڈن ٹرمینل ویلیو کے ساتھ، ریورس DCF (موجودہ قیمت جو ترقی ظاہر کرتی ہے)، بینکوں، بروکرز اور بیمہ کاروں کے لیے ریزیڈیول انکم اور جسٹیفائیڈ P/B، رینجز کا فٹ بال فیلڈ، اور پیر ملٹیپلز۔ - رسک: تاریخی VaR اور CVaR (95%، 1 دن)، 21D/63D اتار چڑھاؤ، S&P 500 کے مقابلے بیٹا، شارپ، سورٹینو، زیادہ سے زیادہ ڈرا ڈاؤن اور ارتباط میٹرکس۔ - جذبات اور پوزیشننگ: EPS نظرثانی، آمدنی کے سرپرائز، سفارش کا رجحان، شارٹ انٹرسٹ اور اندرونی سرگرمی۔ - شعبہ اور میکرو: 10 SPDR سیکٹر ETFs بمقابلہ S&P 500، روٹیشن ویو، لائیو 10Y، 2Y، 3M بل، VIX، DXY، WTI اور EUR/USD۔ - آؤٹ پٹس: ڈیش بورڈ کے لیے dashboard_data.json، ایک HTML ریسرچ نوٹ (نیوی/گولڈ ٹیمپلیٹ)، WeasyPrint کے ذریعے PDF HTML فال بیک کے ساتھ، ایک مارک ڈاؤن نوٹ اور 150 DPI PNG چارٹس۔ یہ کیسے کام کرتا ہے ایک CLI (main_v2.py) fetch-all، build-report اور build-all کو ظاہر کرتا ہے، --dry-run، --quiet اور --formats آپشنز کے ساتھ۔ ڈیٹا data/normalized کے تحت نارملائز کیا جاتا ہے، dashboard_data.json میں ایکسپورٹ کیا جاتا ہے، اور ایک سنگل فائل index.html کے ذریعے رینڈر کیا جاتا ہے جو رن ٹائم پر JSON لوڈ کرتا ہے۔ ایک GitHub Actions ورک فلو ہفتے کے دنوں میں 22:00 UTC پر چلتا ہے، JSON صرف تبدیل ہونے پر کمٹ کرتا ہے، اور Vercel Git انٹیگریشن ہر پش پر دوبارہ ڈیپلائے کرتا ہے۔ دو مرحلوں والا بلڈ (fetch-all پھر export_dashboard_data.py --skip-fetch) بھی سپورٹڈ ہے۔ طریقہ کار کے نوٹس - FCF پراکسی = SEC نیٹ انکم (Yahoo فال بیک) x 0.80؛ WACC ایک CAPM بلڈ استعمال کرتا ہے جس میں بلوم ایڈجسٹڈ بیٹا اور مقررہ D/E 0.30؛ رسک فری ریٹ لائیو 10Y ٹریژری ہے 5.3% فال بیک کے ساتھ۔ - ترقی ڈیفالٹ میں اتفاق رائے +1y ریونیو گروتھ، ٹریلنگ گروتھ فال بیک، 5% جب دونوں نہ ہوں، -20% سے 50% تک محدود۔ - ریٹنگز اتفاق رائے ٹارگٹ اپ سائیڈ سے میکانیکی ہیں: +10% سے اوپر BUY، -10% سے نیچے SELL، ورنہ HOLD۔ - غائب اقدار null کے طور پر لکھی جاتی ہیں اور n/a کے طور پر رینڈر ہوتی ہیں؛ معلوم خلا میں FRED کا Yahoo سے ایک دن پیچھے رہنا اور کبھی کبھار Yahoo کے ایک دن کے خلا شامل ہیں۔ - مینجمنٹ کمنٹری SEC 8-K آمدنی نمائشوں پر کلیدی الفاظ کی ہیورسٹک ہے، LLM نہیں؛ لائیو سائٹ پر n/a دکھاتی ہے کیونکہ CI میں کیشڈ ٹرانسکرپٹس نہیں ہیں۔ سیٹ اپ اور تخصیص کوئیک اسٹارٹ: کلون کریں، pip install -r requirements.txt (Python 3.12)، python export_dashboard_data.py چلائیں، پھر python -m http.server 8000 سے مقامی طور پر سرو کریں۔ SEC API صارفین سے SEC_USER_AGENT کے ذریعے رابطہ تفصیلات مانگتا ہے۔ ایک فورک کے ساتھ Vercel امپورٹ ذاتی کاپی ڈیپلائے کرتا ہے؛ فورکس کو NOTICE فائل رکھنی ہوگی اور اصل ریپوزٹری کو کریڈٹ دینا ہوگا۔ تخصیص کے نکات میں ٹکر یونیورس، build_research_dataset میں فیکٹر وزن، valuation.py میں DCF مفروضے، اور data/analyst_views.csv کے ذریعے تجزیہ کار اوورلیز (صرف v1 رپورٹس) شامل ہیں۔ ایک pytest سوٹ SEC XBRL ایکسٹریکشن، ECB نارملائزیشن، اسکریننگ، DCF ان پٹس اور منظرنامے، ریورس DCF، ریزیڈیول انکم، comps، ریٹرن ونڈوز، TTM/DuPont، جذبات، JSON ایکسپورٹ، کمنٹری ایکسٹریکشن، ٹیمپلیٹس اور چارٹس کا احاطہ کرتا ہے؛ ابھی تک کوئی pytest CI نہیں ہے۔ یہ پروجیکٹ Apache 2.0 کے تحت لائسنس یافتہ ہے اور ایک ریسرچ اور تعلیمی ٹول کے طور پر پیش کیا گیا ہے، نہ کہ سرمایہ کاری مشورہ۔ ایک روڈ میپ میں منصوبہ بند کام درج ہیں جیسے 10-K/10-Q انٹیلیجنس، مونٹی کارلو DCF، تاریخی ملٹیپل بینڈز، Piotroski اور Altman اسکورز، ٹیئر شیٹس، PowerPoint ایکسپورٹ، Docker اور pytest CI۔