# munquantsociety/backtest_visualiser_fe architecture

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

- Interactive diagram: https://gitdiagram.com/munquantsociety/backtest_visualiser_fe
- Repository: https://github.com/munquantsociety/backtest_visualiser_fe

## Overview

MQS Frontend is a React application with two distinct user workflows: explore simulated strategy backtests at `/`, and inspect real-money MQS Master portfolios and system health under `/live`. The router maps these routes to pages; backtest creation is initiated in the run form, while analysis, comparison, and live monitoring are separate product stages. Shared authentication, API/query infrastructure, and performance visualizations support both products. Feature-to-page links not shown in sampled source are marked unverified; the README documents major capabilities and shared chart use.

Main entry points: [`src/app/router/index.tsx`](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/app/router/index.tsx) (Route dispatch), [`src/pages/dashboard-page.tsx`](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/dashboard-page.tsx) (Backtest dashboard), [`src/pages/live-overview-page.tsx`](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/live-overview-page.tsx) (Live overview), [`src/pages/portfolio-detail-page.tsx`](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/portfolio-detail-page.tsx) (Portfolio detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and auth"]
  node_router["Route dispatch<br/>[index.tsx]"]
  node_auth["Sign-in session<br/>[auth-session.ts]"]
  node_authui["Auth pages<br/>[index.tsx]"]
end

subgraph group_backtests["Backtest product"]
  node_dashboard["Backtest dashboard<br/>[dashboard-page.tsx]"]
  node_runform["Run configuration"]
  node_backtestapi["Backtest API<br/>[backtests-api.ts]"]
  node_runs["Run library<br/>[library-page.tsx]"]
  node_detail["Run report"]
  node_compare["Run comparison<br/>[compare-page.tsx]"]
  node_strategies["Strategy editor"]
end

subgraph group_live["MQS Master"]
  node_liveoverview["Live overview"]
  node_portfolios["Portfolio views"]
  node_portfoliodetail["Portfolio detail"]
  node_system["Health and logs"]
end

subgraph group_shared["Shared capabilities"]
  node_market["Market news"]
  node_performance["Performance charts"]
end

subgraph group_platform["Runtime platform"]
  node_api["HTTP client<br/>[api-client.ts]"]
  node_query["Query cache<br/>[query-client.ts]"]
end

node_user(("User"))
node_backend[("MQS API")]
node_authservice["OIDC provider"]

node_user -->|"navigates"| node_router
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_runs
node_router -->|"routes to"| node_detail
node_router -->|"routes to"| node_compare
node_router -->|"routes to"| node_liveoverview
node_router -->|"routes to"| node_portfoliodetail
node_dashboard -.->|"starts runs"| node_runform
node_runform -->|"validates tickers"| node_backtestapi
node_backtestapi -.->|"requests data"| node_backend
node_dashboard -->|"uses capability"| node_market
node_dashboard -->|"uses capability"| node_strategies
node_detail -.->|"renders analysis"| node_performance
node_compare -.->|"compares metrics"| node_performance
node_liveoverview -.->|"shows portfolios"| node_portfolios
node_portfoliodetail -.->|"shows details"| node_portfolios
node_portfoliodetail -->|"renders charts"| node_performance
node_liveoverview -.->|"shows health"| node_system
node_user -->|"signs in"| node_authui
node_authui -->|"completes sign-in"| node_auth
node_auth -->|"uses OIDC"| node_authservice
node_api -.->|"sends requests"| node_backend
node_query -->|"handles failures"| node_api

click node_router "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/app/router/index.tsx"
click node_auth "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/lib/auth-session.ts"
click node_authui "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/LoginPage/index.tsx"
click node_dashboard "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/dashboard-page.tsx"
click node_runform "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/features/backtests/run-backtest-form.tsx"
click node_backtestapi "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/features/backtests/backtests-api.ts"
click node_runs "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/library-page.tsx"
click node_detail "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/backtest-detail-page.tsx"
click node_compare "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/compare-page.tsx"
click node_strategies "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/features/strategies/components/strategy-editor.tsx"
click node_market "https://github.com/munquantsociety/backtest_visualiser_fe/tree/main/src/features/market"
click node_liveoverview "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/live-overview-page.tsx"
click node_portfolios "https://github.com/munquantsociety/backtest_visualiser_fe/tree/main/src/features/portfolios"
click node_portfoliodetail "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/portfolio-detail-page.tsx"
click node_system "https://github.com/munquantsociety/backtest_visualiser_fe/tree/main/src/features/system"
click node_performance "https://github.com/munquantsociety/backtest_visualiser_fe/tree/main/src/features/performance"
click node_api "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/lib/api-client.ts"
click node_query "https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/lib/query-client.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_router,node_auth,node_authui,node_user toneBlue
class node_dashboard,node_runform,node_backtestapi,node_runs,node_detail,node_compare,node_strategies,node_backend toneAmber
class node_liveoverview,node_portfolios,node_portfoliodetail,node_system toneMint
class node_market,node_performance toneRose
class node_api,node_query,node_authservice toneIndigo
```

## Components

### App and auth

- [Route dispatch](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/app/router/index.tsx): `src/app/router/index.tsx`
- [Sign-in session](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/lib/auth-session.ts): `src/lib/auth-session.ts`
- [Auth pages](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/LoginPage/index.tsx): `src/pages/LoginPage/index.tsx`

### Backtest product

- [Backtest dashboard](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/dashboard-page.tsx): `src/pages/dashboard-page.tsx`
- [Run configuration](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/features/backtests/run-backtest-form.tsx): `src/features/backtests/run-backtest-form.tsx`
- [Backtest API](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/features/backtests/backtests-api.ts): `src/features/backtests/backtests-api.ts`
- [Run library](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/library-page.tsx): `src/pages/library-page.tsx`
- [Run report](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/backtest-detail-page.tsx): `src/pages/backtest-detail-page.tsx`
- [Run comparison](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/compare-page.tsx): `src/pages/compare-page.tsx`
- [Strategy editor](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/features/strategies/components/strategy-editor.tsx): `src/features/strategies/components/strategy-editor.tsx`

### MQS Master

- [Live overview](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/live-overview-page.tsx): `src/pages/live-overview-page.tsx`
- [Portfolio views](https://github.com/munquantsociety/backtest_visualiser_fe/tree/main/src/features/portfolios): `src/features/portfolios`
- [Portfolio detail](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/pages/portfolio-detail-page.tsx): `src/pages/portfolio-detail-page.tsx`
- [Health and logs](https://github.com/munquantsociety/backtest_visualiser_fe/tree/main/src/features/system): `src/features/system`

### Shared capabilities

- [Market news](https://github.com/munquantsociety/backtest_visualiser_fe/tree/main/src/features/market): `src/features/market`
- [Performance charts](https://github.com/munquantsociety/backtest_visualiser_fe/tree/main/src/features/performance): `src/features/performance`

### Runtime platform

- [HTTP client](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/lib/api-client.ts): `src/lib/api-client.ts`
- [Query cache](https://github.com/munquantsociety/backtest_visualiser_fe/blob/main/src/lib/query-client.ts): `src/lib/query-client.ts`

### Other components

- **User**
- **MQS API**
- **OIDC provider**

## Connections

- User → Route dispatch: navigates (evidence: `src/app/router/index.tsx`)
- Route dispatch → Backtest dashboard: routes to (evidence: `src/app/router/index.tsx`)
- Route dispatch → Run library: routes to (evidence: `src/app/router/index.tsx`)
- Route dispatch → Run report: routes to (evidence: `src/app/router/index.tsx`)
- Route dispatch → Run comparison: routes to (evidence: `src/app/router/index.tsx`)
- Route dispatch → Live overview: routes to (evidence: `src/app/router/index.tsx`)
- Route dispatch → Portfolio detail: routes to (evidence: `src/app/router/index.tsx`)
- Backtest dashboard → Run configuration: starts runs
- Run configuration → Backtest API: validates tickers (evidence: `src/features/backtests/run-backtest-form.tsx`)
- Backtest API → MQS API: requests data (evidence: `README.md`)
- Backtest dashboard → Market news: uses capability (evidence: `src/pages/dashboard-page.tsx`)
- Backtest dashboard → Strategy editor: uses capability (evidence: `src/pages/dashboard-page.tsx`)
- Run report → Performance charts: renders analysis (evidence: `README.md`)
- Run comparison → Performance charts: compares metrics (evidence: `README.md`)
- Live overview → Portfolio views: shows portfolios (evidence: `README.md`)
- Portfolio detail → Portfolio views: shows details (evidence: `README.md`)
- Portfolio detail → Performance charts: renders charts (evidence: `README.md`)
- Live overview → Health and logs: shows health (evidence: `README.md`)
- User → Auth pages: signs in (evidence: `README.md`)
- Auth pages → Sign-in session: completes sign-in (evidence: `src/pages/LoginPage/index.tsx`)
- Sign-in session → OIDC provider: uses OIDC (evidence: `src/lib/auth-session.ts`)
- HTTP client → MQS API: sends requests (evidence: `README.md`)
- Query cache → HTTP client: handles failures (evidence: `src/lib/query-client.ts`)
