How vedant9912/stocksense-sentiment-analysis works
StockSense is a browser-based financial analytics workstation backed by a Spring Boot API and a FastAPI analysis service. Users authenticate, request ticker sentiment or structured research, and view reports alongside charts and watchlists. The documented sentiment flow fetches headlines and scores them; the agent flow gathers market, news, technical, and sentiment evidence before synthesis. The README documents the UI capabilities and deployment integrations; source excerpts establish key calls, while unsampled routes and tool internals are represented only where documented or indexed.
Main entry points: agent.py Research agent · StockController.java Stock routes · main.py FastAPI routes · UserService.java User service
Components 26
Browser terminal
- Terminal UI
stocksense-backend/src/main/resources/static/js/app.js - Login UI
stocksense-backend/src/main/resources/static/js/auth.js
Spring backend
- Auth routes
stocksense-backend/src/main/java/com/stocksense/controller/AuthController.java - Stock routes
stocksense-backend/src/main/java/com/stocksense/controller/StockController.java - User service
stocksense-backend/src/main/java/com/stocksense/service/UserService.java - JWT security
stocksense-backend/src/main/java/com/stocksense/security/JwtUtil.java - Stock service
stocksense-backend/src/main/java/com/stocksense/service/StockService.java - AI client
stocksense-backend/src/main/java/com/stocksense/service/FastAPIClient.java - API data models
stocksense-backend/src/main/java/com/stocksense/dto
AI services
- FastAPI routes
stocksense-ai-service/app/main.py - Headline scraper
stocksense-ai-service/app/scraper.py - FinBERT engine
stocksense-ai-service/app/model.py - Research agent
stocksense-ai-service/app/agent/agent.py - LLM synthesis
stocksense-ai-service/app/agent/llm.py
Research tools
- Market data tool
stocksense-ai-service/app/tools/market_data.py - Research news
stocksense-ai-service/app/tools/news.py - Agent sentiment
stocksense-ai-service/app/tools/sentiment.py - Technical analysis
stocksense-ai-service/app/tools/technical_analysis.py
Persistence
- Data repositories
stocksense-backend/src/main/java/com/stocksense/repository - User and analysis records
stocksense-backend/src/main/java/com/stocksense/entity
Other components
- User
- MySQL
- RSS feeds
- Hugging Face inference
- Local FinBERT
- TradingView charts
Connections 28
- User → Login UI: signs in
- Login UI → Auth routes: submits credentials
- Auth routes → User service: delegates auth
stocksense-backend/src/main/java/com/stocksense/controller/AuthController.java - User service → Data repositories: uses user repository
stocksense-backend/src/main/java/com/stocksense/service/UserService.java - User service → JWT security: generates token
stocksense-backend/src/main/java/com/stocksense/service/UserService.java - User → Terminal UI: requests analysis
- Terminal UI → Stock routes: calls API
- Terminal UI → TradingView charts: loads charts
- Stock routes → Stock service: delegates requests
stocksense-backend/src/main/java/com/stocksense/controller/StockController.java - Stock routes → User service: resolves user
stocksense-backend/src/main/java/com/stocksense/controller/StockController.java - Stock service → AI client: requests analysis
stocksense-backend/src/main/java/com/stocksense/service/StockService.java - Stock service → Data repositories: reads and writes
stocksense-backend/src/main/java/com/stocksense/service/StockService.java - Data repositories → User and analysis records: persists records
stocksense-backend/src/main/java/com/stocksense/repository/WatchlistRepository.java - User and analysis records → MySQL: stored in
- Stock routes → API data models: accepts and returns
stocksense-backend/src/main/java/com/stocksense/controller/StockController.java - AI client → FastAPI routes: calls endpoints
stocksense-backend/src/main/java/com/stocksense/service/FastAPIClient.java - FastAPI routes → Headline scraper: fetches headlines
stocksense-ai-service/app/main.py - FastAPI routes → FinBERT engine: scores headlines
stocksense-ai-service/app/main.py - Headline scraper → RSS feeds: reads feeds
- FinBERT engine → Hugging Face inference: uses serverless inference
stocksense-ai-service/app/model.py - FinBERT engine → Local FinBERT: runs local weights
- FastAPI routes → Research agent: runs research
stocksense-ai-service/app/main.py - Research agent → Market data tool: executes tool
stocksense-ai-service/app/agent/agent.py - Research agent → Research news: executes tool
stocksense-ai-service/app/agent/agent.py - Research agent → Technical analysis: executes tool
stocksense-ai-service/app/agent/agent.py - Research agent → Agent sentiment: executes tool
stocksense-ai-service/app/agent/agent.py - Agent sentiment → FinBERT engine: scores titles
stocksense-ai-service/app/tools/sentiment.py - Research agent → LLM synthesis: synthesizes evidence
stocksense-ai-service/app/agent/agent.py