# agrawalanshul802-hub/portfolio-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/agrawalanshul802-hub/portfolio-tracker
- Repository: https://github.com/agrawalanshul802-hub/portfolio-tracker

## Overview

Portfolio Tracker is a browser-based investment portfolio and IPO tracker backed by a Flask API. Users sign in, manage holdings, and use portfolio analytics, live prices, alerts, news/AI assistance, and IPO tools. The backend routes requests to feature blueprints; holdings and IPO data use Supabase when configured, with local in-memory fallback state documented for shared route state. Frontend module relationships are limited to the wiring described in `js/main.js`; unsampled implementation details and external-service connections are omitted unless directly evidenced.

Main entry points: [`js/main.js`](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/main.js) (App wiring), [`app.py`](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/app.py) (Flask application), [`routes/auth.py`](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/auth.py) (Authentication), [`routes/limiter.py`](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/limiter.py) (Rate limiting)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser application"]
  node_main["App wiring<br/>[main.js]"]
  node_frontend["Portfolio interface<br/>[app.js]"]
  node_portfolio["Portfolio management<br/>[portfolio.js]"]
  node_analytics["Portfolio analytics<br/>[analytics.js]"]
  node_alerts["Price alerts<br/>[alerts.js]"]
  node_ipo_ui["IPO interface<br/>[ipo.js]"]
  node_state["Client state<br/>[state.js]"]
  node_effects["Visual effects<br/>[effects.js]"]
end

