# kutralakumarank/ai-ecommerce-review-summarizer architecture

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

- Interactive diagram: https://gitdiagram.com/kutralakumarank/ai-ecommerce-review-summarizer
- Repository: https://github.com/kutralakumarank/ai-ecommerce-review-summarizer

## Overview

AIReviewSummarizer is a Streamlit product that turns a selected product’s reviews into overall, positive-only, and negative-only summaries. Its main workflow prepares sentiment-split review data, builds or loads three retrieval indexes, then invokes a LangGraph agent separately for each question; the agent may retrieve from multiple tools, grade retrieved context, and generate or rewrite before results are rendered. The README documents key workflow links that are not all visible in the sampled source. The graph preserves those documented capabilities without treating unsampled implementation details as inspected.

Main entry points: [`src/nodes/ai_review_summarizer_nodes.py`](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/nodes/ai_review_summarizer_nodes.py) (Workflow assembly), [`src/RAG/Rag.py`](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.py) (RAG indexing), [`src/main.py`](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/main.py) (App coordinator), [`src/ETL/etlpipeline.py`](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/etlpipeline.py) (ETL pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Streamlit interface"]
  node_entry["Streamlit entry<br/>[app.py]"]
  node_app["App coordinator<br/>[main.py]"]
  node_controls["Input controls<br/>[loadui.py]"]
  node_config["UI configuration<br/>[uiconfigfile.py]"]
  node_display["Summary display<br/>[display_result.py]"]
end

subgraph group_preparation["Review preparation"]
  node_raw["Raw review CSV"]
  node_etl["ETL pipeline<br/>[etlpipeline.py]"]
  node_clean["Clean reviews"]
  node_positive["Positive reviews"]
  node_negative["Negative reviews"]
end

subgraph group_retrieval["Retrieval layer"]
  node_rag["RAG indexing<br/>[Rag.py]"]
  node_allstore[("All-review index")]
  node_posstore[("Positive index")]
  node_negstore[("Negative index")]
  node_tools["Retriever tools<br/>[loadui.py]"]
end

subgraph group_agent["Agent workflow"]
  node_graphbuilder["Graph builder<br/>[graph.py]"]
  node_nodes["Workflow assembly"]
  node_state["Message state<br/>[state.py]"]
  node_agentnode["Agent decision<br/>[Rag.py]"]
  node_retrieve["Tool retrieval"]
  node_grade["Relevance grading<br/>[Rag.py]"]
  node_rewrite["Question rewrite<br/>[Rag.py]"]
  node_generate["Answer generation<br/>[Rag.py]"]
end

subgraph group_models["Model configuration"]
  node_llm["Groq model setup<br/>[groqllm.py]"]
end

node_user(("Product requester"))

node_user -->|"starts app"| node_entry
node_entry -->|"calls"| node_app
node_app -->|"loads inputs"| node_controls
node_controls -->|"reads options"| node_config
node_controls -->|"runs products ETL"| node_etl
node_raw -->|"extracts"| node_etl
node_etl -->|"writes cleaned"| node_clean
node_etl -->|"writes positive"| node_positive
node_etl -->|"writes negative"| node_negative
node_controls -->|"builds indexes"| node_rag
node_clean -->|"loads reviews"| node_rag
node_positive -->|"loads subset"| node_rag
node_negative -->|"loads subset"| node_rag
node_rag -->|"persists index"| node_allstore
node_rag -->|"persists index"| node_posstore
node_rag -->|"persists index"| node_negstore
node_allstore -->|"loads retriever"| node_tools
node_posstore -->|"loads retriever"| node_tools
node_negstore -->|"loads retriever"| node_tools
node_app -->|"configures model"| node_llm
node_app -->|"builds workflow"| node_graphbuilder
node_app -->|"gets tools"| node_tools
node_graphbuilder -->|"delegates build"| node_nodes
node_nodes -->|"uses state schema"| node_state
node_nodes -->|"registers agent"| node_agentnode
node_nodes -->|"registers tool node"| node_retrieve
node_nodes -->|"routes for grading"| node_grade
node_nodes -->|"registers rewrite"| node_rewrite
node_nodes -->|"registers generation"| node_generate
node_tools -->|"binds tools"| node_agentnode
node_agentnode -->|"dispatches calls"| node_retrieve
node_retrieve -->|"returns tool results"| node_grade
node_grade -->|"accepts relevant"| node_generate
node_grade -->|"rejects context"| node_rewrite
node_rewrite -->|"retries question"| node_agentnode
node_llm -->|"supplies model"| node_agentnode
node_app -->|"renders results"| node_display
node_display -->|"invokes graph"| node_agentnode
node_generate -->|"returns summaries"| node_display

click node_entry "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/app.py"
click node_app "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/main.py"
click node_controls "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ui/streamlitui/loadui.py"
click node_config "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ui/uiconfigfile.py"
click node_display "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ui/streamlitui/display_result.py"
click node_raw "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/ecommerce_product_reviews_dataset.csv"
click node_etl "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/etlpipeline.py"
click node_clean "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/transformed_product_reviews_dataset.csv"
click node_positive "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/positive_reviews.csv"
click node_negative "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/negative_reviews.csv"
click node_rag "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.py"
click node_allstore "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/tree/master/src/RAG/vectorstore"
click node_posstore "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/tree/master/src/RAG/vectorstore_positive"
click node_negstore "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/tree/master/src/RAG/vectorstore_negative"
click node_tools "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ui/streamlitui/loadui.py"
click node_llm "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/LLMS/groqllm.py"
click node_graphbuilder "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/graph/graph.py"
click node_nodes "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/nodes/ai_review_summarizer_nodes.py"
click node_state "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/states/state.py"
click node_agentnode "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.py"
click node_retrieve "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/nodes/ai_review_summarizer_nodes.py"
click node_grade "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.py"
click node_rewrite "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.py"
click node_generate "https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.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_entry,node_app,node_controls,node_config,node_display toneBlue
class node_raw,node_etl,node_clean,node_positive,node_negative toneAmber
class node_rag,node_allstore,node_posstore,node_negstore,node_tools,node_user toneMint
class node_graphbuilder,node_nodes,node_state,node_agentnode,node_retrieve,node_grade,node_rewrite,node_generate toneRose
class node_llm toneIndigo
```

## Components

### Streamlit interface

- [Streamlit entry](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/app.py): `app.py`
- [App coordinator](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/main.py): `src/main.py`
- [Input controls](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ui/streamlitui/loadui.py): `src/ui/streamlitui/loadui.py`
- [UI configuration](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ui/uiconfigfile.py): `src/ui/uiconfigfile.py`
- [Summary display](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ui/streamlitui/display_result.py): `src/ui/streamlitui/display_result.py`

### Review preparation

- [Raw review CSV](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/ecommerce_product_reviews_dataset.csv): `src/ETL/ecommerce_product_reviews_dataset.csv`
- [ETL pipeline](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/etlpipeline.py): `src/ETL/etlpipeline.py`
- [Clean reviews](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/transformed_product_reviews_dataset.csv): `src/ETL/transformed_product_reviews_dataset.csv`
- [Positive reviews](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/positive_reviews.csv): `src/ETL/positive_reviews.csv`
- [Negative reviews](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ETL/negative_reviews.csv): `src/ETL/negative_reviews.csv`

### Retrieval layer

- [RAG indexing](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.py): `src/RAG/Rag.py`
- [All-review index](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/tree/master/src/RAG/vectorstore): `src/RAG/vectorstore`
- [Positive index](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/tree/master/src/RAG/vectorstore_positive): `src/RAG/vectorstore_positive`
- [Negative index](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/tree/master/src/RAG/vectorstore_negative): `src/RAG/vectorstore_negative`
- [Retriever tools](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/ui/streamlitui/loadui.py): `src/ui/streamlitui/loadui.py`

### Agent workflow

- [Graph builder](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/graph/graph.py): `src/graph/graph.py`
- [Workflow assembly](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/nodes/ai_review_summarizer_nodes.py): `src/nodes/ai_review_summarizer_nodes.py`
- [Message state](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/states/state.py): `src/states/state.py`
- [Agent decision](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.py): `src/RAG/Rag.py`
- [Tool retrieval](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/nodes/ai_review_summarizer_nodes.py): `src/nodes/ai_review_summarizer_nodes.py`
- [Relevance grading](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.py): `src/RAG/Rag.py`
- [Question rewrite](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.py): `src/RAG/Rag.py`
- [Answer generation](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/RAG/Rag.py): `src/RAG/Rag.py`

### Model configuration

- [Groq model setup](https://github.com/kutralakumarank/ai-ecommerce-review-summarizer/blob/master/src/LLMS/groqllm.py): `src/LLMS/groqllm.py`

### Other components

- **Product requester**

## Connections

- Product requester → Streamlit entry: starts app (evidence: `README.md`)
- Streamlit entry → App coordinator: calls (evidence: `app.py`)
- App coordinator → Input controls: loads inputs (evidence: `src/main.py`)
- Input controls → UI configuration: reads options (evidence: `src/ui/streamlitui/loadui.py`)
- Input controls → ETL pipeline: runs products ETL (evidence: `src/ui/streamlitui/loadui.py`)
- Raw review CSV → ETL pipeline: extracts (evidence: `src/ETL/etlpipeline.py`)
- ETL pipeline → Clean reviews: writes cleaned (evidence: `src/ETL/etlpipeline.py`)
- ETL pipeline → Positive reviews: writes positive (evidence: `src/ETL/etlpipeline.py`)
- ETL pipeline → Negative reviews: writes negative (evidence: `src/ETL/etlpipeline.py`)
- Input controls → RAG indexing: builds indexes (evidence: `src/ui/streamlitui/loadui.py`)
- Clean reviews → RAG indexing: loads reviews (evidence: `README.md`)
- Positive reviews → RAG indexing: loads subset (evidence: `README.md`)
- Negative reviews → RAG indexing: loads subset (evidence: `README.md`)
- RAG indexing → All-review index: persists index (evidence: `README.md`)
- RAG indexing → Positive index: persists index (evidence: `README.md`)
- RAG indexing → Negative index: persists index (evidence: `README.md`)
- All-review index → Retriever tools: loads retriever (evidence: `src/ui/streamlitui/loadui.py`)
- Positive index → Retriever tools: loads retriever (evidence: `src/ui/streamlitui/loadui.py`)
- Negative index → Retriever tools: loads retriever (evidence: `src/ui/streamlitui/loadui.py`)
- App coordinator → Groq model setup: configures model (evidence: `src/main.py`)
- App coordinator → Graph builder: builds workflow (evidence: `src/main.py`)
- App coordinator → Retriever tools: gets tools (evidence: `src/main.py`)
- Graph builder → Workflow assembly: delegates build (evidence: `src/graph/graph.py`)
- Workflow assembly → Message state: uses state schema (evidence: `src/nodes/ai_review_summarizer_nodes.py`)
- Workflow assembly → Agent decision: registers agent (evidence: `src/nodes/ai_review_summarizer_nodes.py`)
- Workflow assembly → Tool retrieval: registers tool node (evidence: `src/nodes/ai_review_summarizer_nodes.py`)
- Workflow assembly → Relevance grading: routes for grading (evidence: `src/nodes/ai_review_summarizer_nodes.py`)
- Workflow assembly → Question rewrite: registers rewrite (evidence: `src/nodes/ai_review_summarizer_nodes.py`)
- Workflow assembly → Answer generation: registers generation (evidence: `src/nodes/ai_review_summarizer_nodes.py`)
- Retriever tools → Agent decision: binds tools (evidence: `README.md`)
- Agent decision → Tool retrieval: dispatches calls (evidence: `README.md`)
- Tool retrieval → Relevance grading: returns tool results (evidence: `README.md`)
- Relevance grading → Answer generation: accepts relevant (evidence: `README.md`)
- Relevance grading → Question rewrite: rejects context (evidence: `README.md`)
- Question rewrite → Agent decision: retries question (evidence: `README.md`)
- Groq model setup → Agent decision: supplies model (evidence: `README.md`)
- App coordinator → Summary display: renders results (evidence: `src/main.py`)
- Summary display → Agent decision: invokes graph (evidence: `README.md`)
- Answer generation → Summary display: returns summaries (evidence: `README.md`)
