# shivambandekar2526-png/result-analysis-aids architecture

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

- Interactive diagram: https://gitdiagram.com/shivambandekar2526-png/result-analysis-aids
- Repository: https://github.com/shivambandekar2526-png/result-analysis-aids

## Overview

Result Analysis AIDS combines a legacy rule-based ledger parser and a modern AI-assisted extraction platform. The main user workflow is to submit an academic ledger, ingest its pages, discover layout and extract student/course records, verify and reconcile them, then export records and analysis. The AI platform also documents batch analysis, conversational assistance, and knowledge-base training; the legacy platform includes dataset profiling and quality analysis. Modern subsystem links rely partly on README descriptions because several implementation files were not excerpted.

Main entry points: [`data_extractor_AI/app.py`](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/app.py) (AI Web App), [`data_extractor/app.py`](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/app.py) (Legacy Web App), [`data_extractor_AI/core/visual_extractor.py`](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/visual_extractor.py) (Visual Extraction), [`data_extractor/eda/report_builder.py`](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/eda/report_builder.py) (EDA Reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_legacy["Legacy Extraction"]
  node_legacy_app["Legacy Web App<br/>[app.py]"]
  node_legacy_parser["Rule Parser<br/>[parser.py]"]
  node_legacy_models["Academic Records<br/>[models.py]"]
  node_legacy_checksum["Checksum Validator<br/>[checksum.py]"]
  node_legacy_export["Legacy Exporter<br/>[exporter.py]"]
end

subgraph group_modern_ingest["AI Ingestion"]
  node_ai_app["AI Web App<br/>[app.py]"]
  node_page_ingest["PDF Page Ingest<br/>[page_ingester.py]"]
end

subgraph group_modern_extract["AI Extraction"]
  node_visual_extract["Visual Extraction"]
  node_ai_records["AI Student Records<br/>[models.py]"]
  node_cloud_ai["Cloud AI Client<br/>[cloud_client.py]"]
end

subgraph group_analysis["Verification &amp; Analysis"]
  node_eda_schema["Schema Discovery"]
  node_eda_profile["Dataset Profiler<br/>[profiler.py]"]
  node_eda_quality["Quality Checks<br/>[quality.py]"]
  node_eda_report["EDA Reports<br/>[report_builder.py]"]
  node_relation_engine["Relation Auditor"]
  node_checksum_verify["Checksum Verifier"]
  node_batch_analyzer["Batch Analyzer<br/>[batch_analyzer.py]"]
  node_eda_engine["AI EDA<br/>[eda_engine.py]"]
end

subgraph group_outputs["Exports &amp; Assistance"]
  node_report_generator["Academic Workbook"]
  node_ai_export["AI Exporter<br/>[exporter.py]"]
  node_chat["Ledger Assistant<br/>[chat_assistant.py]"]
  node_trainer["Knowledge Trainer<br/>[train_kb.py]"]
end

node_user(("Analyst"))
node_ledger["Academic Ledger"]
node_cloud_providers{{"AI Providers"}}
node_output_files["CSV / Excel / JSON"]

node_user -->|"submits ledger"| node_legacy_app
node_legacy_app -->|"routes extraction"| node_legacy_parser
node_legacy_parser -->|"builds records"| node_legacy_models
node_legacy_parser -->|"uses header discovery"| node_legacy_models
node_legacy_app -->|"validates results"| node_legacy_checksum
node_legacy_app -->|"exports results"| node_legacy_export
node_legacy_app -->|"requests analysis"| node_eda_report
node_eda_report -->|"discovers schema"| node_eda_schema
node_eda_report -->|"profiles data"| node_eda_profile
node_eda_report -->|"checks quality"| node_eda_quality
node_user -->|"uploads ledger"| node_ai_app
node_ai_app -->|"ingests PDF"| node_page_ingest
node_page_ingest -->|"supplies page content"| node_visual_extract
node_visual_extract -->|"requests inference"| node_cloud_ai
node_cloud_ai -->|"calls provider APIs"| node_cloud_providers
node_visual_extract -->|"extracts records"| node_ai_records
node_visual_extract -->|"audits in flight"| node_relation_engine
node_relation_engine -->|"verifies relations"| node_checksum_verify
node_ai_app -->|"inspects batches"| node_batch_analyzer
node_ai_app -->|"runs AI analysis"| node_eda_engine
node_ai_app -->|"generates workbook"| node_report_generator
node_ai_app -->|"exports extraction"| node_ai_export
node_ai_export -->|"writes files"| node_output_files
node_ai_app -->|"serves assistant"| node_chat
node_chat -->|"uses cloud inference"| node_cloud_ai
node_trainer -.->|"updates knowledge base"| node_ai_app
node_legacy_export -->|"writes exports"| node_output_files

click node_legacy_app "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/app.py"
click node_legacy_parser "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/parser.py"
click node_legacy_models "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/models.py"
click node_legacy_checksum "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/checksum.py"
click node_legacy_export "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/exporter.py"
click node_eda_schema "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/eda/schema_discovery.py"
click node_eda_profile "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/eda/profiler.py"
click node_eda_quality "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/eda/quality.py"
click node_eda_report "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/eda/report_builder.py"
click node_ai_app "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/app.py"
click node_page_ingest "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/page_ingester.py"
click node_visual_extract "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/visual_extractor.py"
click node_ai_records "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/models.py"
click node_cloud_ai "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/cloud_client.py"
click node_relation_engine "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/dynamic_relation_engine.py"
click node_checksum_verify "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/checksum_verifier.py"
click node_batch_analyzer "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/batch_analyzer.py"
click node_eda_engine "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/eda_engine.py"
click node_report_generator "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/excel_report_generator.py"
click node_ai_export "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/exporter.py"
click node_chat "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/chat_assistant.py"
click node_trainer "https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/trainer/train_kb.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_legacy_app,node_legacy_parser,node_legacy_models,node_legacy_checksum,node_legacy_export toneBlue
class node_ai_app,node_page_ingest toneAmber
class node_visual_extract,node_ai_records,node_cloud_ai toneMint
class node_eda_schema,node_eda_profile,node_eda_quality,node_eda_report,node_relation_engine,node_checksum_verify,node_batch_analyzer,node_eda_engine toneRose
class node_report_generator,node_ai_export,node_chat,node_trainer,node_user,node_ledger,node_cloud_providers,node_output_files toneIndigo
```

## Components

### Legacy Extraction

- [Legacy Web App](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/app.py): `data_extractor/app.py`
- [Rule Parser](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/parser.py): `data_extractor/parser.py`
- [Academic Records](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/models.py): `data_extractor/models.py`
- [Checksum Validator](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/checksum.py): `data_extractor/checksum.py`
- [Legacy Exporter](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/exporter.py): `data_extractor/exporter.py`

### AI Ingestion

- [AI Web App](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/app.py): `data_extractor_AI/app.py`
- [PDF Page Ingest](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/page_ingester.py): `data_extractor_AI/core/page_ingester.py`

### AI Extraction

- [Visual Extraction](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/visual_extractor.py): `data_extractor_AI/core/visual_extractor.py`
- [AI Student Records](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/models.py): `data_extractor_AI/models.py`
- [Cloud AI Client](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/cloud_client.py): `data_extractor_AI/core/cloud_client.py`

### Verification & Analysis

- [Schema Discovery](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/eda/schema_discovery.py): `data_extractor/eda/schema_discovery.py`
- [Dataset Profiler](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/eda/profiler.py): `data_extractor/eda/profiler.py`
- [Quality Checks](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/eda/quality.py): `data_extractor/eda/quality.py`
- [EDA Reports](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor/eda/report_builder.py): `data_extractor/eda/report_builder.py`
- [Relation Auditor](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/dynamic_relation_engine.py): `data_extractor_AI/core/dynamic_relation_engine.py`
- [Checksum Verifier](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/checksum_verifier.py): `data_extractor_AI/core/checksum_verifier.py`
- [Batch Analyzer](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/batch_analyzer.py): `data_extractor_AI/core/batch_analyzer.py`
- [AI EDA](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/eda_engine.py): `data_extractor_AI/core/eda_engine.py`

### Exports & Assistance

- [Academic Workbook](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/excel_report_generator.py): `data_extractor_AI/core/excel_report_generator.py`
- [AI Exporter](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/exporter.py): `data_extractor_AI/exporter.py`
- [Ledger Assistant](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/core/chat_assistant.py): `data_extractor_AI/core/chat_assistant.py`
- [Knowledge Trainer](https://github.com/shivambandekar2526-png/result-analysis-aids/blob/main/data_extractor_AI/trainer/train_kb.py): `data_extractor_AI/trainer/train_kb.py`

### Other components

- **Analyst**
- **Academic Ledger**
- **AI Providers**
- **CSV / Excel / JSON**

## Connections

- Analyst → Legacy Web App: submits ledger (evidence: `README.md`)
- Legacy Web App → Rule Parser: routes extraction (evidence: `data_extractor/app.py`)
- Rule Parser → Academic Records: builds records (evidence: `data_extractor/parser.py`)
- Rule Parser → Academic Records: uses header discovery (evidence: `data_extractor/parser.py`)
- Legacy Web App → Checksum Validator: validates results (evidence: `data_extractor/app.py`)
- Legacy Web App → Legacy Exporter: exports results (evidence: `data_extractor/app.py`)
- Legacy Web App → EDA Reports: requests analysis (evidence: `data_extractor/app.py`)
- EDA Reports → Schema Discovery: discovers schema (evidence: `data_extractor/eda/report_builder.py`)
- EDA Reports → Dataset Profiler: profiles data (evidence: `data_extractor/eda/report_builder.py`)
- EDA Reports → Quality Checks: checks quality (evidence: `data_extractor/eda/report_builder.py`)
- Analyst → AI Web App: uploads ledger (evidence: `README.md`)
- AI Web App → PDF Page Ingest: ingests PDF (evidence: `data_extractor_AI/app.py`)
- PDF Page Ingest → Visual Extraction: supplies page content (evidence: `data_extractor_AI/core/visual_extractor.py`)
- Visual Extraction → Cloud AI Client: requests inference (evidence: `data_extractor_AI/core/visual_extractor.py`)
- Cloud AI Client → AI Providers: calls provider APIs (evidence: `data_extractor_AI/core/cloud_client.py`)
- Visual Extraction → AI Student Records: extracts records (evidence: `README.md`)
- Visual Extraction → Relation Auditor: audits in flight (evidence: `data_extractor_AI/core/visual_extractor.py`)
- Relation Auditor → Checksum Verifier: verifies relations (evidence: `data_extractor_AI/core/dynamic_relation_engine.py`)
- AI Web App → Batch Analyzer: inspects batches (evidence: `data_extractor_AI/app.py`)
- AI Web App → AI EDA: runs AI analysis (evidence: `data_extractor_AI/app.py`)
- AI Web App → Academic Workbook: generates workbook (evidence: `data_extractor_AI/app.py`)
- AI Web App → AI Exporter: exports extraction (evidence: `data_extractor_AI/app.py`)
- AI Exporter → CSV / Excel / JSON: writes files (evidence: `data_extractor_AI/exporter.py`)
- AI Web App → Ledger Assistant: serves assistant (evidence: `data_extractor_AI/app.py`)
- Ledger Assistant → Cloud AI Client: uses cloud inference (evidence: `data_extractor_AI/core/chat_assistant.py`)
- Knowledge Trainer → AI Web App: updates knowledge base
- Legacy Exporter → CSV / Excel / JSON: writes exports
