# sittichainacc/cryptoproai architecture

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

- Interactive diagram: https://gitdiagram.com/sittichainacc/cryptoproai
- Repository: https://github.com/sittichainacc/cryptoproai

## Overview

CryptoPro AI is a cryptocurrency investment-intelligence dashboard: market data is synchronized from exchanges and public market feeds, analyzed into indicators, scores, rankings and trade plans, then exposed through API routes to interactive client pages. The repository also contains a substantial gold-analysis subsystem, including a multi-factor decision engine and historical backtesting, despite the README’s crypto-only product description. Unsampled page and engine internals are represented only at supported source paths; links for documented capabilities use the README where source call relationships were not shown.

Main entry points: [`server/src/services/market.service.ts`](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/services/market.service.ts) (Market Sync), [`server/src/routes/api.routes.ts`](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/routes/api.routes.ts) (Market API), [`server/src/engines/gold/gold_decision.engine.ts`](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_decision.engine.ts) (Gold Decisions), [`client/src/App.tsx`](https://github.com/sittichainacc/cryptoproai/blob/main/client/src/App.tsx) (Client App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Trading Terminal"]
  node_terminal["Client App<br/>[App.tsx]"]
  node_client_api["API Client<br/>[api.ts]"]
  node_terminal_pages["Analysis Pages"]
  node_gold_ui["Gold Signal UI<br/>[GoldSignalPage.tsx]"]
end

subgraph group_api["API and Market Data"]
  node_api_routes["Market API<br/>[api.routes.ts]"]
  node_gold_routes["Gold API<br/>[gold.routes.ts]"]
  node_market_service["Market Sync<br/>[market.service.ts]"]
  node_exchange_adapters["Exchange Adapters"]
  node_global_data["Global Metrics"]
end

subgraph group_analysis["Crypto Analysis"]
  node_scoring["Technical Scoring<br/>[scoring.engine.ts]"]
  node_ai_engine["AI Signals<br/>[ai.engine.ts]"]
  node_indicators["Indicator Matrix"]
  node_quant_premium["Quant Ranking"]
  node_ultimate["Top Candidates"]
end

subgraph group_gold["Gold Intelligence"]
  node_gold_decision["Gold Decisions"]
  node_gold_backtest["Gold Backtest"]
  node_gold_data["Gold Data Hub<br/>[gold_data_hub.ts]"]
  node_gold_market["Gold Market Data"]
  node_gold_technical["Gold Technicals"]
  node_gold_indicators["Gold Indicators<br/>[gold_indicators.ts]"]
  node_gold_calendar["Gold Calendar"]
end

subgraph group_state["Market State"]
  node_market_store[("Market Store<br/>[store.ts]")]
  node_sector_catalog["Sector Catalog<br/>[sectors.ts]"]
  node_gold_store[("Gold Cache<br/>[gold_store.ts]")]
end

node_investor(("Investor"))
node_external_markets(("Exchange and Market Feeds"))

node_investor -->|"uses"| node_terminal
node_terminal -.->|"requests data"| node_client_api
node_terminal -->|"renders"| node_terminal_pages
node_terminal -->|"renders"| node_gold_ui
node_client_api -.->|"calls REST"| node_api_routes
node_api_routes -->|"syncs market"| node_market_service
node_api_routes -->|"reads and writes"| node_market_store
node_api_routes -->|"requests indicators"| node_indicators
node_api_routes -->|"requests analysis"| node_quant_premium
node_api_routes -->|"qualifies candidates"| node_ultimate
node_market_service -->|"fetches exchange data"| node_exchange_adapters
node_market_service -->|"updates cache"| node_market_store
node_market_service -.->|"fetches global metrics"| node_global_data
node_market_service -->|"scores coins"| node_scoring
node_market_service -->|"generates signals"| node_ai_engine
node_exchange_adapters -.->|"fetches prices"| node_external_markets
node_market_service -->|"loads coin universe"| node_sector_catalog
node_gold_ui -.->|"requests gold data"| node_client_api
node_gold_routes -.->|"dispatches analysis"| node_gold_decision
node_gold_decision -->|"loads snapshot"| node_gold_market
node_gold_decision -->|"loads macro feeds"| node_gold_data
node_gold_decision -->|"loads calendar"| node_gold_calendar
node_gold_decision -->|"evaluates technicals"| node_gold_technical
node_gold_technical -->|"uses indicators"| node_gold_indicators
node_gold_market -->|"loads market data"| node_gold_data
node_gold_data -->|"reads and writes"| node_gold_store
node_gold_calendar -->|"reads cache"| node_gold_store
node_gold_backtest -->|"fetches history"| node_gold_data
node_gold_backtest -->|"loads event data"| node_gold_calendar
node_gold_backtest -->|"simulates indicators"| node_gold_indicators

click node_terminal "https://github.com/sittichainacc/cryptoproai/blob/main/client/src/App.tsx"
click node_client_api "https://github.com/sittichainacc/cryptoproai/blob/main/client/src/services/api.ts"
click node_terminal_pages "https://github.com/sittichainacc/cryptoproai/tree/main/client/src/pages"
click node_gold_ui "https://github.com/sittichainacc/cryptoproai/blob/main/client/src/pages/GoldSignalPage.tsx"
click node_api_routes "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/routes/api.routes.ts"
click node_gold_routes "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/routes/gold.routes.ts"
click node_market_service "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/services/market.service.ts"
click node_exchange_adapters "https://github.com/sittichainacc/cryptoproai/tree/main/server/src/adapters"
click node_global_data "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/adapters/global_data.adapter.ts"
click node_market_store "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/database/store.ts"
click node_sector_catalog "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/config/sectors.ts"
click node_scoring "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/scoring.engine.ts"
click node_ai_engine "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/ai.engine.ts"
click node_indicators "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/indicators.engine.ts"
click node_quant_premium "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/quant_premium.engine.ts"
click node_ultimate "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/ultimate_qualification.engine.ts"
click node_gold_decision "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_decision.engine.ts"
click node_gold_backtest "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_backtest.engine.ts"
click node_gold_data "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_data_hub.ts"
click node_gold_market "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_market_data.engine.ts"
click node_gold_technical "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_technical.engine.ts"
click node_gold_indicators "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_indicators.ts"
click node_gold_calendar "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_calendar.provider.ts"
click node_gold_store "https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_store.ts"

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_terminal,node_client_api,node_terminal_pages,node_gold_ui toneBlue
class node_api_routes,node_gold_routes,node_market_service,node_exchange_adapters,node_global_data toneAmber
class node_scoring,node_ai_engine,node_indicators,node_quant_premium,node_ultimate toneMint
class node_gold_decision,node_gold_backtest,node_gold_data,node_gold_market,node_gold_technical,node_gold_indicators,node_gold_calendar toneRose
class node_market_store,node_sector_catalog,node_gold_store,node_investor,node_external_markets toneIndigo
```

## Components

### Trading Terminal

- [Client App](https://github.com/sittichainacc/cryptoproai/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [API Client](https://github.com/sittichainacc/cryptoproai/blob/main/client/src/services/api.ts): `client/src/services/api.ts`
- [Analysis Pages](https://github.com/sittichainacc/cryptoproai/tree/main/client/src/pages): `client/src/pages`
- [Gold Signal UI](https://github.com/sittichainacc/cryptoproai/blob/main/client/src/pages/GoldSignalPage.tsx): `client/src/pages/GoldSignalPage.tsx`

### API and Market Data

- [Market API](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/routes/api.routes.ts): `server/src/routes/api.routes.ts`
- [Gold API](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/routes/gold.routes.ts): `server/src/routes/gold.routes.ts`
- [Market Sync](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/services/market.service.ts): `server/src/services/market.service.ts`
- [Exchange Adapters](https://github.com/sittichainacc/cryptoproai/tree/main/server/src/adapters): `server/src/adapters`
- [Global Metrics](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/adapters/global_data.adapter.ts): `server/src/adapters/global_data.adapter.ts`

### Crypto Analysis

- [Technical Scoring](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/scoring.engine.ts): `server/src/engines/scoring.engine.ts`
- [AI Signals](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/ai.engine.ts): `server/src/engines/ai.engine.ts`
- [Indicator Matrix](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/indicators.engine.ts): `server/src/engines/indicators.engine.ts`
- [Quant Ranking](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/quant_premium.engine.ts): `server/src/engines/quant_premium.engine.ts`
- [Top Candidates](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/ultimate_qualification.engine.ts): `server/src/engines/ultimate_qualification.engine.ts`

### Gold Intelligence

- [Gold Decisions](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_decision.engine.ts): `server/src/engines/gold/gold_decision.engine.ts`
- [Gold Backtest](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_backtest.engine.ts): `server/src/engines/gold/gold_backtest.engine.ts`
- [Gold Data Hub](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_data_hub.ts): `server/src/engines/gold/gold_data_hub.ts`
- [Gold Market Data](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_market_data.engine.ts): `server/src/engines/gold/gold_market_data.engine.ts`
- [Gold Technicals](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_technical.engine.ts): `server/src/engines/gold/gold_technical.engine.ts`
- [Gold Indicators](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_indicators.ts): `server/src/engines/gold/gold_indicators.ts`
- [Gold Calendar](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_calendar.provider.ts): `server/src/engines/gold/gold_calendar.provider.ts`

### Market State

- [Market Store](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/database/store.ts): `server/src/database/store.ts`
- [Sector Catalog](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/config/sectors.ts): `server/src/config/sectors.ts`
- [Gold Cache](https://github.com/sittichainacc/cryptoproai/blob/main/server/src/engines/gold/gold_store.ts): `server/src/engines/gold/gold_store.ts`

### Other components

- **Investor**
- **Exchange and Market Feeds**

## Connections

- Investor → Client App: uses (evidence: `README.md`)
- Client App → API Client: requests data (evidence: `README.md`)
- Client App → Analysis Pages: renders (evidence: `client/src/App.tsx`)
- Client App → Gold Signal UI: renders (evidence: `client/src/App.tsx`)
- API Client → Market API: calls REST (evidence: `README.md`)
- Market API → Market Sync: syncs market (evidence: `server/src/routes/api.routes.ts`)
- Market API → Market Store: reads and writes (evidence: `server/src/routes/api.routes.ts`)
- Market API → Indicator Matrix: requests indicators (evidence: `server/src/routes/api.routes.ts`)
- Market API → Quant Ranking: requests analysis (evidence: `server/src/routes/api.routes.ts`)
- Market API → Top Candidates: qualifies candidates (evidence: `server/src/routes/api.routes.ts`)
- Market Sync → Exchange Adapters: fetches exchange data (evidence: `server/src/services/market.service.ts`)
- Market Sync → Market Store: updates cache (evidence: `server/src/services/market.service.ts`)
- Market Sync → Global Metrics: fetches global metrics
- Market Sync → Technical Scoring: scores coins (evidence: `server/src/services/market.service.ts`)
- Market Sync → AI Signals: generates signals (evidence: `server/src/services/market.service.ts`)
- Exchange Adapters → Exchange and Market Feeds: fetches prices (evidence: `README.md`)
- Market Sync → Sector Catalog: loads coin universe (evidence: `server/src/services/market.service.ts`)
- Gold Signal UI → API Client: requests gold data
- Gold API → Gold Decisions: dispatches analysis (evidence: `server/src/routes/gold.routes.ts`)
- Gold Decisions → Gold Market Data: loads snapshot (evidence: `server/src/engines/gold/gold_decision.engine.ts`)
- Gold Decisions → Gold Data Hub: loads macro feeds (evidence: `server/src/engines/gold/gold_decision.engine.ts`)
- Gold Decisions → Gold Calendar: loads calendar (evidence: `server/src/engines/gold/gold_decision.engine.ts`)
- Gold Decisions → Gold Technicals: evaluates technicals (evidence: `server/src/engines/gold/gold_decision.engine.ts`)
- Gold Technicals → Gold Indicators: uses indicators (evidence: `server/src/engines/gold/gold_technical.engine.ts`)
- Gold Market Data → Gold Data Hub: loads market data (evidence: `server/src/engines/gold/gold_market_data.engine.ts`)
- Gold Data Hub → Gold Cache: reads and writes (evidence: `server/src/engines/gold/gold_data_hub.ts`)
- Gold Calendar → Gold Cache: reads cache (evidence: `server/src/engines/gold/gold_calendar.provider.ts`)
- Gold Backtest → Gold Data Hub: fetches history (evidence: `server/src/engines/gold/gold_backtest.engine.ts`)
- Gold Backtest → Gold Calendar: loads event data (evidence: `server/src/engines/gold/gold_backtest.engine.ts`)
- Gold Backtest → Gold Indicators: simulates indicators (evidence: `server/src/engines/gold/gold_backtest.engine.ts`)
