# sairajagawane/stock-portfolio-management-system architecture

> Architecture diagram of the GitHub repository sairajagawane/stock-portfolio-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sairajagawane/stock-portfolio-management-system
- Repository: https://github.com/sairajagawane/stock-portfolio-management-system

## Overview

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: [`apps/api/src/server.ts`](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/server.ts) (HTTP server), [`apps/api/src/lib/prisma.ts`](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/lib/prisma.ts) (Database access), [`apps/api/src/routes/auth.ts`](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/auth.ts) (Authentication), [`apps/api/src/lib/marketData.ts`](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/lib/marketData.ts) (Market refresh)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["Portfolio UI<br/>[App.tsx]"]
  node_webclient["API client<br/>[api.ts]"]
end

subgraph group_api["API and access"]
  node_server["HTTP server<br/>[server.ts]"]
  node_middleware["Access middleware<br/>[auth.ts]"]
  node_authroute["Authentication<br/>[auth.ts]"]
  node_validation["Request validation<br/>[validation.ts]"]
  node_authlib["Token and passwords<br/>[auth.ts]"]
end

subgraph group_domain["Portfolio services"]
  node_catalog["Stock catalog<br/>[catalog.ts]"]
  node_portfolio["Trades and reports<br/>[portfolio.ts]"]
  node_watchlist["Watchlists<br/>[watchlist.ts]"]
  node_admin["Admin operations<br/>[admin.ts]"]
  node_marketdata["Market refresh<br/>[marketData.ts]"]
end

subgraph group_data["Data and integrations"]
  node_prisma["Database access<br/>[prisma.ts]"]
  node_database[("Portfolio database<br/>[schema.prisma]")]
end

node_user(("User"))
node_marketprovider["Twelve Data"]
node_mail["SMTP mail"]

node_user -->|"uses"| node_webapp
node_webapp -->|"requests through"| node_webclient
node_webclient -->|"calls API"| node_server
node_server -->|"mounts"| node_authroute
node_server -->|"mounts"| node_catalog
node_server -->|"mounts"| node_portfolio
node_server -->|"mounts"| node_watchlist
node_server -->|"mounts"| node_admin
node_server -->|"protects routes"| node_middleware
node_middleware -->|"verifies token"| node_authlib
node_authroute -->|"hashes and signs"| node_authlib
node_authroute -->|"validates input"| node_validation
node_catalog -->|"validates input"| node_validation
node_portfolio -->|"validates trades"| node_validation
node_authroute -->|"reads and writes"| node_prisma
node_catalog -->|"reads and writes"| node_prisma
node_portfolio -->|"reads and writes"| node_prisma
node_watchlist -->|"reads and writes"| node_prisma
node_admin -->|"reads records"| node_prisma
node_prisma -.->|"queries"| node_database
node_server -->|"starts refresh job"| node_marketdata
node_admin -->|"triggers refresh"| node_marketdata
node_marketdata -->|"updates prices"| node_prisma
node_marketdata -->|"fetches prices"| node_marketprovider
node_authroute -.->|"sends verification mail"| node_mail

