# Statistical Mapping & Statistical Volatility Documentation

## Overview
This website hosts the documentation and resources for the Statistical Mapping and Statistical Volatility indicators for TradingView. These tools provide statistical analysis of historical price behavior to project reversal levels and detect significant volatility events.

## Core Indicators

### 1. Statistical Mapping (/statmap)
Statistical Mapping analyzes historical sessions (default: 60 periods) to project likely price ranges and key levels for current and future periods.

**Key Concepts:**
- **Projection Levels:**
  - `[+] Distribution (+D)`: Average favorable upside extension.
  - `[-] Manipulation (-M)`: Average unfavorable upside wick.
  - `Open (O)`: Current period opening price.
  - `[+] Manipulation (+M)`: Average unfavorable downside wick.
  - `[-] Distribution (-D)`: Average favorable downside extension.
- **Methodology:** Uses historical data to identify where manipulation (trapping traders) and distribution (true move) typically occur relative to the open.
- **Features:**
  - **Multi-Timeframe Analysis:** Layer up to 3 standard timeframe projections.
  - **Custom Session Anchoring:** Project levels based on specific market hours (e.g., NY Open) rather than just standard candles.
  - **Liquidity Tracking:** Highlights swing highs/lows aligned with statistical levels and tracks when they are swept.

### 2. Statistical Volatility (/statvol)
Statistical Volatility tracks market activity to identify "displacement" events—moves that are statistically significant compared to historical norms.

**Key Concepts:**
- **Displacement Detection:** Highlights candles that exceed historical volatility thresholds.
- **Killzones:** Identifies specific times of day with consistently elevated volatility using a heatmap/histogram.
- **Visualizations:** Can be displayed as Fair Value Gaps (FVG), High-Low ranges, or Body-focused boxes.
- **Usage:** meaningful moves vs. noise; validating breakouts or exhaustion points.

## Site Structure for LLMs (localized)

Note: All content is localized. Default locale is English (no prefix). Other locales use prefixes: `/de`, `/fr`, `/zh`.

### English (default, no prefix)
- `/`: Home page with high-level overview, testimonials, pricing, and interactive demo.
- `/features`: Overview of the toolkit with comparison of both indicators.
- `/statmap`: Detailed documentation for Statistical Mapping (Demo, Logic, Settings).
- `/statvol`: Detailed documentation for Statistical Volatility (Demo, Settings, Lifecycle).
- `/resources`: Blog and educational articles index.
- `/resources/:slug`: Individual blog posts (dynamic routing).
- `/changelog`: Changelog for StatMap and StatVol versions (v1-v4).
- `/legal-information`: Privacy policy, terms of service, and impressum.
- `/chat`: Dedicated support chat page (on-site RAG assistant over StatMap docs).
- `/discord`: Forwarding page to Discord server.
- `/strength-comparison`: Forwarding page to Whop indicator.
- `/session-labels`: Forwarding page to Whop indicator.

### German (`/de`)
- `/de`: Startseite (lokalisierte Inhalte)
- `/de/features`: Funktionsübersicht
- `/de/statmap`: Statistische Mapping-Dokumentation (Demo, Logik, Settings)
- `/de/statvol`: Statistische Volatilität (Demo, Settings, Lifecycle)
- `/de/resources`: Blog-Index
- `/de/resources/:slug`: Blog-Posts (lokalisierte Slugs)
- `/de/changelog`: Changelog
- `/de/legal-information`: Rechtliches (Datenschutz, AGB, Impressum)
- `/de/chat`: Support-Chat
- `/de/discord`, `/de/strength-comparison`, `/de/session-labels`: Weiterleitungen

### French (`/fr`)
- `/fr`: Page d’accueil localisée
- `/fr/features`: Vue d’ensemble des fonctionnalités
- `/fr/statmap`: Documentation Statistical Mapping (démo, logique, réglages)
- `/fr/statvol`: Statistical Volatility (démo, réglages, cycle)
- `/fr/resources`: Index du blog
- `/fr/resources/:slug`: Articles de blog (slugs localisés)
- `/fr/changelog`: Journal des versions
- `/fr/legal-information`: Mentions légales / conditions / confidentialité
- `/fr/chat`: Support chat
- `/fr/discord`, `/fr/strength-comparison`, `/fr/session-labels`: Redirections

### Chinese (`/zh`)
- `/zh`: 本地化首页
- `/zh/features`: 功能概览
- `/zh/statmap`: Statistical Mapping 文档（演示、逻辑、设置）
- `/zh/statvol`: Statistical Volatility 文档（演示、设置、生命周期）
- `/zh/resources`: 博客索引
- `/zh/resources/:slug`: 博文（本地化 slug）
- `/zh/changelog`: 更新日志
- `/zh/legal-information`: 法律信息
- `/zh/chat`: 支持聊天
- `/zh/discord`, `/zh/strength-comparison`, `/zh/session-labels`: 跳转链接

## Key Components & Features

### Interactive Chart (`components/interactive-chart/`)
- TradingView-like candlestick chart built with React + SVG/Canvas.
- **Features:**
  - Real-time cursor crosshair with price labels.
  - Drag-to-pan and scroll-to-zoom functionality.
  - Rendering of StatMap levels (+D, -M, Open, +M, -D).
  - Rendering of StatVol displacement boxes.
  - Dark/Light mode support.
- **Usage:** Hero section, Feature highlights, and dedicated product pages (`/statmap`, `/statvol`).

### Scroll Sections (SEO & Navigation)
The site uses ID-based scroll sections for deep linking:
- **Home:** `#features`, `#testimonials`, `#pricing`, `#faq`
- **StatMap:** `#demo`, `#how-it-works`, `#levels`, `#settings`, `#advanced`, `#alerts`, `#usage`
- **StatVol:** `#demo`, `#settings`, `#alerts`, `#usage`
- **Changelog:** `#statmap-v4`, `#statvol-v4`
- **Legal:** `#privacy`, `#terms`, `#impressum`

### Support Chat
- On-site RAG assistant (`components/SupportChat.tsx` + `POST /api/chat`).
- Knowledge base: EN blog posts, `features_settings_v4.md`, EN FAQ (`npm run ingest:rag` → `api/_data/rag-index.json`).
- Floating corner bubble on all pages; full panel on `/chat` only.
- Processor: OpenAI (see `/legal-information`).

### Pricing
- **Monthly:** $45/month
- **Quarterly:** $39.67/month (billed quarterly)
- **Yearly:** $36.50/month (billed yearly)
- Managed via Whop integration.