How hus-king/finpulse works
FinPulse is a stock-news research platform: users browse or search stocks, collect historical prices and news, review cleaned materials and AI analysis, and explore community sentiment and briefings. The React interface calls a FastAPI backend; the research service coordinates data collection, cleaning, analysis, and persistence. Authentication, account-scoped watchlists, administration, and scheduled briefings are supporting capabilities. Some backend modules are unsampled, so edges for those are included only where the README or source index supports the relationship.
Main entry points: research.py Research service · App.tsx Main dashboard · app.py FastAPI application · api.ts API client
Components 26
Web interface
- Main dashboard
src/App.tsx - Research dashboard
src/ResearchDashboard.tsx - Stock search
src/StockSearch.tsx - Price chart
src/PriceChart.tsx - Community card
src/CommunityCard.tsx - Briefing panel
src/BriefingPanel.tsx - Admin panel
src/AdminPanel.tsx - Authentication context
src/AuthContext.tsx - API client
src/api.ts
API and access
- FastAPI application
backend/app.py - Authentication
backend/auth.py - Research routes
backend/research_api.py
Research pipeline
- Research service
backend/research.py - Live data providers
backend/providers.py - News cleaning
backend/news_cleaning.py - Analysis prompts
backend/prompts.py - Chat-completions model
Data and insights
- Stock catalog
backend/stock_catalog.py - Community analysis
backend/community.py - Recommendation ranking
backend/recommendations.py - Research records
backend/research_store.py - Account storage
backend/database.py
Briefings
- Morning scheduler
backend/morning.py - Briefing builder
backend/briefing.py - Email / PushPlus
Other components
- Investor
Connections 31
- Investor → Main dashboard: uses
README.md - Main dashboard → Research dashboard: renders
src/App.tsx - Main dashboard → Stock search: opens
src/App.tsx - Main dashboard → Briefing panel: shows
src/App.tsx - Main dashboard → Admin panel: shows
src/App.tsx - Main dashboard → Authentication context: uses
src/App.tsx - Research dashboard → Price chart: renders
src/ResearchDashboard.tsx - Research dashboard → Community card: renders
src/ResearchDashboard.tsx - Main dashboard → API client: requests data
src/App.tsx - Authentication context → API client: manages session
src/AuthContext.tsx - Briefing panel → API client: requests briefings
src/BriefingPanel.tsx - Stock search → API client: searches stocks
src/StockSearch.tsx - API client → FastAPI application: HTTP requests
README.md - FastAPI application → Authentication: registers routes
backend/app.py - FastAPI application → Research routes: registers routes
backend/app.py - FastAPI application → Research service: initializes
backend/app.py - Authentication → Account storage: stores accounts
backend/database.py - Research routes → Research service: dispatches research
backend/research_api.py - Research service → Live data providers: fetches data
backend/research.py - Live data providers → News cleaning: normalizes sources
backend/providers.py - Research service → News cleaning: cleans news
backend/research.py - Research service → Analysis prompts: builds analysis
backend/research.py - Research service → Chat-completions model: requests analysis
- Research service → Research records: persists results
backend/research.py - Research service → Stock catalog: resolves stocks
backend/research.py - Research service → Community analysis: collects sentiment
backend/research.py - Research service → Recommendation ranking: ranks stocks
backend/recommendations.py - FastAPI application → Morning scheduler: starts scheduler
backend/app.py - Morning scheduler → Briefing builder: builds daily report
backend/morning.py - Briefing builder → Recommendation ranking: orders candidates
backend/briefing.py - Morning scheduler → Email / PushPlus: sends results
README.md