# srikrishnamalisetti1106/azure-reconciliation architecture

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

- Interactive diagram: https://gitdiagram.com/srikrishnamalisetti1106/azure-reconciliation
- Repository: https://github.com/srikrishnamalisetti1106/azure-reconciliation

## Overview

The documented product reconciles processor payments against ledger entries, reports preliminary and final KPIs, and provides a read-only assistant to investigate exceptions. The sampled runtime confirms synthetic data generation and deterministic, uniqueness-checked matching with exception classification. The README describes additional pipeline and assistant stages, but their implementation files are absent from the supplied tree, so those nodes have no source path; their documented connections cite the README.

Main entry points: [`reconciliation/matching.py`](https://github.com/srikrishnamalisetti1106/azure-reconciliation/blob/main/reconciliation/matching.py) (Versioned matching), [`data/synthetic/generate.py`](https://github.com/srikrishnamalisetti1106/azure-reconciliation/blob/main/data/synthetic/generate.py) (Synthetic data generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pipeline["Reconciliation pipeline"]
  node_generator["Synthetic data generator<br/>[generate.py]"]
  node_bronze[("Bronze raw data")]
  node_silver[("Silver quality gates")]
  node_matching["Versioned matching<br/>[matching.py]"]
  node_gold[("Gold results")]
end

subgraph group_reporting["Reporting"]
  node_kpis[("T+1 / T+3 KPIs")]
  node_dashboard["Dashboard"]
end

subgraph group_assistant["Investigation assistant"]
  node_api["FastAPI"]
  node_agent["LangGraph agent"]
  node_traces["Langfuse traces"]
end

subgraph group_assistant_data["Assistant data and search"]
  node_mcp["Read-only MCP tools"]
  node_rag["Rule and KPI search"]
end

node_analyst(("Analyst"))
node_claude["Claude"]

node_generator -->|"supplies CSVs"| node_bronze
node_bronze -->|"types and gates"| node_silver
node_silver -->|"provides records"| node_matching
node_matching -->|"writes results"| node_gold
node_gold -->|"feeds snapshots"| node_kpis
node_kpis -->|"reports rates"| node_dashboard
node_analyst -->|"asks questions"| node_api
node_api -->|"routes requests"| node_agent
node_agent -->|"consults"| node_claude
node_claude -->|"returns response"| node_agent
node_agent -->|"invokes tools"| node_mcp
node_agent -->|"searches docs"| node_rag
node_agent -->|"emits traces"| node_traces
node_gold -.->|"read-only copy"| node_mcp

click node_generator "https://github.com/srikrishnamalisetti1106/azure-reconciliation/blob/main/data/synthetic/generate.py"
click node_matching "https://github.com/srikrishnamalisetti1106/azure-reconciliation/blob/main/reconciliation/matching.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_generator,node_bronze,node_silver,node_matching,node_gold toneBlue
class node_kpis,node_dashboard toneAmber
class node_api,node_agent,node_traces toneMint
class node_mcp,node_rag toneRose
class node_analyst,node_claude toneIndigo
```

## Components

### Reconciliation pipeline

- [Synthetic data generator](https://github.com/srikrishnamalisetti1106/azure-reconciliation/blob/main/data/synthetic/generate.py): `data/synthetic/generate.py`
- **Bronze raw data**
- **Silver quality gates**
- [Versioned matching](https://github.com/srikrishnamalisetti1106/azure-reconciliation/blob/main/reconciliation/matching.py): `reconciliation/matching.py`
- **Gold results**

### Reporting

- **T+1 / T+3 KPIs**
- **Dashboard**

### Investigation assistant

- **FastAPI**
- **LangGraph agent**
- **Langfuse traces**

### Assistant data and search

- **Read-only MCP tools**
- **Rule and KPI search**

### Other components

- **Analyst**
- **Claude**

## Connections

- Synthetic data generator → Bronze raw data: supplies CSVs (evidence: `README.md`)
- Bronze raw data → Silver quality gates: types and gates (evidence: `README.md`)
- Silver quality gates → Versioned matching: provides records (evidence: `README.md`)
- Versioned matching → Gold results: writes results (evidence: `README.md`)
- Gold results → T+1 / T+3 KPIs: feeds snapshots (evidence: `README.md`)
- T+1 / T+3 KPIs → Dashboard: reports rates (evidence: `README.md`)
- Analyst → FastAPI: asks questions (evidence: `README.md`)
- FastAPI → LangGraph agent: routes requests (evidence: `README.md`)
- LangGraph agent → Claude: consults (evidence: `README.md`)
- Claude → LangGraph agent: returns response (evidence: `README.md`)
- LangGraph agent → Read-only MCP tools: invokes tools (evidence: `README.md`)
- LangGraph agent → Rule and KPI search: searches docs (evidence: `README.md`)
- LangGraph agent → Langfuse traces: emits traces (evidence: `README.md`)
- Gold results → Read-only MCP tools: read-only copy (evidence: `README.md`)
