# alex-eevich/mini-broker architecture

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

- Interactive diagram: https://gitdiagram.com/alex-eevich/mini-broker
- Repository: https://github.com/alex-eevich/mini-broker

## Overview

Mini-Broker is a Go HTTP application for account registration and authentication, market news, ticker discovery, chart data, and linking a user’s Tinkoff trade token. The main workflow serves the web UI, routes API requests, authenticates protected actions, and reads or updates PostgreSQL and market services. The chart endpoint resolves ticker symbols to FIGI, requests candles, and formats a response; token linking checks email verification and provisions an account. The graph includes README-documented chart interval options, but their full implementation was not sampled.

Main entry points: [`internal/app/app.go`](https://github.com/alex-eevich/mini-broker/blob/main/internal/app/app.go) (Route setup), [`internal/db/connect_db.go`](https://github.com/alex-eevich/mini-broker/blob/main/internal/db/connect_db.go) (PostgreSQL), [`internal/token/user_token.go`](https://github.com/alex-eevich/mini-broker/blob/main/internal/token/user_token.go) (Trade token linking), [`internal/users/session.go`](https://github.com/alex-eevich/mini-broker/blob/main/internal/users/session.go) (Auth middleware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_web_assets["Web pages<br/>[index.html]"]
end

subgraph group_identity["Accounts and identity"]
  node_registration["Registration<br/>[users.go]"]
  node_login["Login and JWT<br/>[session.go]"]
  node_auth_middleware["Auth middleware<br/>[session.go]"]
  node_profile["Profile<br/>[session.go]"]
  node_email_verification["Email verification<br/>[verified.go]"]
  node_email_service["SMTP sender<br/>[verified.go]"]
end

subgraph group_market["Market data"]
  node_news_russia["Russian news<br/>[rus_news.go]"]
  node_news_world["World news<br/>[world_news.go]"]
  node_ticker_catalog["Ticker catalog<br/>[get_tickers.go]"]
  node_candle_api["Chart endpoint<br/>[get_candles.go]"]
  node_candle_transform["Candle formatting<br/>[get_candles.go]"]
end

subgraph group_trading["Trade access"]
  node_trade_token["Trade token linking<br/>[user_token.go]"]
  node_tbank_client["Tinkoff client<br/>[connect_tbank.go]"]
  node_portfolio["Accounts and portfolio<br/>[portfolio.go]"]
end

subgraph group_infrastructure["Runtime and storage"]
  node_http_server["HTTP server<br/>[main.go]"]
  node_routes["Route setup<br/>[app.go]"]
  node_database[("PostgreSQL<br/>[connect_db.go]")]
end

node_visitor(("Browser user"))
node_tinkoff_api{{"Tinkoff Invest API"}}
node_finnhub{{"Finnhub news"}}
node_interfax{{"Interfax RSS"}}

node_visitor -->|"requests"| node_http_server
node_http_server -->|"starts routes"| node_routes
node_routes -->|"serves files"| node_web_assets
node_visitor -.->|"views"| node_web_assets
node_routes -->|"routes registration"| node_registration
node_routes -->|"routes login"| node_login
node_routes -->|"routes news"| node_news_russia
node_routes -->|"routes news"| node_news_world
node_routes -->|"routes shares"| node_ticker_catalog
node_routes -->|"routes charts"| node_candle_api
node_routes -->|"protects routes"| node_auth_middleware
node_auth_middleware -->|"dispatches profile"| node_profile
node_auth_middleware -->|"dispatches verification"| node_email_verification
node_auth_middleware -->|"dispatches token actions"| node_trade_token
node_registration -->|"writes user"| node_database
node_login -->|"reads user"| node_database
node_profile -->|"reads profile"| node_database
node_email_verification -->|"updates verification"| node_database
node_email_verification -->|"sends email"| node_email_service
node_email_service -.->|"emails link"| node_visitor
node_news_russia -->|"fetches RSS"| node_interfax
node_news_world -->|"fetches feed"| node_finnhub
node_ticker_catalog -->|"requests shares"| node_tinkoff_api
node_ticker_catalog -->|"stores and reads tickers"| node_database
node_candle_api -->|"reads token and FIGI"| node_database
node_candle_api -->|"requests candles"| node_tinkoff_api
node_candle_api -->|"formats results"| node_candle_transform
node_trade_token -->|"stores token"| node_database
node_trade_token -->|"checks approval"| node_email_verification
node_trade_token -->|"validates token"| node_tbank_client
node_tbank_client -.->|"calls investment API"| node_tinkoff_api
node_trade_token -->|"provisions account"| node_portfolio
node_portfolio -->|"stores account"| node_database
node_portfolio -.->|"opens sandbox account"| node_tinkoff_api

click node_http_server "https://github.com/alex-eevich/mini-broker/blob/main/cmd/main.go"
click node_routes "https://github.com/alex-eevich/mini-broker/blob/main/internal/app/app.go"
click node_web_assets "https://github.com/alex-eevich/mini-broker/blob/main/internal/web/index.html"
click node_database "https://github.com/alex-eevich/mini-broker/blob/main/internal/db/connect_db.go"
click node_registration "https://github.com/alex-eevich/mini-broker/blob/main/internal/users/users.go"
click node_login "https://github.com/alex-eevich/mini-broker/blob/main/internal/users/session.go"
click node_auth_middleware "https://github.com/alex-eevich/mini-broker/blob/main/internal/users/session.go"
click node_profile "https://github.com/alex-eevich/mini-broker/blob/main/internal/users/session.go"
click node_email_verification "https://github.com/alex-eevich/mini-broker/blob/main/internal/users/verified.go"
click node_email_service "https://github.com/alex-eevich/mini-broker/blob/main/internal/users/verified.go"
click node_news_russia "https://github.com/alex-eevich/mini-broker/blob/main/internal/news/rus_news.go"
click node_news_world "https://github.com/alex-eevich/mini-broker/blob/main/internal/news/world_news.go"
click node_ticker_catalog "https://github.com/alex-eevich/mini-broker/blob/main/internal/tbank/get_tickers.go"
click node_candle_api "https://github.com/alex-eevich/mini-broker/blob/main/internal/tbank/get_candles.go"
click node_candle_transform "https://github.com/alex-eevich/mini-broker/blob/main/internal/tbank/get_candles.go"
click node_trade_token "https://github.com/alex-eevich/mini-broker/blob/main/internal/token/user_token.go"
click node_tbank_client "https://github.com/alex-eevich/mini-broker/blob/main/internal/tbank/connect_tbank.go"
click node_portfolio "https://github.com/alex-eevich/mini-broker/blob/main/internal/tbank/portfolio.go"

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_web_assets,node_visitor toneBlue
class node_registration,node_login,node_auth_middleware,node_profile,node_email_verification,node_email_service toneAmber
class node_news_russia,node_news_world,node_ticker_catalog,node_candle_api,node_candle_transform,node_tinkoff_api toneMint
class node_trade_token,node_tbank_client,node_portfolio toneRose
class node_http_server,node_routes,node_database,node_finnhub,node_interfax toneIndigo
```

## Components

### Web interface

- [Web pages](https://github.com/alex-eevich/mini-broker/blob/main/internal/web/index.html): `internal/web/index.html`

### Accounts and identity

- [Registration](https://github.com/alex-eevich/mini-broker/blob/main/internal/users/users.go): `internal/users/users.go`
- [Login and JWT](https://github.com/alex-eevich/mini-broker/blob/main/internal/users/session.go): `internal/users/session.go`
- [Auth middleware](https://github.com/alex-eevich/mini-broker/blob/main/internal/users/session.go): `internal/users/session.go`
- [Profile](https://github.com/alex-eevich/mini-broker/blob/main/internal/users/session.go): `internal/users/session.go`
- [Email verification](https://github.com/alex-eevich/mini-broker/blob/main/internal/users/verified.go): `internal/users/verified.go`
- [SMTP sender](https://github.com/alex-eevich/mini-broker/blob/main/internal/users/verified.go): `internal/users/verified.go`

### Market data

- [Russian news](https://github.com/alex-eevich/mini-broker/blob/main/internal/news/rus_news.go): `internal/news/rus_news.go`
- [World news](https://github.com/alex-eevich/mini-broker/blob/main/internal/news/world_news.go): `internal/news/world_news.go`
- [Ticker catalog](https://github.com/alex-eevich/mini-broker/blob/main/internal/tbank/get_tickers.go): `internal/tbank/get_tickers.go`
- [Chart endpoint](https://github.com/alex-eevich/mini-broker/blob/main/internal/tbank/get_candles.go): `internal/tbank/get_candles.go`
- [Candle formatting](https://github.com/alex-eevich/mini-broker/blob/main/internal/tbank/get_candles.go): `internal/tbank/get_candles.go`

### Trade access

- [Trade token linking](https://github.com/alex-eevich/mini-broker/blob/main/internal/token/user_token.go): `internal/token/user_token.go`
- [Tinkoff client](https://github.com/alex-eevich/mini-broker/blob/main/internal/tbank/connect_tbank.go): `internal/tbank/connect_tbank.go`
- [Accounts and portfolio](https://github.com/alex-eevich/mini-broker/blob/main/internal/tbank/portfolio.go): `internal/tbank/portfolio.go`

### Runtime and storage

- [HTTP server](https://github.com/alex-eevich/mini-broker/blob/main/cmd/main.go): `cmd/main.go`
- [Route setup](https://github.com/alex-eevich/mini-broker/blob/main/internal/app/app.go): `internal/app/app.go`
- [PostgreSQL](https://github.com/alex-eevich/mini-broker/blob/main/internal/db/connect_db.go): `internal/db/connect_db.go`

### Other components

- **Browser user**
- **Tinkoff Invest API**
- **Finnhub news**
- **Interfax RSS**

## Connections

- Browser user → HTTP server: requests (evidence: `cmd/main.go`)
- HTTP server → Route setup: starts routes (evidence: `cmd/main.go`)
- Route setup → Web pages: serves files (evidence: `internal/app/app.go`)
- Browser user → Web pages: views
- Route setup → Registration: routes registration (evidence: `internal/app/app.go`)
- Route setup → Login and JWT: routes login (evidence: `internal/app/app.go`)
- Route setup → Russian news: routes news (evidence: `internal/app/app.go`)
- Route setup → World news: routes news (evidence: `internal/app/app.go`)
- Route setup → Ticker catalog: routes shares (evidence: `internal/app/app.go`)
- Route setup → Chart endpoint: routes charts (evidence: `internal/app/app.go`)
- Route setup → Auth middleware: protects routes (evidence: `internal/app/app.go`)
- Auth middleware → Profile: dispatches profile (evidence: `internal/users/session.go`)
- Auth middleware → Email verification: dispatches verification
- Auth middleware → Trade token linking: dispatches token actions
- Registration → PostgreSQL: writes user (evidence: `internal/users/users.go`)
- Login and JWT → PostgreSQL: reads user (evidence: `internal/users/session.go`)
- Profile → PostgreSQL: reads profile (evidence: `internal/users/session.go`)
- Email verification → PostgreSQL: updates verification (evidence: `internal/users/verified.go`)
- Email verification → SMTP sender: sends email (evidence: `internal/users/verified.go`)
- SMTP sender → Browser user: emails link
- Russian news → Interfax RSS: fetches RSS (evidence: `internal/news/rus_news.go`)
- World news → Finnhub news: fetches feed (evidence: `internal/news/world_news.go`)
- Ticker catalog → Tinkoff Invest API: requests shares (evidence: `internal/tbank/get_tickers.go`)
- Ticker catalog → PostgreSQL: stores and reads tickers (evidence: `internal/tbank/get_tickers.go`)
- Chart endpoint → PostgreSQL: reads token and FIGI (evidence: `internal/tbank/get_candles.go`)
- Chart endpoint → Tinkoff Invest API: requests candles (evidence: `internal/tbank/get_candles.go`)
- Chart endpoint → Candle formatting: formats results (evidence: `internal/tbank/get_candles.go`)
- Trade token linking → PostgreSQL: stores token (evidence: `internal/token/user_token.go`)
- Trade token linking → Email verification: checks approval (evidence: `internal/token/user_token.go`)
- Trade token linking → Tinkoff client: validates token (evidence: `internal/token/user_token.go`)
- Tinkoff client → Tinkoff Invest API: calls investment API
- Trade token linking → Accounts and portfolio: provisions account (evidence: `internal/token/user_token.go`)
- Accounts and portfolio → PostgreSQL: stores account
- Accounts and portfolio → Tinkoff Invest API: opens sandbox account
