How aaayu-07/stocksense works
StockSense’s main workflow lets an analyst choose a company and date range, then view price trends, summaries, comparisons, and market movers. The dashboard calls a frontend API client; backend routes delegate stock queries to an analytics service that fetches and processes Yahoo Finance data and caches records in the database. The README also advertises authentication, watchlists, recent activity, and caching, but the sampled implementation only substantiates the stock-data and cache workflow; those other capabilities are represented cautiously. Some frontend-to-backend wiring is documented rather than shown in the sampled source.
Main entry points: App.jsx Route shell · stock_service.py Stock analytics · components Dashboard views · stock_routes.py Stock endpoints
Components 22
Frontend experience
- Route shell
frontend/src/App.jsx - Landing page
frontend/src/pages/HomePage.jsx - Landing components
frontend/src/components/landing - Content pages
frontend/src/pages/ContactPage.jsx - Content shell
frontend/src/components/ContentPageShell.jsx - Analytics dashboard
frontend/src/pages/DashboardPage.jsx - Dashboard views
frontend/src/components - Interactive chart
frontend/src/components/StockChart.jsx - Brand mark
frontend/src/components/BrandMark.jsx - Theme toggle
frontend/src/components/ThemeToggle.jsx - API client
frontend/src/services/api.js
Stock API
- Stock endpoints
backend/routes/stock_routes.py - FastAPI application
backend/main.py - JWT authentication
backend/routes
Data and analytics
- Stock analytics
backend/services/stock_service.py
Persistence and preferences
- Theme state
frontend/src/context/ThemeContext.jsx - Database sessions
backend/database.py - Stock records
backend/models.py - SQLite store
backend/data/stocksense.db - Watchlist and activity
backend
Other components
- Analyst
- Yahoo Finance
Connections 24
- Analyst → Route shell: uses
README.md - Route shell → Landing page: routes to
frontend/src/App.jsx - Route shell → Analytics dashboard: routes to
frontend/src/App.jsx - Route shell → Content pages: routes to
frontend/src/App.jsx - Landing page → Landing components: renders
frontend/src/pages/HomePage.jsx - Content pages → Content shell: renders
frontend/src/pages/ContactPage.jsx - Content shell → Landing components: uses shared navigation
frontend/src/components/ContentPageShell.jsx - Analytics dashboard → Dashboard views: renders
frontend/src/pages/DashboardPage.jsx - Dashboard views → Interactive chart: renders
- Dashboard views → Brand mark: uses
frontend/src/components/dashboard/DashboardNavbar.jsx - Dashboard views → Theme toggle: uses
frontend/src/components/dashboard/DashboardNavbar.jsx - Theme toggle → Theme state: reads and toggles
frontend/src/components/ThemeToggle.jsx - Route shell → Theme state: provides state
frontend/src/main.jsx - Analytics dashboard → API client: requests stock data
frontend/src/pages/DashboardPage.jsx - API client → Stock endpoints: calls endpoints
README.md - FastAPI application → Stock endpoints: registers routes
backend/main.py - Stock endpoints → Stock analytics: delegates queries
backend/routes/stock_routes.py - Stock endpoints → Database sessions: injects session
backend/routes/stock_routes.py - Stock analytics → Yahoo Finance: downloads prices
backend/services/stock_service.py - Stock analytics → Stock records: reads and writes
backend/services/stock_service.py - Stock records → Database sessions: uses ORM base
backend/models.py - Database sessions → SQLite store: connects to
backend/database.py - Stock analytics → JWT authentication: authentication capability
README.md - Stock analytics → Watchlist and activity: tracking capability
README.md