How jiajin182/stock-screener works
Intelligent Stock Screener scans a stock universe, combines price-based phase and momentum analysis with fundamental screening, scores buy/sell opportunities, and produces ranked reports. The main daily path is driven by the optimized scan entry point; position management separately analyzes Robinhood holdings and recommends stop adjustments. The graph preserves documented market-regime, VCP, risk, and delivery capabilities. Some subsystem links are based on README descriptions because their implementation was not sampled.
Main entry points: optimized_batch_processor.py Batch Processor · run_optimized_scan.py Optimized Scan · fundamentals_fetcher.py Quarterly Fundamentals · fetcher.py Price Fetcher
Components 26
Scan Workflow
- Optimized Scan
run_optimized_scan.py - Batch Processor
src/screening/optimized_batch_processor.py - Full-Market Batch
src/screening/batch_processor.py
Market Data
- Stock Universe
src/data/universe_fetcher.py - Price Fetcher
src/data/fetcher.py - Quarterly Fundamentals
src/data/fundamentals_fetcher.py - Git Fundamentals Cache
src/data/git_storage_fetcher.py - Enhanced Fundamentals
src/data/enhanced_fundamentals.py - Stock Database
src/data/storage.py - Data Quality
src/data/quality.py
Analysis Engine
- Phase & VCP Indicators
src/screening/phase_indicators.py - Technical Indicators
src/screening/indicators.py - Signal & Risk Scoring
src/screening/signal_engine.py - Candidate Screener
src/screening/screener.py - Quant Engine
src/screening/quant_engine.py
Position Management
- Position Reports
automated_position_report.py - Position Manager
src/analysis/position_manager.py - Robinhood Positions
src/data/robinhood_positions.py
Reports & Alerts
- Screening Scheduler
src/notifications/scheduler.py - Email Alerts
src/notifications/email_notifier.py - Slack Alerts
src/notifications/slack_notifier.py - Ranked Scan Report
run_optimized_scan.py
Other components
- Investor / Operator
- Market Data Provider
- SMTP Service
- Slack Service
Connections 33
- Investor / Operator → Optimized Scan: runs scan
README.md - Optimized Scan → Stock Universe: loads universe
run_optimized_scan.py - Optimized Scan → Batch Processor: runs batches
run_optimized_scan.py - Batch Processor → Price Fetcher: fetches prices
src/screening/optimized_batch_processor.py - Batch Processor → Quarterly Fundamentals: fetches fundamentals
src/screening/optimized_batch_processor.py - Batch Processor → Git Fundamentals Cache: uses cache
src/screening/optimized_batch_processor.py - Price Fetcher → Market Data Provider: requests prices
- Quarterly Fundamentals → Market Data Provider: requests financials
- Git Fundamentals Cache → Quarterly Fundamentals: refreshes data
src/data/git_storage_fetcher.py - Batch Processor → Phase & VCP Indicators: classifies phases
src/screening/optimized_batch_processor.py - Batch Processor → Enhanced Fundamentals: uses analysis
- Signal & Risk Scoring → Phase & VCP Indicators: uses phase data
src/screening/signal_engine.py - Optimized Scan → Signal & Risk Scoring: scores signals
run_optimized_scan.py - Optimized Scan → Ranked Scan Report: generates report
README.md - Investor / Operator → Position Reports: requests review
README.md - Position Reports → Robinhood Positions: fetches holdings
automated_position_report.py - Position Reports → Position Manager: analyzes positions
automated_position_report.py - Position Manager → Phase & VCP Indicators: uses phase analysis
src/analysis/position_manager.py - Position Manager → Git Fundamentals Cache: reads fundamentals
src/analysis/position_manager.py - Investor / Operator → Screening Scheduler: starts screening
- Screening Scheduler → Email Alerts: sends alerts
src/notifications/scheduler.py - Screening Scheduler → Slack Alerts: sends alerts
src/notifications/scheduler.py - Email Alerts → SMTP Service: sends mail
src/notifications/email_notifier.py - Slack Alerts → Slack Service: posts messages
src/notifications/slack_notifier.py - Full-Market Batch → Price Fetcher: fetches prices
src/screening/batch_processor.py - Full-Market Batch → Quarterly Fundamentals: fetches financials
src/screening/batch_processor.py - Full-Market Batch → Phase & VCP Indicators: classifies phases
src/screening/batch_processor.py - Quant Engine → Price Fetcher: fetches prices
src/screening/quant_engine.py - Quant Engine → Quarterly Fundamentals: fetches financials
src/screening/quant_engine.py - Quant Engine → Signal & Risk Scoring: scores signals
src/screening/quant_engine.py - Candidate Screener → Stock Database: queries data
src/screening/screener.py - Candidate Screener → Technical Indicators: calculates scores
src/screening/screener.py - Data Quality → Stock Database: uses storage
src/data/quality.py