How mqdd27/idx-stocks-dashboard works
Stocks Dashboard IDX is a web and desktop workstation for IDX market research and paper-trading simulations, not a broker. Its main workflow collects market data into a local or web database, serves research and simulation features through FastAPI, and presents them in the Next.js dashboard; desktop users access a dashboard through a Tauri shell. The README documents distinct news, foreign-flow, broker-activity, screening, performance, AI, and operations capabilities. Sampled source confirms selected API, collector, AI, risk, watchlist, and desktop paths; links for unsampled feature wiring are omitted.
Main entry points: db.py Market Database · main.py FastAPI · recommendation_routes.py Recommendation API · page.tsx Next.js Dashboard
Components 27
Market Data
- Daily Sync
collector/daily_sync.py - Intraday Data
collector/intraday.py - News Collector
collector/news.py - Foreign Flow
backend/app/foreign_flow_service.py - Broker Activity
backend/app/broker_activity_routes.py
Research API
- Market Database
backend/app/db.py - FastAPI
backend/app/main.py - Market Calendar
backend/app/market_calendar.py - Market Analytics
backend/app/analytics.py - Fundamental Screener
backend/app/main.py - Telegram Delivery
backend/app/telegram_delivery_model.py
Paper Trading
- Recommendations
backend/app/recommendation_service.py - Recommendation API
backend/app/recommendation_routes.py - AI Trading
backend/app/ai_trading.py - AI Watchlist
backend/app/watchlist_service.py - AI Auto Trade
backend/app/ai_auto_trade.py - Paper Trading
backend/app/paper_trading.py - Risk Decisions
backend/app/risk_service.py - Performance
backend/app/performance_service.py
Workstation UI
- Next.js Dashboard
frontend/app/page.tsx - API Client
frontend/lib/api.ts
Desktop Access
- Desktop UI
desktop/ui/app.js - Tauri Shell
desktop/src-tauri/lib.rs
Other components
- Investor
- Yahoo, RSS, IDX
- AI Provider
backend/app/ai_provider.py - Telegram
Connections 29
- Yahoo, RSS, IDX → Daily Sync: provides prices
- Yahoo, RSS, IDX → Intraday Data: provides quotes
- Yahoo, RSS, IDX → News Collector: provides news
- Yahoo, RSS, IDX → Foreign Flow: provides EOD flow
- Daily Sync → Market Database: writes market data
- Intraday Data → Market Database: writes prices
- News Collector → Market Database: writes news
- Foreign Flow → Market Database: stores flow
- Broker Activity → Market Database: reads activity
- Investor → Next.js Dashboard: uses
- Next.js Dashboard → API Client: requests data
- API Client → FastAPI: calls API
- FastAPI → Market Database: reads and writes
- FastAPI → Market Analytics: computes market views
- FastAPI → Market Calendar: checks sessions
- FastAPI → Fundamental Screener: serves screening
- Recommendation API → Recommendations: generates picks
- Recommendation API → Market Database: reads recommendations
- Recommendation API → Market Calendar: checks market status
- AI Watchlist → Market Database: stores candidates
- AI Auto Trade → Paper Trading: executes simulation
- Paper Trading → Market Database: records trades
- Risk Decisions → Market Database: stores decisions
- Performance → Market Database: reads trade history
- AI Trading → AI Provider: requests analysis
- Telegram Delivery → Telegram: delivers reports
- Investor → Desktop UI: launches
- Desktop UI → Tauri Shell: invokes commands
- Tauri Shell → Next.js Dashboard: proxies dashboard