How jack0dev/stocklab works
StockLab is a real-time stock-market trading simulator. Investors use the React client to authenticate, inspect prices and portfolios, and submit orders; backend services manage orders and matching, with results and account updates surfaced to the client. Major capabilities also include conditional orders, news, AI assistance, bot scenarios, wallet/VNPay flows, and an ML prediction service. Source excerpts establish selected matching, portfolio, authentication, stock, and crawler behavior; many other links below are dashed because their implementation was not sampled.
Main entry points: pages Product pages · repository Data repositories · order Order services · MatchingEngine.java Matching engine
Components 26
Web client
- React application
stocklab-frontend/src/App.jsx - Product pages
stocklab-frontend/src/presentation/pages - API client
stocklab-frontend/src/infrastructure/repositories/api.js
Trading and portfolios
- Order services
stocklab-backend/src/main/java/com/stocklab/service/order - Matching engine
stocklab-backend/src/main/java/com/stocklab/infrastructure/engine/MatchingEngine.java - Conditional orders
stocklab-backend/src/main/java/com/stocklab/infrastructure/engine/TriggerEngine.java - Portfolio queries
stocklab-backend/src/main/java/com/stocklab/service/order/PortfolioQueryService.java - Stock data
stocklab-backend/src/main/java/com/stocklab/service/StockService.java - Trading controllers
stocklab-backend/src/main/java/com/stocklab/presentation/controller/OrderController.java
Accounts and money
- Authentication and 2FA
stocklab-backend/src/main/java/com/stocklab/service/user/UserAuthService.java - User security and profile
stocklab-backend/src/main/java/com/stocklab/service/user/UserSecurityService.java - Wallet and payments
stocklab-backend/src/main/java/com/stocklab/service/WalletService.java - VNPay integration
stocklab-backend/src/main/java/com/stocklab/service/VnPayService.java
Insights and automation
- Financial news
stocklab-backend/src/main/java/com/stocklab/service/NewsCrawlerService.java - AI assistant and RAG
stocklab-backend/src/main/java/com/stocklab/service/ai - Trading bot scenarios
stocklab-backend/src/main/java/com/stocklab/service/bot/manipulation - ML prediction API
stocklab-ml/api/main.py - ML features
stocklab-ml/features/feature_engineering.py - Model training
stocklab-ml/models/train.py
Platform infrastructure
- Data repositories
stocklab-backend/src/main/java/com/stocklab/infrastructure/repository - Trading domain
stocklab-backend/src/main/java/com/stocklab/domain/model - Live updates
stocklab-backend/src/main/java/com/stocklab/service/WebSocketService.java
Other components
- Investor
- MySQL
- Redis
- Gemini and Ollama
Connections 33
- Investor → React application: uses
- React application → Product pages: shows
- Product pages → API client: requests data
- API client → Trading controllers: calls REST
- Trading controllers → Order services: delegates
- Order services → Matching engine: submits orders
- Matching engine → Data repositories: reads and saves
stocklab-backend/src/main/java/com/stocklab/infrastructure/engine/MatchingEngine.java - Order services → Data repositories: reads and writes
stocklab-backend/src/main/java/com/stocklab/service/order/OrderManagementService.java - Order services → Trading domain: updates orders
stocklab-backend/src/main/java/com/stocklab/service/order/PortfolioQueryService.java - Conditional orders → Matching engine: dispatches triggered
- Portfolio queries → Data repositories: queries holdings
stocklab-backend/src/main/java/com/stocklab/service/order/PortfolioQueryService.java - Portfolio queries → Trading domain: summarizes holdings
stocklab-backend/src/main/java/com/stocklab/service/order/PortfolioQueryService.java - Trading controllers → Portfolio queries: serves portfolio
- Product pages → Authentication and 2FA: authenticates
- Authentication and 2FA → Data repositories: loads users
stocklab-backend/src/main/java/com/stocklab/service/user/UserAuthService.java - Authentication and 2FA → User security and profile: verifies second factor
- User security and profile → Data repositories: loads accounts
stocklab-backend/src/main/java/com/stocklab/service/user/UserSecurityService.java - Product pages → Wallet and payments: manages balance
- Wallet and payments → VNPay integration: initiates payment
- Product pages → Stock data: views prices
- Stock data → Data repositories: queries stock data
stocklab-backend/src/main/java/com/stocklab/service/StockService.java - Financial news → Data repositories: stores articles
stocklab-backend/src/main/java/com/stocklab/service/NewsCrawlerService.java - Product pages → Financial news: browses news
- Product pages → AI assistant and RAG: asks questions
- AI assistant and RAG → Gemini and Ollama: queries models
- Product pages → Trading bot scenarios: manages campaigns
- ML prediction API → ML features: uses features
- Model training → ML features: builds features
- Stock data → ML prediction API: requests prediction
- Data repositories → MySQL: persists entities
- Order services → Redis: uses order cache
- Matching engine → Live updates: publishes updates
- Live updates → React application: streams events