# vidit2004/pinelabs_task architecture

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

- Interactive diagram: https://gitdiagram.com/vidit2004/pinelabs_task
- Repository: https://github.com/vidit2004/pinelabs_task

## Overview

This repository implements a focused payment-success comparison workflow: a caller supplies bank and transaction CSVs plus a validated comparison plan; the fixture analyzer stages the CSV rows in temporary SQLite storage, checks data quality, queries eligible attempts, and summarizes overall rates and mix/performance contributions. The README also documents clean and intentionally broken fixture variants and the read-only, single-snapshot analysis behavior. The graph follows the shown Python calls and README example; it does not infer extra connections for unsampled files.

Main entry points: [`analyst/data.py`](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py) (Comparison runner), [`data/fixtures`](https://github.com/vidit2004/pinelabs_task/tree/main/data/fixtures) (Bank and attempt CSVs), [`analyst/analysis.py`](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/analysis.py) (Rate decomposition), [`analyst/plan.py`](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/plan.py) (Comparison plan)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Inputs and contract"]
  node_fixture_csv["Bank and attempt CSVs"]
  node_plan["Comparison plan<br/>[plan.py]"]
end

subgraph group_runtime["Comparison runtime"]
  node_fixture_analyzer["Fixture analyzer<br/>[data.py]"]
  node_stager["CSV staging<br/>[data.py]"]
  node_sqlite[("Temporary SQLite<br/>[data.py]")]
  node_query_compiler["Query compiler<br/>[queries.py]"]
  node_comparison["Comparison runner<br/>[data.py]"]
  node_quality_checks["Quality checks<br/>[data.py]"]
end

subgraph group_results["Analysis results"]
  node_bank_counts["Bank counts<br/>[analysis.py]"]
  node_summarizer["Rate decomposition<br/>[analysis.py]"]
  node_comparison_result["Comparison result<br/>[analysis.py]"]
end

node_caller(("Analysis caller"))

node_caller -->|"defines windows"| node_plan
node_caller -->|"calls analysis"| node_fixture_analyzer
node_caller -->|"selects fixture"| node_fixture_csv
node_fixture_analyzer -->|"stages rows"| node_stager
node_fixture_csv -->|"reads CSVs"| node_stager
node_stager -->|"writes tables"| node_sqlite
node_fixture_analyzer -->|"runs comparison"| node_comparison
node_comparison -->|"uses plan"| node_plan
node_comparison -->|"compiles queries"| node_query_compiler
node_comparison -->|"queries read-only"| node_sqlite
node_comparison -->|"checks data"| node_quality_checks
node_comparison -->|"builds counts"| node_bank_counts
node_comparison -->|"summarizes counts"| node_summarizer
node_summarizer -->|"returns comparison"| node_comparison_result
node_fixture_analyzer -->|"returns result"| node_comparison_result

click node_fixture_csv "https://github.com/vidit2004/pinelabs_task/tree/main/data/fixtures"
click node_plan "https://github.com/vidit2004/pinelabs_task/blob/main/analyst/plan.py"
click node_fixture_analyzer "https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py"
click node_stager "https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py"
click node_sqlite "https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py"
click node_query_compiler "https://github.com/vidit2004/pinelabs_task/blob/main/analyst/queries.py"
click node_comparison "https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py"
click node_quality_checks "https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py"
click node_bank_counts "https://github.com/vidit2004/pinelabs_task/blob/main/analyst/analysis.py"
click node_summarizer "https://github.com/vidit2004/pinelabs_task/blob/main/analyst/analysis.py"
click node_comparison_result "https://github.com/vidit2004/pinelabs_task/blob/main/analyst/analysis.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_fixture_csv,node_plan toneBlue
class node_fixture_analyzer,node_stager,node_sqlite,node_query_compiler,node_comparison,node_quality_checks toneAmber
class node_bank_counts,node_summarizer,node_comparison_result toneMint
class node_caller toneIndigo
```

## Components

### Inputs and contract

- [Bank and attempt CSVs](https://github.com/vidit2004/pinelabs_task/tree/main/data/fixtures): `data/fixtures`
- [Comparison plan](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/plan.py): `analyst/plan.py`

### Comparison runtime

- [Fixture analyzer](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py): `analyst/data.py`
- [CSV staging](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py): `analyst/data.py`
- [Temporary SQLite](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py): `analyst/data.py`
- [Query compiler](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/queries.py): `analyst/queries.py`
- [Comparison runner](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py): `analyst/data.py`
- [Quality checks](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/data.py): `analyst/data.py`

### Analysis results

- [Bank counts](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/analysis.py): `analyst/analysis.py`
- [Rate decomposition](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/analysis.py): `analyst/analysis.py`
- [Comparison result](https://github.com/vidit2004/pinelabs_task/blob/main/analyst/analysis.py): `analyst/analysis.py`

### Other components

- **Analysis caller**

## Connections

- Analysis caller → Comparison plan: defines windows (evidence: `README.md`)
- Analysis caller → Fixture analyzer: calls analysis (evidence: `README.md`)
- Analysis caller → Bank and attempt CSVs: selects fixture (evidence: `README.md`)
- Fixture analyzer → CSV staging: stages rows (evidence: `analyst/data.py`)
- Bank and attempt CSVs → CSV staging: reads CSVs (evidence: `analyst/data.py`)
- CSV staging → Temporary SQLite: writes tables (evidence: `analyst/data.py`)
- Fixture analyzer → Comparison runner: runs comparison (evidence: `analyst/data.py`)
- Comparison runner → Comparison plan: uses plan (evidence: `analyst/data.py`)
- Comparison runner → Query compiler: compiles queries (evidence: `analyst/data.py`)
- Comparison runner → Temporary SQLite: queries read-only (evidence: `analyst/data.py`)
- Comparison runner → Quality checks: checks data (evidence: `analyst/data.py`)
- Comparison runner → Bank counts: builds counts (evidence: `analyst/data.py`)
- Comparison runner → Rate decomposition: summarizes counts (evidence: `analyst/data.py`)
- Rate decomposition → Comparison result: returns comparison (evidence: `analyst/analysis.py`)
- Fixture analyzer → Comparison result: returns result (evidence: `analyst/data.py`)
