How stephin-mathew/mern-portfolio-tracker works
This is an AI-assisted crypto and stock portfolio tracker. A signed-in user views a dashboard or analytics, manages wallets and holdings, and can upload a screenshot or JSON for extraction, review, and saving. The client’s App coordinates initial portfolio loading; the Express API routes requests to domain handlers and MongoDB-backed models. Pricing and extraction are distinct service stages. Source excerpts show key orchestration and dependencies; several page, route, and service implementations were not sampled, so uncertain connections are omitted.
Main entry points: index.js Express API · App.jsx App coordinator · extractionPipeline.js Extraction pipeline · prices.js Price routes
Components 31
Portfolio client
- App coordinator
client/src/App.jsx - Authentication state
client/src/context/AuthContext.jsx - Wallet state
client/src/context/WalletContext.jsx - API client
client/src/api/axiosInstance.js - Dashboard
client/src/pages/DashboardPage.jsx - Portfolio analytics
client/src/pages/AnalyticsPage.jsx - Wallet views
client/src/pages/WalletsPage.jsx - Wallet detail
client/src/pages/WalletDetailPage.jsx - Holdings table
client/src/components/HoldingsTable.jsx - Extraction review
client/src/components/ExtractionReviewModal.jsx
API and identity
- Express API
server/src/index.js - Auth middleware
server/src/middleware/auth.js - Auth routes
server/src/routes/auth.js - User store
server/src/models/User.js
Portfolio data
- Holdings routes
server/src/routes/holdings.js - Wallet routes
server/src/routes/wallets.js - Holdings store
server/src/models/Holding.js - Wallet store
server/src/models/Wallet.js
Pricing and extraction
- Price routes
server/src/routes/prices.js - Extraction route
server/src/routes/extract.js - Extraction pipeline
server/src/services/extraction/extractionPipeline.js - Result validation
server/src/services/extraction/validateExtraction.js - Gemini extraction
server/src/services/extraction/geminiExtract.js - OCR extraction
server/src/services/extraction/ocrExtract.js - Groq extraction
server/src/services/extraction/groqExtract.js - OpenRouter extraction
server/src/services/extraction/openrouterExtract.js - Price service
server/src/services/priceService.js - Price cache
server/src/models/PriceCache.js - Price overrides
server/src/models/PriceOverride.js
Other components
- Portfolio user
- MongoDB
Connections 41
- Portfolio user → App coordinator: uses
client/src/App.jsx - App coordinator → Dashboard: routes to
client/src/App.jsx - App coordinator → Portfolio analytics: routes to
client/src/App.jsx - App coordinator → Wallet views: routes to
client/src/App.jsx - App coordinator → Wallet detail: routes to
client/src/App.jsx - App coordinator → API client: fetches holdings and prices
client/src/App.jsx - App coordinator → Wallet state: orchestrates wallet fetch
client/src/context/WalletContext.jsx - Authentication state → API client: provides auth token
client/src/context/AuthContext.jsx - Wallet state → API client: fetches wallets
client/src/context/WalletContext.jsx - Dashboard → Holdings table: renders
client/src/pages/DashboardPage.jsx - Wallet detail → Holdings table: renders
client/src/pages/WalletDetailPage.jsx - Extraction review → API client: fetches review prices
client/src/components/ExtractionReviewModal.jsx - Express API → Auth routes: mounts route
server/src/index.js - Express API → Holdings routes: mounts route
server/src/index.js - Express API → Wallet routes: mounts route
server/src/index.js - Express API → Price routes: mounts route
server/src/index.js - Express API → Extraction route: mounts route
server/src/index.js - Express API → Auth middleware: installs auth middleware
server/src/index.js - Express API → MongoDB: connects
server/src/index.js - Auth routes → Auth middleware: uses
server/src/routes/auth.js - Auth middleware → User store: finds or creates user
server/src/middleware/auth.js - Holdings routes → Holdings store: reads and writes
server/src/routes/holdings.js - Wallet routes → Wallet store: reads and writes
server/src/routes/wallets.js - Wallet routes → Holdings store: queries holdings
server/src/routes/wallets.js - Price routes → Price service: gets quotes
server/src/routes/prices.js - Price routes → Holdings store: reads holdings
server/src/routes/prices.js - Price routes → Price overrides: reads overrides
server/src/routes/prices.js - Extraction route → Auth middleware: authenticates
server/src/routes/extract.js - Extraction route → Extraction pipeline: runs extraction
server/src/routes/extract.js - Extraction pipeline → Gemini extraction: tries vision extraction
server/src/services/extraction/extractionPipeline.js - Extraction pipeline → OCR extraction: runs OCR
server/src/services/extraction/extractionPipeline.js - Extraction pipeline → Groq extraction: tries fallback
server/src/services/extraction/extractionPipeline.js - Extraction pipeline → OpenRouter extraction: tries fallback
server/src/services/extraction/extractionPipeline.js - Extraction pipeline → Result validation: validates results
server/src/services/extraction/extractionPipeline.js - Price service → Price cache: reads and updates
server/src/services/priceService.js - Price service → Price overrides: reads overrides
server/src/services/priceService.js - Express API → Price service: starts price cron
server/src/index.js - Holdings store → MongoDB: persists data
- Wallet store → MongoDB: persists data
- User store → MongoDB: persists data
- Price cache → MongoDB: persists cache