# vmwealthgroup-prog/vivan architecture

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

- Interactive diagram: https://gitdiagram.com/vmwealthgroup-prog/vivan
- Repository: https://github.com/vmwealthgroup-prog/vivan

## Overview

The repository contains a broader VM Algo trading application than the README’s TATA charting overview suggests. Its main workflow serves market history to signal and backtest APIs, while authenticated users can run paper-trading sessions and receive WebSocket updates. A separate webhook path validates incoming TradingView alerts and routes eligible orders through a paper broker. The graph includes the README-documented chart/API capability, but its implementation details are only partly evidenced by the sampled files and source index.

Main entry points: [`backend/app/main.py`](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/main.py) (Trading API), [`backend/app/backtest/backtester.py`](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/backtest/backtester.py) (Backtesting), [`backend/app/api/webhook.py`](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/api/webhook.py) (TradingView Webhook), [`backend/app/paper_trading/engine.py`](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/paper_trading/engine.py) (Paper Trading Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client Apps"]
  node_dashboard["Trading Dashboard<br/>[page.jsx]"]
  node_paper_ui["Paper Trading UI<br/>[page.jsx]"]
  node_auth_ui["Login and Registration<br/>[page.jsx]"]
  node_api_client["Frontend API Client<br/>[api.js]"]
  node_chart_app["Trading Charts<br/>[app.js]"]
  node_ws_hook["WebSocket Client Hook<br/>[useWebSocket.js]"]
end

subgraph group_api["API and Identity"]
  node_chart_server["Chart Data Server<br/>[server.js]"]
  node_fastapi["Trading API<br/>[main.py]"]
  node_auth_routes["Authentication Routes<br/>[routes.py]"]
  node_auth_service["Identity Service<br/>[service.py]"]
end

subgraph group_quant["Quant Analysis"]
  node_market_data["Market History<br/>[provider.py]"]
  node_indicators["Indicator Engine<br/>[engine.py]"]
  node_structure["Market Structure<br/>[structure.py]"]
  node_signals["Signal Confluence<br/>[confluence.py]"]
  node_backtest["Backtesting<br/>[backtester.py]"]
  node_regime["Market Regime<br/>[market_regime.py]"]
end

subgraph group_execution["Trading and Execution"]
  node_risk["Risk Management<br/>[rms.py]"]
  node_paper_engine["Paper Trading Engine<br/>[engine.py]"]
  node_webhook["TradingView Webhook<br/>[webhook.py]"]
  node_broker["Paper Broker<br/>[paper.py]"]
end

subgraph group_state["Persistence and Events"]
  node_database[("Application Database<br/>[db.py]")]
  node_schemas["Trading Data Models<br/>[schema.py]"]
  node_websocket["WebSocket Manager<br/>[manager.py]"]
end

node_user(("Trader"))
node_external_market(("Market Data Provider"))

node_user -->|"uses"| node_dashboard
node_user -->|"uses"| node_paper_ui
node_user -->|"signs in"| node_auth_ui
node_dashboard -->|"requests data"| node_api_client
node_paper_ui -->|"requests sessions"| node_api_client
node_paper_ui -->|"subscribes"| node_ws_hook
node_auth_ui -->|"calls auth"| node_api_client
node_api_client -->|"calls endpoints"| node_fastapi
node_chart_app -.->|"loads chart data"| node_chart_server
node_chart_server -.->|"fetches quotes"| node_external_market
node_fastapi -->|"loads history"| node_market_data
node_fastapi -->|"computes indicators"| node_indicators
node_fastapi -->|"analyzes structure"| node_structure
node_fastapi -->|"generates signals"| node_signals
node_fastapi -->|"runs backtests"| node_backtest
node_fastapi -->|"uses regime analysis"| node_regime
node_backtest -->|"uses indicators"| node_indicators
node_backtest -->|"uses structure"| node_structure
node_backtest -->|"uses regime"| node_regime
node_backtest -->|"uses signals"| node_signals
node_backtest -->|"uses risk rules"| node_risk
node_fastapi -->|"starts sessions"| node_paper_engine
node_paper_engine -->|"fetches bars"| node_market_data
node_paper_engine -->|"checks trades"| node_risk
node_paper_engine -->|"broadcasts events"| node_websocket
node_fastapi -->|"serves subscriptions"| node_websocket
node_webhook -->|"evaluates risk"| node_risk
node_webhook -->|"places orders"| node_broker
node_webhook -->|"broadcasts orders"| node_websocket
node_webhook -->|"persists records"| node_database
node_webhook -->|"uses models"| node_schemas
node_auth_routes -->|"delegates auth"| node_auth_service
node_auth_routes -->|"uses sessions"| node_database
node_auth_service -->|"persists identity"| node_database
node_fastapi -.->|"routes auth"| node_auth_routes
node_ws_hook -.->|"receives updates"| node_websocket

click node_dashboard "https://github.com/vmwealthgroup-prog/vivan/blob/main/frontend/app/dashboard/page.jsx"
click node_paper_ui "https://github.com/vmwealthgroup-prog/vivan/blob/main/frontend/app/paper-trading/page.jsx"
click node_auth_ui "https://github.com/vmwealthgroup-prog/vivan/blob/main/frontend/app/login/page.jsx"
click node_api_client "https://github.com/vmwealthgroup-prog/vivan/blob/main/frontend/app/lib/api.js"
click node_chart_app "https://github.com/vmwealthgroup-prog/vivan/blob/main/app.js"
click node_chart_server "https://github.com/vmwealthgroup-prog/vivan/blob/main/server.js"
click node_fastapi "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/main.py"
click node_auth_routes "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/auth/routes.py"
click node_auth_service "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/auth/service.py"
click node_market_data "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/market_data/provider.py"
click node_indicators "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/indicators/engine.py"
click node_structure "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/patterns/structure.py"
click node_signals "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/signals/confluence.py"
click node_backtest "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/backtest/backtester.py"
click node_regime "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/regime/market_regime.py"
click node_risk "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/risk/rms.py"
click node_paper_engine "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/paper_trading/engine.py"
click node_webhook "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/api/webhook.py"
click node_broker "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/broker/paper.py"
click node_database "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/db.py"
click node_schemas "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/models/schema.py"
click node_websocket "https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/websocket/manager.py"
click node_ws_hook "https://github.com/vmwealthgroup-prog/vivan/blob/main/frontend/app/hooks/useWebSocket.js"

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_dashboard,node_paper_ui,node_auth_ui,node_api_client,node_chart_app,node_ws_hook toneBlue
class node_chart_server,node_fastapi,node_auth_routes,node_auth_service toneAmber
class node_market_data,node_indicators,node_structure,node_signals,node_backtest,node_regime toneMint
class node_risk,node_paper_engine,node_webhook,node_broker toneRose
class node_database,node_schemas,node_websocket,node_user,node_external_market toneIndigo
```

## Components

### Client Apps

- [Trading Dashboard](https://github.com/vmwealthgroup-prog/vivan/blob/main/frontend/app/dashboard/page.jsx): `frontend/app/dashboard/page.jsx`
- [Paper Trading UI](https://github.com/vmwealthgroup-prog/vivan/blob/main/frontend/app/paper-trading/page.jsx): `frontend/app/paper-trading/page.jsx`
- [Login and Registration](https://github.com/vmwealthgroup-prog/vivan/blob/main/frontend/app/login/page.jsx): `frontend/app/login/page.jsx`
- [Frontend API Client](https://github.com/vmwealthgroup-prog/vivan/blob/main/frontend/app/lib/api.js): `frontend/app/lib/api.js`
- [Trading Charts](https://github.com/vmwealthgroup-prog/vivan/blob/main/app.js): `app.js`
- [WebSocket Client Hook](https://github.com/vmwealthgroup-prog/vivan/blob/main/frontend/app/hooks/useWebSocket.js): `frontend/app/hooks/useWebSocket.js`

### API and Identity

- [Chart Data Server](https://github.com/vmwealthgroup-prog/vivan/blob/main/server.js): `server.js`
- [Trading API](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication Routes](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/auth/routes.py): `backend/app/auth/routes.py`
- [Identity Service](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/auth/service.py): `backend/app/auth/service.py`

### Quant Analysis

- [Market History](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/market_data/provider.py): `backend/app/market_data/provider.py`
- [Indicator Engine](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/indicators/engine.py): `backend/app/indicators/engine.py`
- [Market Structure](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/patterns/structure.py): `backend/app/patterns/structure.py`
- [Signal Confluence](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/signals/confluence.py): `backend/app/signals/confluence.py`
- [Backtesting](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/backtest/backtester.py): `backend/app/backtest/backtester.py`
- [Market Regime](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/regime/market_regime.py): `backend/app/regime/market_regime.py`

### Trading and Execution

- [Risk Management](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/risk/rms.py): `backend/app/risk/rms.py`
- [Paper Trading Engine](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/paper_trading/engine.py): `backend/app/paper_trading/engine.py`
- [TradingView Webhook](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/api/webhook.py): `backend/app/api/webhook.py`
- [Paper Broker](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/broker/paper.py): `backend/app/broker/paper.py`

### Persistence and Events

- [Application Database](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/db.py): `backend/app/db.py`
- [Trading Data Models](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/models/schema.py): `backend/app/models/schema.py`
- [WebSocket Manager](https://github.com/vmwealthgroup-prog/vivan/blob/main/backend/app/websocket/manager.py): `backend/app/websocket/manager.py`

### Other components

- **Trader**
- **Market Data Provider**

## Connections

- Trader → Trading Dashboard: uses
- Trader → Paper Trading UI: uses
- Trader → Login and Registration: signs in
- Trading Dashboard → Frontend API Client: requests data (evidence: `frontend/app/dashboard/page.jsx`)
- Paper Trading UI → Frontend API Client: requests sessions (evidence: `frontend/app/paper-trading/page.jsx`)
- Paper Trading UI → WebSocket Client Hook: subscribes (evidence: `frontend/app/paper-trading/page.jsx`)
- Login and Registration → Frontend API Client: calls auth (evidence: `frontend/app/login/page.jsx`)
- Frontend API Client → Trading API: calls endpoints (evidence: `frontend/app/lib/api.js`)
- Trading Charts → Chart Data Server: loads chart data
- Chart Data Server → Market Data Provider: fetches quotes
- Trading API → Market History: loads history (evidence: `backend/app/main.py`)
- Trading API → Indicator Engine: computes indicators (evidence: `backend/app/main.py`)
- Trading API → Market Structure: analyzes structure (evidence: `backend/app/main.py`)
- Trading API → Signal Confluence: generates signals (evidence: `backend/app/main.py`)
- Trading API → Backtesting: runs backtests (evidence: `backend/app/main.py`)
- Trading API → Market Regime: uses regime analysis (evidence: `backend/app/main.py`)
- Backtesting → Indicator Engine: uses indicators (evidence: `backend/app/backtest/backtester.py`)
- Backtesting → Market Structure: uses structure (evidence: `backend/app/backtest/backtester.py`)
- Backtesting → Market Regime: uses regime (evidence: `backend/app/backtest/backtester.py`)
- Backtesting → Signal Confluence: uses signals (evidence: `backend/app/backtest/backtester.py`)
- Backtesting → Risk Management: uses risk rules (evidence: `backend/app/backtest/backtester.py`)
- Trading API → Paper Trading Engine: starts sessions (evidence: `backend/app/main.py`)
- Paper Trading Engine → Market History: fetches bars (evidence: `backend/app/paper_trading/engine.py`)
- Paper Trading Engine → Risk Management: checks trades (evidence: `backend/app/paper_trading/engine.py`)
- Paper Trading Engine → WebSocket Manager: broadcasts events (evidence: `backend/app/main.py`)
- Trading API → WebSocket Manager: serves subscriptions (evidence: `backend/app/main.py`)
- TradingView Webhook → Risk Management: evaluates risk (evidence: `backend/app/api/webhook.py`)
- TradingView Webhook → Paper Broker: places orders (evidence: `backend/app/api/webhook.py`)
- TradingView Webhook → WebSocket Manager: broadcasts orders (evidence: `backend/app/api/webhook.py`)
- TradingView Webhook → Application Database: persists records (evidence: `backend/app/api/webhook.py`)
- TradingView Webhook → Trading Data Models: uses models (evidence: `backend/app/api/webhook.py`)
- Authentication Routes → Identity Service: delegates auth (evidence: `backend/app/auth/routes.py`)
- Authentication Routes → Application Database: uses sessions (evidence: `backend/app/auth/routes.py`)
- Identity Service → Application Database: persists identity (evidence: `backend/app/auth/service.py`)
- Trading API → Authentication Routes: routes auth
- WebSocket Client Hook → WebSocket Manager: receives updates
