# baalugudipati/ipl-analytics-score architecture

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

- Interactive diagram: https://gitdiagram.com/baalugudipati/ipl-analytics-score
- Repository: https://github.com/baalugudipati/ipl-analytics-score

## Overview

This repository is a small IPL cricket data and analysis pipeline. Its workflow downloads or reads Cricsheet JSON, parses recent seasons into DuckDB, then runs expected-runs evaluations and batter/bowler performance rankings; a separate script checks the loaded data. The README is empty, and the SQL model file was not excerpted, so its contents and any additional transformations are unknown. Edges below reflect only relationships visible in the provided source excerpts.

Main entry points: [`ingestion/load_cricsheet.py`](https://github.com/baalugudipati/ipl-analytics-score/blob/main/ingestion/load_cricsheet.py) (Load Cricsheet), [`analysis/expected_runs_model.py`](https://github.com/baalugudipati/ipl-analytics-score/blob/main/analysis/expected_runs_model.py) (Expected runs), [`analysis/runs_above_expected.py`](https://github.com/baalugudipati/ipl-analytics-score/blob/main/analysis/runs_above_expected.py) (Player rankings), [`checks/run_checks.py`](https://github.com/baalugudipati/ipl-analytics-score/blob/main/checks/run_checks.py) (Data checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data pipeline"]
  node_loader["Load Cricsheet<br/>[load_cricsheet.py]"]
  node_models["SQL models<br/>[models.sql]"]
  node_db[("IPL database")]
end

subgraph group_analysis["Cricket analysis"]
  node_expected["Expected runs"]
  node_rankings["Player rankings"]
end

subgraph group_validation["Data checks"]
  node_checks["Data checks<br/>[run_checks.py]"]
end

node_cricsheet(("Cricsheet"))

node_cricsheet -->|"provides JSON"| node_loader
node_loader -->|"executes SQL"| node_models
node_loader -->|"writes tables"| node_db
node_expected -->|"reads data"| node_db
node_rankings -->|"reads data"| node_db
node_checks -->|"checks tables"| node_db

click node_loader "https://github.com/baalugudipati/ipl-analytics-score/blob/main/ingestion/load_cricsheet.py"
click node_models "https://github.com/baalugudipati/ipl-analytics-score/blob/main/sql/models.sql"
click node_expected "https://github.com/baalugudipati/ipl-analytics-score/blob/main/analysis/expected_runs_model.py"
click node_rankings "https://github.com/baalugudipati/ipl-analytics-score/blob/main/analysis/runs_above_expected.py"
click node_checks "https://github.com/baalugudipati/ipl-analytics-score/blob/main/checks/run_checks.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_loader,node_models,node_db toneBlue
class node_expected,node_rankings toneAmber
class node_checks toneMint
class node_cricsheet toneIndigo
```

## Components

### Data pipeline

- [Load Cricsheet](https://github.com/baalugudipati/ipl-analytics-score/blob/main/ingestion/load_cricsheet.py): `ingestion/load_cricsheet.py`
- [SQL models](https://github.com/baalugudipati/ipl-analytics-score/blob/main/sql/models.sql): `sql/models.sql`
- **IPL database**

### Cricket analysis

- [Expected runs](https://github.com/baalugudipati/ipl-analytics-score/blob/main/analysis/expected_runs_model.py): `analysis/expected_runs_model.py`
- [Player rankings](https://github.com/baalugudipati/ipl-analytics-score/blob/main/analysis/runs_above_expected.py): `analysis/runs_above_expected.py`

### Data checks

- [Data checks](https://github.com/baalugudipati/ipl-analytics-score/blob/main/checks/run_checks.py): `checks/run_checks.py`

### Other components

- **Cricsheet**

## Connections

- Cricsheet → Load Cricsheet: provides JSON (evidence: `ingestion/load_cricsheet.py`)
- Load Cricsheet → SQL models: executes SQL (evidence: `ingestion/load_cricsheet.py`)
- Load Cricsheet → IPL database: writes tables (evidence: `ingestion/load_cricsheet.py`)
- Expected runs → IPL database: reads data (evidence: `analysis/expected_runs_model.py`)
- Player rankings → IPL database: reads data (evidence: `analysis/runs_above_expected.py`)
- Data checks → IPL database: checks tables (evidence: `checks/run_checks.py`)
