প্রকল্প সম্পর্কে

Sellside Research Engine হলো একটি ওপেন-সোর্স পাইথন পাইপলাইন এবং স্ট্যাটিক ওয়েব ড্যাশবোর্ড, যা একটি মূল ইকুইটি রিসার্চ লুপ স্বয়ংক্রিয় করে। এটি SEC EDGAR XBRL থেকে অডিটেড ফান্ডামেন্টাল, Yahoo Finance (yfinance-এর মাধ্যমে) থেকে দাম ও কনসেনসাস এস্টিমেট, FRED থেকে ২-বছরের ট্রেজারি এবং ECB থেকে EUR/USD সংগ্রহ করে, তারপর ২১টি মার্কিন স্টক স্ক্রিন করে এবং শীর্ষ ১০টি মূল্যায়ন করে। কোনো API কী প্রয়োজন হয় না। কভারেজ ও আউটপুট - ইউনিভার্স: ৮টি সেক্টর জুড়ে ২১টি মার্কিন স্টক, trg_workbench/config.py-তে DEFAULT_US_TICKERS দিয়ে কনফিগারযোগ্য। ড্যাশবোর্ড রিসার্চ স্কোর অনুযায়ী শীর্ষ ১০টি দেখায়, প্রতিটি রিফ্রেশে পুনরায় র‍্যাঙ্ক করা হয়; comps, ফ্যাক্টর হিটম্যাপ ও স্ক্যাটার সব ২১টি কভার করে। - ভ্যালুয়েশন: bear/base/bull FCF DCF, ৫-বছরের ফেডিং ফোরকাস্ট ও Gordon টার্মিনাল ভ্যালুসহ, রিভার্স DCF (বর্তমান দাম যে প্রবৃদ্ধি ইঙ্গিত করে), ব্যাংক, ব্রোকার ও বীমাকারীদের জন্য রেসিডুয়াল ইনকাম ও justified P/B, রেঞ্জের একটি ফুটবল ফিল্ড, এবং পিয়ার মাল্টিপল। - ঝুঁকি: ঐতিহাসিক VaR ও CVaR (৯৫%, ১ দিন), ২১D/৬৩D ভোলাটিলিটি, S&P 500-এর বিপরীতে বিটা, Sharpe, Sortino, সর্বোচ্চ ড্রডাউন এবং একটি কোরিলেশন ম্যাট্রিক্স। - সেন্টিমেন্ট ও পজিশনিং: EPS রিভিশন, আর্নিংস সারপ্রাইজ, রেকমেন্ডেশন ট্রেন্ড, শর্ট ইন্টারেস্ট ও ইনসাইডার অ্যাক্টিভিটি। - সেক্টর ও ম্যাক্রো: S&P 500-এর বিপরীতে ১০টি SPDR সেক্টর ETF, রোটেশন ভিউ, লাইভ 10Y, 2Y, 3M বিল, VIX, DXY, WTI ও EUR/USD। - আউটপুট: ড্যাশবোর্ডের জন্য dashboard_data.json, একটি HTML রিসার্চ নোট (নেভি/গোল্ড টেমপ্লেট), WeasyPrint-এর মাধ্যমে PDF (HTML ফলব্যাকসহ), একটি Markdown নোট এবং ১৫০ 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 ওয়ার্কফ্লো সপ্তাহের কর্মদিবসে ২২:০০ UTC-তে চলে, JSON শুধু পরিবর্তিত হলে কমিট করে, এবং Vercel Git ইন্টিগ্রেশন প্রতিটি পুশে পুনরায় ডিপ্লয় করে। একটি দুই-ধাপের বিল্ড (fetch-all তারপর export_dashboard_data.py --skip-fetch)ও সমর্থিত। পদ্ধতিগত নোট - FCF প্রক্সি = SEC নেট ইনকাম (Yahoo ফলব্যাক) x ০.৮০; WACC একটি CAPM বিল্ড ব্যবহার করে, Blume-সমন্বিত বিটা ও নির্দিষ্ট D/E ০.৩০সহ; রিস্ক-ফ্রি রেট হলো লাইভ 10Y ট্রেজারি, ৫.৩% ফলব্যাকসহ। - প্রবৃদ্ধি ডিফল্টভাবে কনসেনসাস +১y রেভিনিউ গ্রোথ, ট্রেইলিং গ্রোথ ফলব্যাক, কোনোটিই না থাকলে ৫%, -২০% থেকে ৫০%-এ ক্ল্যাম্প করা। - রেটিং কনসেনসাস টার্গেট আপসাইড থেকে যান্ত্রিক: +১০%-এর উপরে BUY, -১০%-এর নিচে 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 ইন্টেলিজেন্স, Monte Carlo DCF, ঐতিহাসিক মাল্টিপল ব্যান্ড, Piotroski ও Altman স্কোর, টিয়ারশিট, PowerPoint এক্সপোর্ট, Docker ও pytest CI।