# kanish1206/aveer architecture

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

- Interactive diagram: https://gitdiagram.com/kanish1206/aveer
- Repository: https://github.com/kanish1206/aveer

## Overview

Aveer is a Streamlit tool for reconciling GSTR-2B records against a purchase register. Users upload both Excel files, initiate reconciliation, review match metrics and a detailed ledger, then download an Excel report. The reconciliation logic validates and aggregates records before applying exact, fuzzy, GSTIN-variation, and document-based matching. The excerpts show the app-to-engine call and report flow; unsampled code details are not inferred.

Main entry points: [`reco_logic.py`](https://github.com/kanish1206/aveer/blob/main/reco_logic.py) (Reconciliation Result), [`Streamlit_app.py`](https://github.com/kanish1206/aveer/blob/main/Streamlit_app.py) (Streamlit App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Streamlit Interface"]
  node_uploads["Excel Uploads<br/>[Streamlit_app.py]"]
  node_app["Streamlit App<br/>[Streamlit_app.py]"]
end

subgraph group_reconciliation["Reconciliation Engine"]
  node_prepare["Validate and Aggregate<br/>[reco_logic.py]"]
  node_exact["Initial Matching<br/>[reco_logic.py]"]
  node_fuzzy["Fuzzy Matching<br/>[reco_logic.py]"]
  node_variation["GSTIN and PAN Matching<br/>[reco_logic.py]"]
  node_document["Document Matching<br/>[reco_logic.py]"]
end

subgraph group_results["Results"]
  node_result["Reconciliation Result<br/>[reco_logic.py]"]
  node_metrics["Match Metrics<br/>[Streamlit_app.py]"]
  node_ledger["Detailed Ledger<br/>[Streamlit_app.py]"]
  node_report["Excel Report<br/>[Streamlit_app.py]"]
end

node_user(("User"))

node_user -->|"uploads"| node_uploads
node_uploads -->|"provides files"| node_app
node_app -->|"calls process_reco"| node_prepare
node_prepare -->|"prepares records"| node_exact
node_exact -->|"matches open rows"| node_fuzzy
node_fuzzy -->|"checks remaining rows"| node_variation
node_variation -->|"checks remaining rows"| node_document
node_app -->|"receives result"| node_result
node_result -->|"calculates counts"| node_metrics
node_result -->|"displays rows"| node_ledger
node_result -->|"exports workbook"| node_report
node_user -->|"downloads"| node_report

click node_uploads "https://github.com/kanish1206/aveer/blob/main/Streamlit_app.py"
click node_app "https://github.com/kanish1206/aveer/blob/main/Streamlit_app.py"
click node_prepare "https://github.com/kanish1206/aveer/blob/main/reco_logic.py"
click node_exact "https://github.com/kanish1206/aveer/blob/main/reco_logic.py"
click node_fuzzy "https://github.com/kanish1206/aveer/blob/main/reco_logic.py"
click node_variation "https://github.com/kanish1206/aveer/blob/main/reco_logic.py"
click node_document "https://github.com/kanish1206/aveer/blob/main/reco_logic.py"
click node_result "https://github.com/kanish1206/aveer/blob/main/reco_logic.py"
click node_metrics "https://github.com/kanish1206/aveer/blob/main/Streamlit_app.py"
click node_ledger "https://github.com/kanish1206/aveer/blob/main/Streamlit_app.py"
click node_report "https://github.com/kanish1206/aveer/blob/main/Streamlit_app.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_uploads,node_app,node_user toneBlue
class node_prepare,node_exact,node_fuzzy,node_variation,node_document toneAmber
class node_result,node_metrics,node_ledger,node_report toneMint
```

## Components

### Streamlit Interface

- [Excel Uploads](https://github.com/kanish1206/aveer/blob/main/Streamlit_app.py): `Streamlit_app.py`
- [Streamlit App](https://github.com/kanish1206/aveer/blob/main/Streamlit_app.py): `Streamlit_app.py`

### Reconciliation Engine

- [Validate and Aggregate](https://github.com/kanish1206/aveer/blob/main/reco_logic.py): `reco_logic.py`
- [Initial Matching](https://github.com/kanish1206/aveer/blob/main/reco_logic.py): `reco_logic.py`
- [Fuzzy Matching](https://github.com/kanish1206/aveer/blob/main/reco_logic.py): `reco_logic.py`
- [GSTIN and PAN Matching](https://github.com/kanish1206/aveer/blob/main/reco_logic.py): `reco_logic.py`
- [Document Matching](https://github.com/kanish1206/aveer/blob/main/reco_logic.py): `reco_logic.py`

### Results

- [Reconciliation Result](https://github.com/kanish1206/aveer/blob/main/reco_logic.py): `reco_logic.py`
- [Match Metrics](https://github.com/kanish1206/aveer/blob/main/Streamlit_app.py): `Streamlit_app.py`
- [Detailed Ledger](https://github.com/kanish1206/aveer/blob/main/Streamlit_app.py): `Streamlit_app.py`
- [Excel Report](https://github.com/kanish1206/aveer/blob/main/Streamlit_app.py): `Streamlit_app.py`

### Other components

- **User**

## Connections

- User → Excel Uploads: uploads (evidence: `Streamlit_app.py`)
- Excel Uploads → Streamlit App: provides files (evidence: `Streamlit_app.py`)
- Streamlit App → Validate and Aggregate: calls process_reco (evidence: `Streamlit_app.py`)
- Validate and Aggregate → Initial Matching: prepares records (evidence: `reco_logic.py`)
- Initial Matching → Fuzzy Matching: matches open rows (evidence: `reco_logic.py`)
- Fuzzy Matching → GSTIN and PAN Matching: checks remaining rows (evidence: `reco_logic.py`)
- GSTIN and PAN Matching → Document Matching: checks remaining rows (evidence: `reco_logic.py`)
- Streamlit App → Reconciliation Result: receives result (evidence: `Streamlit_app.py`)
- Reconciliation Result → Match Metrics: calculates counts (evidence: `Streamlit_app.py`)
- Reconciliation Result → Detailed Ledger: displays rows (evidence: `Streamlit_app.py`)
- Reconciliation Result → Excel Report: exports workbook (evidence: `Streamlit_app.py`)
- User → Excel Report: downloads (evidence: `Streamlit_app.py`)