subgraph group_api["Flask API"]
  node_app["Flask application<br/>[app.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_holdings["Holdings API<br/>[holdings.py]"]
  node_prices["Prices and charts<br/>[prices.py]"]
  node_ai["AI and news<br/>[ai_copilot.py]"]
  node_ipo["IPO and applications<br/>[ipo.py]"]
  node_email_alerts["Alert email dispatch<br/>[alerts_email.py]"]
end

subgraph group_data["Data and services"]
  node_supabase[("Supabase")]
  node_market_data["Market data sources"]
  node_smtp["SMTP mail service"]
end

subgraph group_shared["Shared backend layer"]
  node_limiter["Rate limiting<br/>[limiter.py]"]
  node_shared_state["Shared state and DB client<br/>[__init__.py]"]
end

node_investor(("Investor"))

node_investor -->|"uses"| node_main
node_main -->|"wires"| node_portfolio
node_main -->|"wires"| node_analytics
node_main -->|"wires"| node_alerts
node_main -->|"wires"| node_ipo_ui
node_main -->|"depends on"| node_state
node_main -->|"depends on"| node_effects
node_main -->|"requests auth"| node_auth
node_frontend -->|"requests news"| node_ai
node_app -->|"registers"| node_auth
node_app -->|"registers"| node_holdings
node_app -->|"registers"| node_prices
node_app -->|"registers"| node_ai
node_app -->|"registers"| node_ipo
node_app -->|"registers"| node_email_alerts
node_app -->|"configures"| node_limiter
node_auth -->|"uses"| node_limiter
node_prices -->|"uses"| node_limiter
node_email_alerts -->|"uses"| node_limiter
node_holdings -->|"uses"| node_shared_state
node_email_alerts -->|"sends mail"| node_smtp
node_holdings -->|"reads and writes"| node_supabase
node_auth -->|"uses"| node_supabase
node_ipo -->|"uses"| node_supabase
node_prices -->|"fetches prices"| node_market_data
node_ai -->|"fetches news"| node_market_data

click node_main "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/main.js"
click node_frontend "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/app.js"
click node_portfolio "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/portfolio.js"
click node_analytics "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/analytics.js"
click node_alerts "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/alerts.js"
click node_ipo_ui "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/ipo.js"
click node_state "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/state.js"
click node_effects "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/effects.js"
click node_app "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/app.py"
click node_auth "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/auth.py"
click node_holdings "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/holdings.py"
click node_prices "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/prices.py"
click node_ai "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/ai_copilot.py"
click node_ipo "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/ipo.py"
click node_email_alerts "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/alerts_email.py"
click node_limiter "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/limiter.py"
click node_shared_state "https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/__init__.py"

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_main,node_frontend,node_portfolio,node_analytics,node_alerts,node_ipo_ui,node_state,node_effects toneBlue
class node_app,node_auth,node_holdings,node_prices,node_ai,node_ipo,node_email_alerts toneAmber
class node_supabase,node_market_data,node_smtp toneMint
class node_limiter,node_shared_state toneRose
class node_investor toneIndigo
```

## Components

### Browser application

- [App wiring](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/main.js): `js/main.js`
- [Portfolio interface](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/app.js): `app.js`
- [Portfolio management](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/portfolio.js): `js/portfolio.js`
- [Portfolio analytics](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/analytics.js): `js/analytics.js`
- [Price alerts](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/alerts.js): `js/alerts.js`
- [IPO interface](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/ipo.js): `js/ipo.js`
- [Client state](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/state.js): `js/state.js`
- [Visual effects](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/js/effects.js): `js/effects.js`

### Flask API

- [Flask application](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/app.py): `app.py`
- [Authentication](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/auth.py): `routes/auth.py`
- [Holdings API](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/holdings.py): `routes/holdings.py`
- [Prices and charts](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/prices.py): `routes/prices.py`
- [AI and news](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/ai_copilot.py): `routes/ai_copilot.py`
- [IPO and applications](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/ipo.py): `routes/ipo.py`
- [Alert email dispatch](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/alerts_email.py): `routes/alerts_email.py`

### Data and services

- **Supabase**
- **Market data sources**
- **SMTP mail service**

### Shared backend layer

- [Rate limiting](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/limiter.py): `routes/limiter.py`
- [Shared state and DB client](https://github.com/agrawalanshul802-hub/portfolio-tracker/blob/main/routes/__init__.py): `routes/__init__.py`

### Other components

- **Investor**

## Connections

- Investor → App wiring: uses
- App wiring → Portfolio management: wires (evidence: `js/main.js`)
- App wiring → Portfolio analytics: wires (evidence: `js/main.js`)
- App wiring → Price alerts: wires (evidence: `js/main.js`)
- App wiring → IPO interface: wires (evidence: `js/main.js`)
- App wiring → Client state: depends on (evidence: `js/main.js`)
- App wiring → Visual effects: depends on (evidence: `js/main.js`)
- App wiring → Authentication: requests auth (evidence: `js/main.js`)
- Portfolio interface → AI and news: requests news (evidence: `app.js`)
- Flask application → Authentication: registers (evidence: `app.py`)
- Flask application → Holdings API: registers (evidence: `app.py`)
- Flask application → Prices and charts: registers (evidence: `app.py`)
- Flask application → AI and news: registers (evidence: `app.py`)
- Flask application → IPO and applications: registers (evidence: `app.py`)
- Flask application → Alert email dispatch: registers (evidence: `app.py`)
- Flask application → Rate limiting: configures (evidence: `app.py`)
- Authentication → Rate limiting: uses (evidence: `routes/auth.py`)
- Prices and charts → Rate limiting: uses (evidence: `routes/prices.py`)
- Alert email dispatch → Rate limiting: uses (evidence: `routes/alerts_email.py`)
- Holdings API → Shared state and DB client: uses (evidence: `routes/holdings.py`)
- Alert email dispatch → SMTP mail service: sends mail (evidence: `routes/alerts_email.py`)
- Holdings API → Supabase: reads and writes (evidence: `routes/holdings.py`)
- Authentication → Supabase: uses (evidence: `routes/auth.py`)
- IPO and applications → Supabase: uses (evidence: `routes/ipo.py`)
- Prices and charts → Market data sources: fetches prices (evidence: `routes/prices.py`)
- AI and news → Market data sources: fetches news (evidence: `routes/ai_copilot.py`)
