# vighnesh-6/indian_equities_liquidity_risk_ml-main architecture

> Architecture diagram of the GitHub repository vighnesh-6/indian_equities_liquidity_risk_ml-main, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vighnesh-6/indian_equities_liquidity_risk_ml-main
- Repository: https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main

## Overview

This repository is a decision-support platform for liquidity and trading-risk intelligence across Indian equities. Its main workflow is to collect and validate market data, engineer features, produce rule-based liquidity scores and forward-risk/anomaly analyses, then present results through a five-view Streamlit dashboard. A separate production ingestion subsystem handles scheduled and catch-up collection with PostgreSQL persistence. The README documents the product branches; several runtime modules and dashboard pages were not sampled, so their internal wiring is not asserted.

Main entry points: [`src/features/engineer.py`](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/features/engineer.py) (Feature orchestrator), [`app/streamlit_app.py`](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/streamlit_app.py) (Streamlit entry), [`src/modeling/trainer.py`](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/modeling/trainer.py) (Walk-forward training), [`production/pipeline/ingestion.py`](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/ingestion.py) (Session ingestion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Market Data"]
  node_market(("Market data sources"))
  node_fetcher["Market fetcher<br/>[fetcher.py]"]
  node_validation["Data validation<br/>[validator.py]"]
  node_universe["Stock universe<br/>[universe.py]"]
  node_events["Market events<br/>[events.py]"]
  node_local_store[("Parquet storage<br/>[storage.py]")]
end

subgraph group_analytics["Risk Analytics"]
  node_feature_engine["Feature orchestrator<br/>[engineer.py]"]
  node_feature_helpers["Feature helpers<br/>[_common.py]"]
  node_market_stress["Market stress features<br/>[market_stress.py]"]
  node_volatility["Volatility features<br/>[volatility.py]"]
  node_lrs["Liquidity score<br/>[lrs.py]"]
  node_targets["Risk targets<br/>[targets.py]"]
  node_preprocessing["Model preprocessing<br/>[preprocessing.py]"]
  node_trainer["Walk-forward training<br/>[trainer.py]"]
  node_evaluation["Model evaluation<br/>[evaluation.py]"]
  node_anomaly["Anomaly detection<br/>[anomaly.py]"]
  node_phase9["Event and stress analysis"]
  node_daily_pipeline["Daily risk pipeline<br/>[daily_pipeline.py]"]
end

subgraph group_production["Production Ingestion"]
  node_prod_ingestion["Session ingestion<br/>[ingestion.py]"]
  node_prod_provider["Market provider<br/>[provider.py]"]
  node_prod_calendar["NSE calendar<br/>[nse_calendar.py]"]
  node_prod_repository["Transactional repository<br/>[repository.py]"]
  node_prod_database[("PostgreSQL access<br/>[database.py]")]
  node_prod_config["Database settings<br/>[config.py]"]
  node_prod_history["Historical import"]
  node_prod_migrate["Schema migration<br/>[migrate.py]"]
end

subgraph group_presentation["Dashboard"]
  node_dashboard["Streamlit entry<br/>[streamlit_app.py]"]
  node_overview["Market overview<br/>[1_Overview.py]"]
  node_stock_detail["Stock detail<br/>[2_Stock_Detail.py]"]
  node_portfolio["Portfolio risk"]
  node_anomaly_log["Anomaly log<br/>[4_Anomaly_Log.py]"]
  node_data_quality["Data quality<br/>[5_Data_Quality.py]"]
  node_charts["Dashboard charts<br/>[charts.py]"]
  node_filters["Dashboard filters<br/>[filters.py]"]
end

node_market -->|"provides prices"| node_fetcher
node_fetcher -.->|"validates data"| node_validation
node_validation -.->|"supplies OHLCV"| node_feature_engine
node_universe -->|"sets universe"| node_feature_engine
node_feature_engine -->|"uses helpers"| node_feature_helpers
node_feature_engine -->|"computes features"| node_market_stress
node_feature_engine -->|"computes features"| node_volatility
node_feature_engine -->|"writes features"| node_local_store
node_feature_engine -.->|"feeds scoring"| node_lrs
node_feature_engine -.->|"feeds targets"| node_targets
node_lrs -.->|"scores liquidity"| node_daily_pipeline
node_targets -.->|"defines outcomes"| node_trainer
node_trainer -->|"uses pipelines"| node_preprocessing
node_trainer -->|"evaluates folds"| node_evaluation
node_trainer -->|"fits detector"| node_anomaly
node_events -.->|"supports event studies"| node_phase9
node_market_stress -.->|"supports stress analysis"| node_phase9
node_daily_pipeline -.->|"supplies risk views"| node_dashboard
node_prod_ingestion -->|"requests quotes"| node_prod_provider
node_prod_ingestion -->|"plans sessions"| node_prod_calendar
node_prod_ingestion -->|"persists sessions"| node_prod_repository
node_prod_repository -->|"runs transactions"| node_prod_database
node_prod_database -->|"loads settings"| node_prod_config
node_prod_history -->|"imports history"| node_prod_repository
node_prod_history -->|"uses migrations"| node_prod_migrate
node_prod_history -->|"writes history"| node_prod_database
node_dashboard -.->|"routes to view"| node_overview
node_dashboard -.->|"routes to view"| node_stock_detail
node_dashboard -.->|"routes to view"| node_portfolio
node_dashboard -.->|"routes to view"| node_anomaly_log
node_dashboard -.->|"routes to view"| node_data_quality
node_overview -.->|"renders charts"| node_charts
node_stock_detail -.->|"uses filters"| node_filters

click node_fetcher "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/data/fetcher.py"
click node_validation "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/data/validator.py"
click node_universe "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/data/universe.py"
click node_events "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/data/events.py"
click node_feature_engine "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/features/engineer.py"
click node_feature_helpers "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/features/_common.py"
click node_market_stress "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/features/market_stress.py"
click node_volatility "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/features/volatility.py"
click node_lrs "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/labels/lrs.py"
click node_targets "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/labels/targets.py"
click node_preprocessing "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/modeling/preprocessing.py"
click node_trainer "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/modeling/trainer.py"
click node_evaluation "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/modeling/evaluation.py"
click node_anomaly "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/modeling/anomaly.py"
click node_phase9 "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/tree/main/src/modeling/phase9"
click node_daily_pipeline "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/pipeline/daily_pipeline.py"
click node_local_store "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/data/storage.py"
click node_prod_ingestion "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/ingestion.py"
click node_prod_provider "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/provider.py"
click node_prod_calendar "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/nse_calendar.py"
click node_prod_repository "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/repository.py"
click node_prod_database "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/database.py"
click node_prod_config "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/config.py"
click node_prod_history "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/historical_import.py"
click node_prod_migrate "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/migrate.py"
click node_dashboard "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/streamlit_app.py"
click node_overview "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/pages/1_Overview.py"
click node_stock_detail "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/pages/2_Stock_Detail.py"
click node_portfolio "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/pages/3_Portfolio_Risk.py"
click node_anomaly_log "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/pages/4_Anomaly_Log.py"
click node_data_quality "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/pages/5_Data_Quality.py"
click node_charts "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/components/charts.py"
click node_filters "https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/components/filters.py"

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,node_fetcher,node_validation,node_universe,node_events,node_local_store toneBlue
class node_feature_engine,node_feature_helpers,node_market_stress,node_volatility,node_lrs,node_targets,node_preprocessing,node_trainer,node_evaluation,node_anomaly,node_phase9,node_daily_pipeline toneAmber
class node_prod_ingestion,node_prod_provider,node_prod_calendar,node_prod_repository,node_prod_database,node_prod_config,node_prod_history,node_prod_migrate toneMint
class node_dashboard,node_overview,node_stock_detail,node_portfolio,node_anomaly_log,node_data_quality,node_charts,node_filters toneRose
```

## Components

### Market Data

- **Market data sources**
- [Market fetcher](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/data/fetcher.py): `src/data/fetcher.py`
- [Data validation](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/data/validator.py): `src/data/validator.py`
- [Stock universe](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/data/universe.py): `src/data/universe.py`
- [Market events](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/data/events.py): `src/data/events.py`
- [Parquet storage](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/data/storage.py): `src/data/storage.py`

### Risk Analytics

- [Feature orchestrator](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/features/engineer.py): `src/features/engineer.py`
- [Feature helpers](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/features/_common.py): `src/features/_common.py`
- [Market stress features](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/features/market_stress.py): `src/features/market_stress.py`
- [Volatility features](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/features/volatility.py): `src/features/volatility.py`
- [Liquidity score](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/labels/lrs.py): `src/labels/lrs.py`
- [Risk targets](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/labels/targets.py): `src/labels/targets.py`
- [Model preprocessing](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/modeling/preprocessing.py): `src/modeling/preprocessing.py`
- [Walk-forward training](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/modeling/trainer.py): `src/modeling/trainer.py`
- [Model evaluation](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/modeling/evaluation.py): `src/modeling/evaluation.py`
- [Anomaly detection](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/modeling/anomaly.py): `src/modeling/anomaly.py`
- [Event and stress analysis](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/tree/main/src/modeling/phase9): `src/modeling/phase9`
- [Daily risk pipeline](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/src/pipeline/daily_pipeline.py): `src/pipeline/daily_pipeline.py`

### Production Ingestion

- [Session ingestion](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/ingestion.py): `production/pipeline/ingestion.py`
- [Market provider](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/provider.py): `production/pipeline/provider.py`
- [NSE calendar](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/nse_calendar.py): `production/pipeline/nse_calendar.py`
- [Transactional repository](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/repository.py): `production/pipeline/repository.py`
- [PostgreSQL access](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/database.py): `production/pipeline/database.py`
- [Database settings](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/config.py): `production/pipeline/config.py`
- [Historical import](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/historical_import.py): `production/pipeline/historical_import.py`
- [Schema migration](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/production/pipeline/migrate.py): `production/pipeline/migrate.py`

### Dashboard

- [Streamlit entry](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/streamlit_app.py): `app/streamlit_app.py`
- [Market overview](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/pages/1_Overview.py): `app/pages/1_Overview.py`
- [Stock detail](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/pages/2_Stock_Detail.py): `app/pages/2_Stock_Detail.py`
- [Portfolio risk](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/pages/3_Portfolio_Risk.py): `app/pages/3_Portfolio_Risk.py`
- [Anomaly log](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/pages/4_Anomaly_Log.py): `app/pages/4_Anomaly_Log.py`
- [Data quality](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/pages/5_Data_Quality.py): `app/pages/5_Data_Quality.py`
- [Dashboard charts](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/components/charts.py): `app/components/charts.py`
- [Dashboard filters](https://github.com/vighnesh-6/indian_equities_liquidity_risk_ml-main/blob/main/app/components/filters.py): `app/components/filters.py`

## Connections

- Market data sources → Market fetcher: provides prices (evidence: `README.md`)
- Market fetcher → Data validation: validates data
- Data validation → Feature orchestrator: supplies OHLCV
- Stock universe → Feature orchestrator: sets universe (evidence: `src/features/engineer.py`)
- Feature orchestrator → Feature helpers: uses helpers (evidence: `src/features/engineer.py`)
- Feature orchestrator → Market stress features: computes features (evidence: `src/features/engineer.py`)
- Feature orchestrator → Volatility features: computes features (evidence: `src/features/engineer.py`)
- Feature orchestrator → Parquet storage: writes features (evidence: `src/features/engineer.py`)
- Feature orchestrator → Liquidity score: feeds scoring
- Feature orchestrator → Risk targets: feeds targets
- Liquidity score → Daily risk pipeline: scores liquidity
- Risk targets → Walk-forward training: defines outcomes
- Walk-forward training → Model preprocessing: uses pipelines (evidence: `src/modeling/trainer.py`)
- Walk-forward training → Model evaluation: evaluates folds (evidence: `src/modeling/trainer.py`)
- Walk-forward training → Anomaly detection: fits detector (evidence: `src/modeling/trainer.py`)
- Market events → Event and stress analysis: supports event studies
- Market stress features → Event and stress analysis: supports stress analysis
- Daily risk pipeline → Streamlit entry: supplies risk views
- Session ingestion → Market provider: requests quotes (evidence: `production/pipeline/ingestion.py`)
- Session ingestion → NSE calendar: plans sessions (evidence: `production/pipeline/ingestion.py`)
- Session ingestion → Transactional repository: persists sessions (evidence: `production/pipeline/ingestion.py`)
- Transactional repository → PostgreSQL access: runs transactions (evidence: `production/pipeline/repository.py`)
- PostgreSQL access → Database settings: loads settings (evidence: `production/pipeline/database.py`)
- Historical import → Transactional repository: imports history (evidence: `production/pipeline/historical_import.py`)
- Historical import → Schema migration: uses migrations (evidence: `production/pipeline/historical_import.py`)
- Historical import → PostgreSQL access: writes history (evidence: `production/pipeline/historical_import.py`)
- Streamlit entry → Market overview: routes to view
- Streamlit entry → Stock detail: routes to view
- Streamlit entry → Portfolio risk: routes to view
- Streamlit entry → Anomaly log: routes to view
- Streamlit entry → Data quality: routes to view
- Market overview → Dashboard charts: renders charts
- Stock detail → Dashboard filters: uses filters
