How tduic/macro-dashboard works
Macro Desk is a local macro-markets dashboard. Its main workflow fetches market and economic indicators, presents them as cards or a heatmap, and opens historical charts with comparisons and event overlays. Separate branches provide news, release-calendar and yield-curve views, plus mover and regime summaries. The API coordinates the data services and the frontend consumes its routes. Relationships shown here are supported by the README or excerpts and SOURCE INDEX references; unsampled implementations are represented only where their documented capability and path are clear.
Main entry points: App.tsx Dashboard shell · main.py FastAPI routes · api.ts API client · fred.py FRED data
Components 21
Dashboard UI
- Dashboard shell
frontend/src/App.tsx - API client
frontend/src/api.ts - Indicator cards
frontend/src/components/IndicatorCard.tsx - Performance heatmap
frontend/src/components/HeatmapGrid.tsx
API and data
- FastAPI routes
backend/main.py - Market data
backend/data/market.py - FRED data
backend/data/fred.py - News aggregation
backend/data/news.py - Curve snapshots
backend/data/curves.py - Macro events
backend/data/events.py - TTL cache
backend/cache.py
Market summaries
- Mover summary
frontend/src/components/DailySummary.tsx - Regime summary
frontend/src/components/RegimeStrip.tsx
News and events
- News feed
frontend/src/components/NewsFeed.tsx - Release calendar
frontend/src/components/CalendarPanel.tsx
Chart analysis
- History charts
frontend/src/components/ChartModal.tsx - Yield curve panel
frontend/src/components/YieldCurvePanel.tsx
Other components
- Dashboard user
- Market data provider
- FRED service
- RSS feeds
Connections 29
- Dashboard user → Dashboard shell: views
README.md - Dashboard shell → API client: requests data
frontend/src/App.tsx - Dashboard shell → Indicator cards: renders
frontend/src/App.tsx - Dashboard shell → Performance heatmap: renders
frontend/src/App.tsx - Dashboard shell → Mover summary: renders
frontend/src/App.tsx - Dashboard shell → Regime summary: renders
frontend/src/App.tsx - Dashboard shell → Release calendar: renders
frontend/src/App.tsx - Dashboard shell → News feed: renders
frontend/src/App.tsx - Dashboard shell → History charts: opens
frontend/src/App.tsx - API client → FastAPI routes: calls routes
frontend/src/api.ts - FastAPI routes → Market data: fetches indicators
backend/main.py - FastAPI routes → FRED data: fetches releases
backend/main.py - FastAPI routes → News aggregation: fetches news
backend/main.py - FastAPI routes → Curve snapshots: fetches curve
backend/main.py - FastAPI routes → Macro events: fetches events
backend/main.py - FastAPI routes → TTL cache: clears caches
backend/main.py - Market data → Market data provider: retrieves prices
README.md - FRED data → FRED service: retrieves series
backend/data/fred.py - News aggregation → RSS feeds: reads feeds
README.md - History charts → API client: loads history
frontend/src/components/ChartModal.tsx - History charts → API client: loads events
frontend/src/components/ChartModal.tsx - Yield curve panel → API client: loads snapshots
frontend/src/components/YieldCurvePanel.tsx - News feed → API client: loads news
frontend/src/components/NewsFeed.tsx - Release calendar → API client: loads releases
frontend/src/components/CalendarPanel.tsx - Market data → TTL cache: caches results
backend/cache.py - FRED data → TTL cache: caches results
backend/data/curves.py - News aggregation → TTL cache: caches results
backend/data/news.py - Curve snapshots → FRED data: builds snapshots
backend/data/curves.py - Macro events → FRED data: merges releases
backend/data/events.py