click node_webapp "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/web/src/App.tsx"
click node_webclient "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/web/src/api.ts"
click node_server "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/server.ts"
click node_middleware "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/middleware/auth.ts"
click node_authroute "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/auth.ts"
click node_validation "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/validation.ts"
click node_catalog "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/catalog.ts"
click node_portfolio "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/portfolio.ts"
click node_watchlist "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/watchlist.ts"
click node_admin "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/admin.ts"
click node_authlib "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/lib/auth.ts"
click node_marketdata "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/lib/marketData.ts"
click node_prisma "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/lib/prisma.ts"
click node_database "https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/prisma/schema.prisma"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_webclient,node_user toneBlue
class node_server,node_middleware,node_authroute,node_validation,node_authlib toneAmber
class node_catalog,node_portfolio,node_watchlist,node_admin,node_marketdata toneMint
class node_prisma,node_database toneRose
class node_marketprovider,node_mail toneIndigo
```

## Components

### Web application

- [Portfolio UI](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [API client](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/web/src/api.ts): `apps/web/src/api.ts`

### API and access

- [HTTP server](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/server.ts): `apps/api/src/server.ts`
- [Access middleware](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/middleware/auth.ts): `apps/api/src/middleware/auth.ts`
- [Authentication](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/auth.ts): `apps/api/src/routes/auth.ts`
- [Request validation](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/validation.ts): `apps/api/src/validation.ts`
- [Token and passwords](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/lib/auth.ts): `apps/api/src/lib/auth.ts`

### Portfolio services

- [Stock catalog](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/catalog.ts): `apps/api/src/routes/catalog.ts`
- [Trades and reports](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/portfolio.ts): `apps/api/src/routes/portfolio.ts`
- [Watchlists](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/watchlist.ts): `apps/api/src/routes/watchlist.ts`
- [Admin operations](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/routes/admin.ts): `apps/api/src/routes/admin.ts`
- [Market refresh](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/lib/marketData.ts): `apps/api/src/lib/marketData.ts`

### Data and integrations

- [Database access](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/apps/api/src/lib/prisma.ts): `apps/api/src/lib/prisma.ts`
- [Portfolio database](https://github.com/sairajagawane/stock-portfolio-management-system/blob/master/prisma/schema.prisma): `prisma/schema.prisma`

### Other components

- **User**
- **Twelve Data**
- **SMTP mail**

## Connections

- User → Portfolio UI: uses (evidence: `apps/web/src/App.tsx`)
- Portfolio UI → API client: requests through (evidence: `apps/web/src/App.tsx`)
- API client → HTTP server: calls API (evidence: `apps/web/src/api.ts`)
- HTTP server → Authentication: mounts (evidence: `apps/api/src/server.ts`)
- HTTP server → Stock catalog: mounts (evidence: `apps/api/src/server.ts`)
- HTTP server → Trades and reports: mounts (evidence: `apps/api/src/server.ts`)
- HTTP server → Watchlists: mounts (evidence: `apps/api/src/server.ts`)
- HTTP server → Admin operations: mounts (evidence: `apps/api/src/server.ts`)
- HTTP server → Access middleware: protects routes (evidence: `apps/api/src/server.ts`)
- Access middleware → Token and passwords: verifies token (evidence: `apps/api/src/middleware/auth.ts`)
- Authentication → Token and passwords: hashes and signs (evidence: `apps/api/src/routes/auth.ts`)
- Authentication → Request validation: validates input (evidence: `apps/api/src/routes/auth.ts`)
- Stock catalog → Request validation: validates input (evidence: `apps/api/src/routes/catalog.ts`)
- Trades and reports → Request validation: validates trades (evidence: `apps/api/src/routes/portfolio.ts`)
- Authentication → Database access: reads and writes (evidence: `apps/api/src/routes/auth.ts`)
- Stock catalog → Database access: reads and writes (evidence: `apps/api/src/routes/catalog.ts`)
- Trades and reports → Database access: reads and writes (evidence: `apps/api/src/routes/portfolio.ts`)
- Watchlists → Database access: reads and writes (evidence: `apps/api/src/routes/watchlist.ts`)
- Admin operations → Database access: reads records (evidence: `apps/api/src/routes/admin.ts`)
- Database access → Portfolio database: queries
- HTTP server → Market refresh: starts refresh job (evidence: `apps/api/src/server.ts`)
- Admin operations → Market refresh: triggers refresh (evidence: `apps/api/src/routes/admin.ts`)
- Market refresh → Database access: updates prices (evidence: `apps/api/src/lib/marketData.ts`)
- Market refresh → Twelve Data: fetches prices (evidence: `apps/api/src/lib/marketData.ts`)
- Authentication → SMTP mail: sends verification mail (evidence: `apps/api/src/routes/auth.ts`)
