# saamy4r/freqtrade_app architecture

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

- Interactive diagram: https://gitdiagram.com/saamy4r/freqtrade_app
- Repository: https://github.com/saamy4r/freqtrade_app

## Overview

Freqtrade Visualizer is a local-first Rust app for monitoring multiple Freqtrade bots. The user adds or selects a bot, then views open and closed trades, dashboard metrics, price charts, and logs; the UI requests prepared screen payloads from an in-app server, which fetches bot data and serves cached results from SQLite when appropriate. The README documents the major product capabilities and overall HTTP topology; source excerpts clarify key server, client, and storage responsibilities, but not every screen or route implementation.

Main entry points: [`crates/ft-store/src/store.rs`](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-store/src/store.rs) (SQLite store), [`crates/ft-server/src/routes/screens.rs`](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/routes/screens.rs) (Screen endpoints), [`crates/freqtrade/src/screens`](https://github.com/saamy4r/freqtrade_app/tree/main/crates/freqtrade/src/screens) (Monitoring screens), [`crates/ft-server/src/fetch.rs`](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/fetch.rs) (Cache and fetch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Visualizer UI"]
  node_app["App shell<br/>[app.rs]"]
  node_screens["Monitoring screens"]
  node_botmgmt["Bot management<br/>[bots.rs]"]
  node_uiapi["UI API access<br/>[api.rs]"]
  node_uistate["UI state<br/>[state.rs]"]
  node_charts["Chart rendering<br/>[price_chart.rs]"]
  node_format["Display formatting<br/>[format.rs]"]
end

subgraph group_server["Local API"]
  node_http["Screen endpoints<br/>[screens.rs]"]
  node_botroutes["Bot endpoints<br/>[bots.rs]"]
  node_fetch["Cache and fetch<br/>[fetch.rs]"]
  node_compute["Metrics computation<br/>[compute.rs]"]
  node_serverstate["Server state<br/>[state.rs]"]
  node_sync["Background sync<br/>[sync.rs]"]
  node_events["Live events<br/>[events.rs]"]
end

subgraph group_integration["Bot integration"]
  node_client["Freqtrade REST client<br/>[client.rs]"]
  node_auth["Token refresh<br/>[auth.rs]"]
end

subgraph group_storage["Local data"]
  node_store[("SQLite store<br/>[store.rs]")]
  node_crypto["Credential encryption<br/>[crypto.rs]"]
  node_types["API data types<br/>[freqtrade.rs]"]
  node_flex["Tolerant parsing<br/>[flex.rs]"]
end

node_user(("User"))
node_bot(("Freqtrade bot"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_screens
node_app -->|"shows"| node_botmgmt
node_screens -.->|"requests data"| node_uiapi
node_botmgmt -->|"manages bots"| node_uiapi
node_screens -->|"reads state"| node_uistate
node_screens -->|"renders charts"| node_charts
node_charts -->|"formats values"| node_format
node_uiapi -->|"HTTP requests"| node_http
node_http -->|"loads data"| node_fetch
node_http -->|"computes metrics"| node_compute
node_http -->|"reads and writes"| node_store
node_botroutes -->|"updates bot records"| node_store
node_fetch -->|"checks cache"| node_store
node_fetch -->|"fetches live data"| node_client
node_http -->|"uses state"| node_serverstate
node_serverstate -->|"loads credentials"| node_store
node_serverstate -->|"creates client"| node_client
node_sync -->|"refreshes data"| node_fetch
node_sync -->|"checks watchers"| node_serverstate
node_sync -->|"publishes changes"| node_events
node_client -->|"refreshes tokens"| node_auth
node_client -->|"calls REST API"| node_bot
node_store -->|"encrypts passwords"| node_crypto
node_store -.->|"stores payloads"| node_types
node_types -->|"uses parsers"| node_flex
node_store -->|"keeps data offline"| node_user

click node_app "https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/app.rs"
click node_screens "https://github.com/saamy4r/freqtrade_app/tree/main/crates/freqtrade/src/screens"
click node_botmgmt "https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/screens/bots.rs"
click node_uiapi "https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/api.rs"
click node_uistate "https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/state.rs"
click node_charts "https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/components/price_chart.rs"
click node_format "https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/format.rs"
click node_http "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/routes/screens.rs"
click node_botroutes "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/routes/bots.rs"
click node_fetch "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/fetch.rs"
click node_compute "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/compute.rs"
click node_serverstate "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/state.rs"
click node_sync "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/sync.rs"
click node_events "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/events.rs"
click node_client "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-client/src/client.rs"
click node_auth "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-client/src/auth.rs"
click node_store "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-store/src/store.rs"
click node_crypto "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-store/src/crypto.rs"
click node_types "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-types/src/freqtrade.rs"
click node_flex "https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-types/src/flex.rs"

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_app,node_screens,node_botmgmt,node_uiapi,node_uistate,node_charts,node_format,node_user toneBlue
class node_http,node_botroutes,node_fetch,node_compute,node_serverstate,node_sync,node_events toneAmber
class node_client,node_auth toneMint
class node_store,node_crypto,node_types,node_flex toneRose
class node_bot toneIndigo
```

## Components

### Visualizer UI

- [App shell](https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/app.rs): `crates/freqtrade/src/app.rs`
- [Monitoring screens](https://github.com/saamy4r/freqtrade_app/tree/main/crates/freqtrade/src/screens): `crates/freqtrade/src/screens`
- [Bot management](https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/screens/bots.rs): `crates/freqtrade/src/screens/bots.rs`
- [UI API access](https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/api.rs): `crates/freqtrade/src/api.rs`
- [UI state](https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/state.rs): `crates/freqtrade/src/state.rs`
- [Chart rendering](https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/components/price_chart.rs): `crates/freqtrade/src/components/price_chart.rs`
- [Display formatting](https://github.com/saamy4r/freqtrade_app/blob/main/crates/freqtrade/src/format.rs): `crates/freqtrade/src/format.rs`

### Local API

- [Screen endpoints](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/routes/screens.rs): `crates/ft-server/src/routes/screens.rs`
- [Bot endpoints](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/routes/bots.rs): `crates/ft-server/src/routes/bots.rs`
- [Cache and fetch](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/fetch.rs): `crates/ft-server/src/fetch.rs`
- [Metrics computation](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/compute.rs): `crates/ft-server/src/compute.rs`
- [Server state](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/state.rs): `crates/ft-server/src/state.rs`
- [Background sync](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/sync.rs): `crates/ft-server/src/sync.rs`
- [Live events](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-server/src/events.rs): `crates/ft-server/src/events.rs`

### Bot integration

- [Freqtrade REST client](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-client/src/client.rs): `crates/ft-client/src/client.rs`
- [Token refresh](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-client/src/auth.rs): `crates/ft-client/src/auth.rs`

### Local data

- [SQLite store](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-store/src/store.rs): `crates/ft-store/src/store.rs`
- [Credential encryption](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-store/src/crypto.rs): `crates/ft-store/src/crypto.rs`
- [API data types](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-types/src/freqtrade.rs): `crates/ft-types/src/freqtrade.rs`
- [Tolerant parsing](https://github.com/saamy4r/freqtrade_app/blob/main/crates/ft-types/src/flex.rs): `crates/ft-types/src/flex.rs`

### Other components

- **User**
- **Freqtrade bot**

## Connections

- User → App shell: uses
- App shell → Monitoring screens: routes to (evidence: `crates/freqtrade/src/app.rs`)
- App shell → Bot management: shows (evidence: `crates/freqtrade/src/app.rs`)
- Monitoring screens → UI API access: requests data (evidence: `crates/freqtrade/src/screens/bots.rs`)
- Bot management → UI API access: manages bots (evidence: `crates/freqtrade/src/screens/bots.rs`)
- Monitoring screens → UI state: reads state (evidence: `crates/freqtrade/src/screens/open_trades.rs`)
- Monitoring screens → Chart rendering: renders charts
- Chart rendering → Display formatting: formats values (evidence: `crates/freqtrade/src/components/price_chart.rs`)
- UI API access → Screen endpoints: HTTP requests
- Screen endpoints → Cache and fetch: loads data (evidence: `crates/ft-server/src/routes/screens.rs`)
- Screen endpoints → Metrics computation: computes metrics (evidence: `crates/ft-server/src/routes/screens.rs`)
- Screen endpoints → SQLite store: reads and writes (evidence: `crates/ft-server/src/routes/screens.rs`)
- Bot endpoints → SQLite store: updates bot records (evidence: `crates/ft-server/src/routes/bots.rs`)
- Cache and fetch → SQLite store: checks cache (evidence: `crates/ft-server/src/fetch.rs`)
- Cache and fetch → Freqtrade REST client: fetches live data
- Screen endpoints → Server state: uses state (evidence: `crates/ft-server/src/routes/screens.rs`)
- Server state → SQLite store: loads credentials (evidence: `crates/ft-server/src/state.rs`)
- Server state → Freqtrade REST client: creates client (evidence: `crates/ft-server/src/state.rs`)
- Background sync → Cache and fetch: refreshes data (evidence: `crates/ft-server/src/sync.rs`)
- Background sync → Server state: checks watchers (evidence: `crates/ft-server/src/sync.rs`)
- Background sync → Live events: publishes changes (evidence: `crates/ft-server/src/sync.rs`)
- Freqtrade REST client → Token refresh: refreshes tokens (evidence: `crates/ft-client/src/client.rs`)
- Freqtrade REST client → Freqtrade bot: calls REST API
- SQLite store → Credential encryption: encrypts passwords (evidence: `crates/ft-store/src/store.rs`)
- SQLite store → API data types: stores payloads
- API data types → Tolerant parsing: uses parsers (evidence: `crates/ft-types/src/freqtrade.rs`)
- SQLite store → User: keeps data offline
