How shawshank3/big-bull works
BigBull is a full-stack stock-market simulation platform: users register, receive virtual INR funds, browse simulated stock and mutual-fund prices, place trades, and review holdings, wallet activity, and tax outcomes. The React UI talks to an Express API; the market simulation updates prices and streams them to browsers. The README documents MongoDB, Redis, BullMQ, and optional Gemini-backed chat. Relationships for unsampled modules are included only where documented; source excerpts give more specific evidence for several API handlers.
Main entry points: server.js Express API · market.controller.js Market endpoints · portfolio.controller.js Computed holdings · market Market browser
Components 25
Browser application
- App routing
apps/ui/src/app/router.jsx - Auth experience
apps/ui/src/features/auth - Market browser
apps/ui/src/features/market - Portfolio views
apps/ui/src/features/portfolio - Tax center
apps/ui/src/features/tax - Chat interface
apps/ui/src/features/chat
API and identity
- Express API
apps/api/src/server.js - Authentication
apps/api/src/modules/auth/auth.controller.js - User profile
apps/api/src/modules/user/user.controller.js
Trading and portfolio
- Order execution
apps/api/src/modules/transaction/transaction.controller.js - Virtual wallet
apps/api/src/modules/wallet/wallet.controller.js - Computed holdings
apps/api/src/modules/portfolio/portfolio.controller.js
Market simulation
- Market endpoints
apps/api/src/modules/market/market.controller.js - Charts and history
apps/api/src/modules/market/chart.controller.js - Price simulation
apps/api/src/workers/mseWorker.js - Daily price history
apps/api/src/workers/dailyPriceService.js - Live price stream
apps/api/src/modules/market/market.controller.js
Insights and tax
- Tax analysis
apps/api/src/modules/tax/tax.controller.js - AI chat
apps/api/src/modules/chat/chat.controller.js - Market insights
apps/api/src/modules/insights
Other components
- Investor
- MongoDB
- Redis
- BullMQ queue
- Gemini service
Connections 34
- Investor → App routing: uses
README.md - App routing → Auth experience: routes to
apps/ui/src/app/router.jsx - Auth experience → Express API: REST requests
README.md - Market browser → Express API: REST requests
README.md - Portfolio views → Express API: REST requests
README.md - Tax center → Express API: REST requests
README.md - Chat interface → Express API: REST requests
README.md - Express API → Authentication: mounts routes
apps/api/src/server.js - Express API → Market endpoints: mounts routes
apps/api/src/server.js - Express API → Order execution: mounts routes
apps/api/src/server.js - Express API → Virtual wallet: mounts routes
apps/api/src/server.js - Express API → Computed holdings: mounts routes
apps/api/src/server.js - Express API → Tax analysis: mounts routes
apps/api/src/server.js - Express API → AI chat: mounts routes
apps/api/src/server.js - Express API → Market insights: mounts routes
apps/api/src/server.js - Express API → User profile: mounts routes
apps/api/src/server.js - Authentication → Virtual wallet: seeds wallet
apps/api/src/modules/auth/auth.controller.js - Authentication → User profile: loads identity
apps/api/src/modules/auth/auth.controller.js - Market browser → Live price stream: receives prices
README.md - Market endpoints → Live price stream: registers clients
apps/api/src/modules/market/market.controller.js - Price simulation → Live price stream: broadcasts updates
README.md - Daily price history → MongoDB: stores history
apps/api/src/workers/dailyPriceService.js - Price simulation → BullMQ queue: scheduled by
README.md - Price simulation → Redis: caches prices
README.md - Market endpoints → Redis: reads prices
apps/api/src/modules/market/market.controller.js - Market endpoints → Charts and history: serves charts
README.md - Order execution → Computed holdings: records trades
- Order execution → Virtual wallet: updates balance
- Computed holdings → Tax analysis: informs analysis
- AI chat → Gemini service: requests answers
- Tax center → Tax analysis: tax requests
README.md - Market browser → Market endpoints: market requests
README.md - Portfolio views → Computed holdings: portfolio requests
README.md - Chat interface → AI chat: chat requests
README.md