# loop24infility/finceptterminal architecture

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

- Interactive diagram: https://gitdiagram.com/loop24infility/finceptterminal
- Repository: https://github.com/loop24infility/finceptterminal

## Overview

Fincept Terminal is a native desktop financial research and trading platform: users connect data, investigate markets with analytics and AI, manage portfolios, and—where supported—backtest or execute strategies. The README documents broad product desks, while the excerpts show selected internals such as LLM tool dispatch, algorithm deployment, persistent storage, and cloud sync. Some major capabilities are represented at subsystem level because their implementation files were not sampled; links without direct evidence are omitted.

Main entry points: [`fincept-qt/src/app/main.cpp`](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/app/main.cpp) (Fincept Terminal), [`fincept-qt/src/services/llm/LlmService.cpp`](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/llm/LlmService.cpp) (LLM service), [`fincept-qt/src/datahub/DataHub.h`](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/datahub/DataHub.h) (Data hub), [`fincept-qt/src/storage/sqlite/Database.h`](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/storage/sqlite/Database.h) (SQLite databases)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research &amp; Analytics"]
  node_market_research["Market research"]
  node_financial_analytics["Financial analytics"]
  node_macro["Macro &amp; global intelligence"]
  node_portfolio["Portfolio management"]
end

subgraph group_quant["Quant &amp; Trading"]
  node_quant_lab["Quant &amp; backtesting"]
  node_indicators["Market indicators"]
  node_algo["Algo deployments<br/>[AlgoEngine.cpp]"]
  node_orders["Smart order routing"]
  node_broker["Broker integrations<br/>[BrokerInterface.h]"]
end

subgraph group_ai["AI &amp; Automation"]
  node_llm["LLM service<br/>[LlmService.cpp]"]
  node_mcp["MCP tools"]
  node_arena["Alpha Arena<br/>[ArenaEngine.cpp]"]
  node_workflow["Workflow expressions"]
end

subgraph group_platform["Platform Services"]
  node_datahub["Data hub<br/>[DataHub.h]"]
  node_auth["Authentication<br/>[AuthManager.h]"]
end

subgraph group_state["State &amp; Sync"]
  node_storage_ui["Storage settings<br/>[StorageSection.cpp]"]
  node_storage["Storage manager<br/>[StorageManager.cpp]"]
  node_database[("SQLite databases<br/>[Database.h]")]
  node_llm_profiles["LLM profiles"]
  node_secrets["Secure storage<br/>[SecureStorage.cpp]"]
  node_cloud_sync["Cloud sync"]
end

node_user(("Terminal user"))
node_desktop["Fincept Terminal<br/>[main.cpp]"]

node_user -->|"uses"| node_desktop
node_desktop -->|"researches"| node_market_research
node_desktop -->|"analyzes"| node_financial_analytics
node_desktop -->|"explores"| node_macro
node_desktop -->|"manages"| node_portfolio
node_desktop -->|"backtests"| node_quant_lab
node_desktop -->|"trades"| node_orders
node_desktop -->|"requests AI"| node_llm
node_desktop -->|"runs agent research"| node_arena
node_desktop -->|"automates"| node_workflow
node_desktop -.->|"shares updates"| node_datahub
node_algo -->|"publishes metrics"| node_datahub
node_llm -->|"executes tools"| node_mcp
node_llm -->|"publishes streams"| node_datahub
node_storage_ui -->|"manages data"| node_storage
node_storage -->|"uses databases"| node_database
node_llm_profiles -->|"stores API keys"| node_secrets
node_llm -.->|"loads profiles"| node_llm_profiles
node_cloud_sync -->|"tracks credentials"| node_auth
node_cloud_sync -->|"reads sync state"| node_database
node_orders -.->|"routes orders"| node_broker
node_algo -->|"persists deployments"| node_database

