# nirubama12/stockit architecture

> Architecture diagram of the GitHub repository nirubama12/stockit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nirubama12/stockit
- Repository: https://github.com/nirubama12/stockit

## Overview

StockIt is a Flask stock-market and portfolio-trading web application. Users can register or log in, browse market data, and manage a simulated portfolio by buying and selling shares. The sampled app code retrieves stock prices from Yahoo Finance and uses MySQL for accounts, prices, holdings, and transaction summaries. The source excerpt confirms only some route-to-template links; other page relationships and capabilities are inferred from filenames and are shown as unverified rather than asserted.

Main entry points: [`app.py`](https://github.com/nirubama12/stockit/blob/main/app.py) (Flask routes), [`Stocks.html`](https://github.com/nirubama12/stockit/blob/main/Stocks.html) (Stock list), [`movers.html`](https://github.com/nirubama12/stockit/blob/main/movers.html) (Market movers), [`gainers.html`](https://github.com/nirubama12/stockit/blob/main/gainers.html) (Gainers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_flask["Flask routes<br/>[app.py]"]
  node_mysql[("MySQL database")]
end

subgraph group_market["Market browsing"]
  node_yahoo["Yahoo Finance"]
  node_stocks["Stock list<br/>[Stocks.html]"]
  node_movers["Market movers<br/>[movers.html]"]
  node_gainers["Gainers<br/>[gainers.html]"]
  node_losers["Losers<br/>[losers.html]"]
  node_stockinfo["Stock details<br/>[stockinfo.html]"]
  node_graph["Price graph<br/>[graph.html]"]
end

subgraph group_portfolio["Accounts and portfolio"]
  node_login["Login<br/>[login.html]"]
  node_register["Registration<br/>[register.html]"]
  node_profile["Profile<br/>[profile.html]"]
  node_portfolio["Holdings<br/>[portfolio.html]"]
  node_buy["Buy shares<br/>[buy.html]"]
  node_sell["Sell shares<br/>[sell.html]"]
  node_insufficient["Trade warning<br/>[insufficient.html]"]
end

node_visitor(("Visitor"))

node_visitor -.->|"uses routes"| node_flask
node_flask -->|"queries and updates"| node_mysql
node_flask -->|"downloads prices"| node_yahoo
node_flask -->|"renders"| node_login
node_flask -->|"renders"| node_stocks
node_flask -->|"renders"| node_movers
node_flask -->|"renders"| node_profile
node_flask -.->|"renders"| node_register
node_flask -.->|"renders"| node_gainers
node_flask -.->|"renders"| node_losers
node_flask -.->|"renders"| node_stockinfo
node_flask -.->|"renders"| node_graph
node_flask -.->|"renders"| node_portfolio
node_flask -.->|"renders"| node_buy
node_flask -.->|"renders"| node_sell
node_flask -.->|"renders"| node_insufficient

click node_flask "https://github.com/nirubama12/stockit/blob/main/app.py"
click node_stocks "https://github.com/nirubama12/stockit/blob/main/Stocks.html"
click node_movers "https://github.com/nirubama12/stockit/blob/main/movers.html"
click node_gainers "https://github.com/nirubama12/stockit/blob/main/gainers.html"
click node_losers "https://github.com/nirubama12/stockit/blob/main/losers.html"
click node_stockinfo "https://github.com/nirubama12/stockit/blob/main/stockinfo.html"
click node_graph "https://github.com/nirubama12/stockit/blob/main/graph.html"
click node_login "https://github.com/nirubama12/stockit/blob/main/login.html"
click node_register "https://github.com/nirubama12/stockit/blob/main/register.html"
click node_profile "https://github.com/nirubama12/stockit/blob/main/profile.html"
click node_portfolio "https://github.com/nirubama12/stockit/blob/main/portfolio.html"
click node_buy "https://github.com/nirubama12/stockit/blob/main/buy.html"
click node_sell "https://github.com/nirubama12/stockit/blob/main/sell.html"
click node_insufficient "https://github.com/nirubama12/stockit/blob/main/insufficient.html"

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_flask,node_mysql toneBlue
class node_yahoo,node_stocks,node_movers,node_gainers,node_losers,node_stockinfo,node_graph toneAmber
class node_login,node_register,node_profile,node_portfolio,node_buy,node_sell,node_insufficient toneMint
class node_visitor toneIndigo
```

## Components

### Web application

- [Flask routes](https://github.com/nirubama12/stockit/blob/main/app.py): `app.py`
- **MySQL database**

### Market browsing

- **Yahoo Finance**
- [Stock list](https://github.com/nirubama12/stockit/blob/main/Stocks.html): `Stocks.html`
- [Market movers](https://github.com/nirubama12/stockit/blob/main/movers.html): `movers.html`
- [Gainers](https://github.com/nirubama12/stockit/blob/main/gainers.html): `gainers.html`
- [Losers](https://github.com/nirubama12/stockit/blob/main/losers.html): `losers.html`
- [Stock details](https://github.com/nirubama12/stockit/blob/main/stockinfo.html): `stockinfo.html`
- [Price graph](https://github.com/nirubama12/stockit/blob/main/graph.html): `graph.html`

### Accounts and portfolio

- [Login](https://github.com/nirubama12/stockit/blob/main/login.html): `login.html`
- [Registration](https://github.com/nirubama12/stockit/blob/main/register.html): `register.html`
- [Profile](https://github.com/nirubama12/stockit/blob/main/profile.html): `profile.html`
- [Holdings](https://github.com/nirubama12/stockit/blob/main/portfolio.html): `portfolio.html`
- [Buy shares](https://github.com/nirubama12/stockit/blob/main/buy.html): `buy.html`
- [Sell shares](https://github.com/nirubama12/stockit/blob/main/sell.html): `sell.html`
- [Trade warning](https://github.com/nirubama12/stockit/blob/main/insufficient.html): `insufficient.html`

### Other components

- **Visitor**

## Connections

- Visitor → Flask routes: uses routes
- Flask routes → MySQL database: queries and updates (evidence: `app.py`)
- Flask routes → Yahoo Finance: downloads prices (evidence: `app.py`)
- Flask routes → Login: renders (evidence: `app.py`)
- Flask routes → Stock list: renders (evidence: `app.py`)
- Flask routes → Market movers: renders (evidence: `app.py`)
- Flask routes → Profile: renders (evidence: `app.py`)
- Flask routes → Registration: renders
- Flask routes → Gainers: renders
- Flask routes → Losers: renders
- Flask routes → Stock details: renders
- Flask routes → Price graph: renders
- Flask routes → Holdings: renders
- Flask routes → Buy shares: renders
- Flask routes → Sell shares: renders
- Flask routes → Trade warning: renders
