How sairajagawane/stock-portfolio-management-system works
This is a stock-portfolio web application: users authenticate, browse a stock catalog and price history, manage watchlists, record buys and sells, and review portfolio reports; administrators oversee users and activity and can trigger market refreshes. The React app calls an Express API, whose route handlers use Prisma for persistence. Market prices are refreshed on a schedule or by an admin. The source excerpts establish the main route and service links; watchlist implementation details are limited to the SOURCE INDEX.
Main entry points: server.ts HTTP server · prisma.ts Database access · auth.ts Authentication · marketData.ts Market refresh
Components 17
Web application
- Portfolio UI
apps/web/src/App.tsx - API client
apps/web/src/api.ts
API and access
- HTTP server
apps/api/src/server.ts - Access middleware
apps/api/src/middleware/auth.ts - Authentication
apps/api/src/routes/auth.ts - Request validation
apps/api/src/validation.ts - Token and passwords
apps/api/src/lib/auth.ts
Portfolio services
- Stock catalog
apps/api/src/routes/catalog.ts - Trades and reports
apps/api/src/routes/portfolio.ts - Watchlists
apps/api/src/routes/watchlist.ts - Admin operations
apps/api/src/routes/admin.ts - Market refresh
apps/api/src/lib/marketData.ts
Data and integrations
- Database access
apps/api/src/lib/prisma.ts - Portfolio database
prisma/schema.prisma
Other components
- User
- Twelve Data
- SMTP mail
Connections 25
- User → Portfolio UI: uses
apps/web/src/App.tsx - Portfolio UI → API client: requests through
apps/web/src/App.tsx - API client → HTTP server: calls API
apps/web/src/api.ts - HTTP server → Authentication: mounts
apps/api/src/server.ts - HTTP server → Stock catalog: mounts
apps/api/src/server.ts - HTTP server → Trades and reports: mounts
apps/api/src/server.ts - HTTP server → Watchlists: mounts
apps/api/src/server.ts - HTTP server → Admin operations: mounts
apps/api/src/server.ts - HTTP server → Access middleware: protects routes
apps/api/src/server.ts - Access middleware → Token and passwords: verifies token
apps/api/src/middleware/auth.ts - Authentication → Token and passwords: hashes and signs
apps/api/src/routes/auth.ts - Authentication → Request validation: validates input
apps/api/src/routes/auth.ts - Stock catalog → Request validation: validates input
apps/api/src/routes/catalog.ts - Trades and reports → Request validation: validates trades
apps/api/src/routes/portfolio.ts - Authentication → Database access: reads and writes
apps/api/src/routes/auth.ts - Stock catalog → Database access: reads and writes
apps/api/src/routes/catalog.ts - Trades and reports → Database access: reads and writes
apps/api/src/routes/portfolio.ts - Watchlists → Database access: reads and writes
apps/api/src/routes/watchlist.ts - Admin operations → Database access: reads records
apps/api/src/routes/admin.ts - Database access → Portfolio database: queries
- HTTP server → Market refresh: starts refresh job
apps/api/src/server.ts - Admin operations → Market refresh: triggers refresh
apps/api/src/routes/admin.ts - Market refresh → Database access: updates prices
apps/api/src/lib/marketData.ts - Market refresh → Twelve Data: fetches prices
apps/api/src/lib/marketData.ts - Authentication → SMTP mail: sends verification mail
apps/api/src/routes/auth.ts