click node_desktop "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/app/main.cpp"
click node_market_research "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/equity/EquityResearchService.cpp"
click node_financial_analytics "https://github.com/loop24infility/finceptterminal/tree/main/fincept-qt/scripts/Analytics"
click node_macro "https://github.com/loop24infility/finceptterminal/tree/main/fincept-qt/scripts/Analytics/economics"
click node_portfolio "https://github.com/loop24infility/finceptterminal/tree/main/fincept-qt/scripts/Analytics/portfolioManagement"
click node_quant_lab "https://github.com/loop24infility/finceptterminal/tree/main/fincept-qt/scripts/Analytics/backtesting"
click node_indicators "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/algo_engine/IndicatorEngine.cpp"
click node_algo "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/algo_engine/AlgoEngine.cpp"
click node_orders "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/trading/SmartOrderEngine.cpp"
click node_broker "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/trading/BrokerInterface.h"
click node_llm "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/llm/LlmService.cpp"
click node_mcp "https://github.com/loop24infility/finceptterminal/tree/main/fincept-qt/src/mcp"
click node_arena "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/alpha_arena/ArenaEngine.cpp"
click node_workflow "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/workflow/ExpressionEngine.cpp"
click node_datahub "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/datahub/DataHub.h"
click node_auth "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/auth/AuthManager.h"
click node_storage_ui "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/screens/settings/StorageSection.cpp"
click node_storage "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/storage/StorageManager.cpp"
click node_database "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/storage/sqlite/Database.h"
click node_llm_profiles "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/storage/repositories/LlmProfileRepository.cpp"
click node_secrets "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/storage/secure/SecureStorage.cpp"
click node_cloud_sync "https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/cloud/CloudSyncEngine.cpp"

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_market_research,node_financial_analytics,node_macro,node_portfolio,node_user toneBlue
class node_quant_lab,node_indicators,node_algo,node_orders,node_broker toneAmber
class node_llm,node_mcp,node_arena,node_workflow toneMint
class node_datahub,node_auth toneRose
class node_storage_ui,node_storage,node_database,node_llm_profiles,node_secrets,node_cloud_sync toneIndigo
class node_desktop toneTeal
```

## Components

### Research & Analytics

- [Market research](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/equity/EquityResearchService.cpp): `fincept-qt/src/services/equity/EquityResearchService.cpp`
- [Financial analytics](https://github.com/loop24infility/finceptterminal/tree/main/fincept-qt/scripts/Analytics): `fincept-qt/scripts/Analytics`
- [Macro & global intelligence](https://github.com/loop24infility/finceptterminal/tree/main/fincept-qt/scripts/Analytics/economics): `fincept-qt/scripts/Analytics/economics`
- [Portfolio management](https://github.com/loop24infility/finceptterminal/tree/main/fincept-qt/scripts/Analytics/portfolioManagement): `fincept-qt/scripts/Analytics/portfolioManagement`

### Quant & Trading

- [Quant & backtesting](https://github.com/loop24infility/finceptterminal/tree/main/fincept-qt/scripts/Analytics/backtesting): `fincept-qt/scripts/Analytics/backtesting`
- [Market indicators](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/algo_engine/IndicatorEngine.cpp): `fincept-qt/src/algo_engine/IndicatorEngine.cpp`
- [Algo deployments](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/algo_engine/AlgoEngine.cpp): `fincept-qt/src/algo_engine/AlgoEngine.cpp`
- [Smart order routing](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/trading/SmartOrderEngine.cpp): `fincept-qt/src/trading/SmartOrderEngine.cpp`
- [Broker integrations](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/trading/BrokerInterface.h): `fincept-qt/src/trading/BrokerInterface.h`

### AI & Automation

- [LLM service](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/llm/LlmService.cpp): `fincept-qt/src/services/llm/LlmService.cpp`
- [MCP tools](https://github.com/loop24infility/finceptterminal/tree/main/fincept-qt/src/mcp): `fincept-qt/src/mcp`
- [Alpha Arena](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/alpha_arena/ArenaEngine.cpp): `fincept-qt/src/services/alpha_arena/ArenaEngine.cpp`
- [Workflow expressions](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/workflow/ExpressionEngine.cpp): `fincept-qt/src/services/workflow/ExpressionEngine.cpp`

### Platform Services

- [Data hub](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/datahub/DataHub.h): `fincept-qt/src/datahub/DataHub.h`
- [Authentication](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/auth/AuthManager.h): `fincept-qt/src/auth/AuthManager.h`

### State & Sync

- [Storage settings](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/screens/settings/StorageSection.cpp): `fincept-qt/src/screens/settings/StorageSection.cpp`
- [Storage manager](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/storage/StorageManager.cpp): `fincept-qt/src/storage/StorageManager.cpp`
- [SQLite databases](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/storage/sqlite/Database.h): `fincept-qt/src/storage/sqlite/Database.h`
- [LLM profiles](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/storage/repositories/LlmProfileRepository.cpp): `fincept-qt/src/storage/repositories/LlmProfileRepository.cpp`
- [Secure storage](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/storage/secure/SecureStorage.cpp): `fincept-qt/src/storage/secure/SecureStorage.cpp`
- [Cloud sync](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/services/cloud/CloudSyncEngine.cpp): `fincept-qt/src/services/cloud/CloudSyncEngine.cpp`

### Other components

- **Terminal user**
- [Fincept Terminal](https://github.com/loop24infility/finceptterminal/blob/main/fincept-qt/src/app/main.cpp): `fincept-qt/src/app/main.cpp`

## Connections

- Terminal user → Fincept Terminal: uses
- Fincept Terminal → Market research: researches
- Fincept Terminal → Financial analytics: analyzes
- Fincept Terminal → Macro & global intelligence: explores
- Fincept Terminal → Portfolio management: manages
- Fincept Terminal → Quant & backtesting: backtests
- Fincept Terminal → Smart order routing: trades
- Fincept Terminal → LLM service: requests AI
- Fincept Terminal → Alpha Arena: runs agent research
- Fincept Terminal → Workflow expressions: automates
- Fincept Terminal → Data hub: shares updates
- Algo deployments → Data hub: publishes metrics (evidence: `fincept-qt/src/algo_engine/AlgoEngine.cpp`)
- LLM service → MCP tools: executes tools (evidence: `fincept-qt/src/services/llm/LlmService.cpp`)
- LLM service → Data hub: publishes streams (evidence: `fincept-qt/src/services/llm/LlmService.cpp`)
- Storage settings → Storage manager: manages data (evidence: `fincept-qt/src/screens/settings/StorageSection.cpp`)
- Storage manager → SQLite databases: uses databases (evidence: `fincept-qt/src/storage/StorageManager.cpp`)
- LLM profiles → Secure storage: stores API keys (evidence: `fincept-qt/src/storage/repositories/LlmProfileRepository.cpp`)
- LLM service → LLM profiles: loads profiles
- Cloud sync → Authentication: tracks credentials (evidence: `fincept-qt/src/services/cloud/CloudSyncEngine.cpp`)
- Cloud sync → SQLite databases: reads sync state (evidence: `fincept-qt/src/services/cloud/CloudSyncEngine.cpp`)
- Smart order routing → Broker integrations: routes orders
- Algo deployments → SQLite databases: persists deployments (evidence: `fincept-qt/src/algo_engine/AlgoEngine.cpp`)
