# saksham20189575/rag-milestone2 architecture

> Architecture diagram of the GitHub repository saksham20189575/rag-milestone2, 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/saksham20189575/rag-milestone2
- Repository: https://github.com/saksham20189575/rag-milestone2

## Overview

The product is a facts-only HDFC mutual-fund FAQ assistant. Its main workflow is a user chat request through the web UI and API into classification, scheme/section-aware retrieval, answer generation and validation, then a cited response. A separate offline ingestion workflow refreshes the Groww corpus and Chroma index. Edges are grounded in the shown excerpts, SOURCE INDEX references, or README; some internal wiring and the frontend-to-API boundary are not fully shown.

Main entry points: [`src/api/routes/chat.py`](https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/routes/chat.py) (Chat endpoints), [`src/generation/pipeline.py`](https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/pipeline.py) (RAG orchestrator), [`src/retrieval/retriever.py`](https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/retriever.py) (Scheme retriever), [`src/generation/groq_client.py`](https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/groq_client.py) (Groq client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_chat["Chat experience"]
  node_app["Chat app<br/>[App.tsx]"]
  node_chatui["Chat components"]
  node_chatclient["Chat API client<br/>[chat.ts]"]
end

subgraph group_api["API service"]
  node_api_routes["Chat endpoints<br/>[chat.py]"]
  node_api_main["API application<br/>[main.py]"]
  node_api_deps["Pipeline dependencies<br/>[deps.py]"]
  node_sanitizer["Input sanitization<br/>[sanitize.py]"]
  node_api_limiter["Request rate limit<br/>[rate_limit.py]"]
end

subgraph group_answer["Answer pipeline"]
  node_pipeline["RAG orchestrator<br/>[pipeline.py]"]
  node_classifier["Intent classifier<br/>[classifier.py]"]
  node_generator["Answer generator<br/>[generator.py]"]
  node_validator["Answer validator<br/>[validator.py]"]
  node_refusal["Refusal responses<br/>[refusal.py]"]
  node_groq_client["Groq client<br/>[groq_client.py]"]
  node_generation_limiter["Groq rate limiter<br/>[rate_limiter.py]"]
end

subgraph group_corpus["Corpus ingestion"]
  node_fetcher["Groww fetcher<br/>[fetcher.py]"]
  node_parser["Page parser<br/>[parser.py]"]
  node_chunker["Section chunker<br/>[chunker.py]"]
  node_indexer["Index builder<br/>[indexer.py]"]
  node_settings["Runtime settings<br/>[settings.py]"]
end

subgraph group_retrieval["Retrieval and index"]
  node_embedder["Text embedder<br/>[embedder.py]"]
  node_retriever["Scheme retriever<br/>[retriever.py]"]
  node_scheme_resolver["Scheme resolver<br/>[scheme_resolver.py]"]
  node_section_router["Section router<br/>[section_router.py]"]
  node_vector_store["Chroma access<br/>[vector_store.py]"]
end

node_user(("Questioner"))
node_groq["Groq service"]
node_groww["Groww pages"]
node_chroma[("Chroma index")]
node_processed["Processed corpus"]

node_user -->|"asks"| node_app
node_app -->|"renders"| node_chatui
node_app -->|"sends message"| node_chatclient
node_chatclient -.->|"posts chat"| node_api_routes
node_api_main -->|"registers routes"| node_api_routes
node_api_routes -->|"checks limit"| node_api_limiter
node_api_routes -->|"gets pipeline"| node_api_deps
node_api_routes -->|"sanitizes input"| node_sanitizer
node_api_routes -->|"answers query"| node_pipeline
node_api_routes -->|"lists schemes"| node_settings
node_api_deps -->|"provides"| node_pipeline
node_api_routes -->|"returns response"| node_user
node_pipeline -->|"classifies"| node_classifier
node_pipeline -->|"retrieves facts"| node_retriever
node_pipeline -->|"generates answer"| node_generator
node_pipeline -->|"validates answer"| node_validator
node_pipeline -->|"builds refusal"| node_refusal
node_classifier -.->|"optional classification"| node_groq_client
node_generator -->|"requests completion"| node_groq_client
node_groq_client -->|"calls model"| node_groq
node_groq_client -->|"checks capacity"| node_generation_limiter
node_fetcher -->|"downloads pages"| node_groww
node_fetcher -.->|"passes HTML"| node_parser
node_parser -->|"writes parsed text"| node_processed
node_processed -.->|"supplies text"| node_chunker
node_chunker -->|"provides chunks"| node_indexer
node_indexer -->|"embeds chunks"| node_embedder
node_indexer -->|"upserts vectors"| node_vector_store
node_vector_store -->|"opens index"| node_chroma
node_retriever -->|"resolves scheme"| node_scheme_resolver
node_retriever -->|"routes section"| node_section_router
node_retriever -->|"embeds query"| node_embedder
node_retriever -->|"gets collection"| node_vector_store
node_retriever -->|"queries vectors"| node_chroma
node_settings -.->|"configures model"| node_groq_client

click node_app "https://github.com/saksham20189575/rag-milestone2/blob/main/frontend/src/App.tsx"
click node_chatui "https://github.com/saksham20189575/rag-milestone2/tree/main/frontend/src/components"
click node_chatclient "https://github.com/saksham20189575/rag-milestone2/blob/main/frontend/src/api/chat.ts"
click node_api_routes "https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/routes/chat.py"
click node_api_main "https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/main.py"
click node_api_deps "https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/deps.py"
click node_sanitizer "https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/sanitize.py"
click node_api_limiter "https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/rate_limit.py"
click node_pipeline "https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/pipeline.py"
click node_classifier "https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/classifier.py"
click node_generator "https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/generator.py"
click node_validator "https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/validator.py"
click node_refusal "https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/refusal.py"
click node_groq_client "https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/groq_client.py"
click node_generation_limiter "https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/rate_limiter.py"
click node_fetcher "https://github.com/saksham20189575/rag-milestone2/blob/main/src/ingestion/fetcher.py"
click node_parser "https://github.com/saksham20189575/rag-milestone2/blob/main/src/ingestion/parser.py"
click node_chunker "https://github.com/saksham20189575/rag-milestone2/blob/main/src/ingestion/chunker.py"
click node_indexer "https://github.com/saksham20189575/rag-milestone2/blob/main/src/ingestion/indexer.py"
click node_settings "https://github.com/saksham20189575/rag-milestone2/blob/main/src/config/settings.py"
click node_embedder "https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/embedder.py"
click node_retriever "https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/retriever.py"
click node_scheme_resolver "https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/scheme_resolver.py"
click node_section_router "https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/section_router.py"
click node_vector_store "https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/vector_store.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_app,node_chatui,node_chatclient toneBlue
class node_api_routes,node_api_main,node_api_deps,node_sanitizer,node_api_limiter,node_chroma toneAmber
class node_pipeline,node_classifier,node_generator,node_validator,node_refusal,node_groq_client,node_generation_limiter toneMint
class node_fetcher,node_parser,node_chunker,node_indexer,node_settings toneRose
class node_embedder,node_retriever,node_scheme_resolver,node_section_router,node_vector_store,node_user,node_groq,node_groww,node_processed toneIndigo
```

## Components

### Chat experience

- [Chat app](https://github.com/saksham20189575/rag-milestone2/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Chat components](https://github.com/saksham20189575/rag-milestone2/tree/main/frontend/src/components): `frontend/src/components`
- [Chat API client](https://github.com/saksham20189575/rag-milestone2/blob/main/frontend/src/api/chat.ts): `frontend/src/api/chat.ts`

### API service

- [Chat endpoints](https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/routes/chat.py): `src/api/routes/chat.py`
- [API application](https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/main.py): `src/api/main.py`
- [Pipeline dependencies](https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/deps.py): `src/api/deps.py`
- [Input sanitization](https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/sanitize.py): `src/api/sanitize.py`
- [Request rate limit](https://github.com/saksham20189575/rag-milestone2/blob/main/src/api/rate_limit.py): `src/api/rate_limit.py`

### Answer pipeline

- [RAG orchestrator](https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/pipeline.py): `src/generation/pipeline.py`
- [Intent classifier](https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/classifier.py): `src/generation/classifier.py`
- [Answer generator](https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/generator.py): `src/generation/generator.py`
- [Answer validator](https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/validator.py): `src/generation/validator.py`
- [Refusal responses](https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/refusal.py): `src/generation/refusal.py`
- [Groq client](https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/groq_client.py): `src/generation/groq_client.py`
- [Groq rate limiter](https://github.com/saksham20189575/rag-milestone2/blob/main/src/generation/rate_limiter.py): `src/generation/rate_limiter.py`

### Corpus ingestion

- [Groww fetcher](https://github.com/saksham20189575/rag-milestone2/blob/main/src/ingestion/fetcher.py): `src/ingestion/fetcher.py`
- [Page parser](https://github.com/saksham20189575/rag-milestone2/blob/main/src/ingestion/parser.py): `src/ingestion/parser.py`
- [Section chunker](https://github.com/saksham20189575/rag-milestone2/blob/main/src/ingestion/chunker.py): `src/ingestion/chunker.py`
- [Index builder](https://github.com/saksham20189575/rag-milestone2/blob/main/src/ingestion/indexer.py): `src/ingestion/indexer.py`
- [Runtime settings](https://github.com/saksham20189575/rag-milestone2/blob/main/src/config/settings.py): `src/config/settings.py`

### Retrieval and index

- [Text embedder](https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/embedder.py): `src/retrieval/embedder.py`
- [Scheme retriever](https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/retriever.py): `src/retrieval/retriever.py`
- [Scheme resolver](https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/scheme_resolver.py): `src/retrieval/scheme_resolver.py`
- [Section router](https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/section_router.py): `src/retrieval/section_router.py`
- [Chroma access](https://github.com/saksham20189575/rag-milestone2/blob/main/src/retrieval/vector_store.py): `src/retrieval/vector_store.py`

### Other components

- **Questioner**
- **Groq service**
- **Groww pages**
- **Chroma index**
- **Processed corpus**

## Connections

- Questioner → Chat app: asks (evidence: `frontend/src/App.tsx`)
- Chat app → Chat components: renders (evidence: `frontend/src/App.tsx`)
- Chat app → Chat API client: sends message (evidence: `frontend/src/App.tsx`)
- Chat API client → Chat endpoints: posts chat
- API application → Chat endpoints: registers routes (evidence: `src/api/main.py`)
- Chat endpoints → Request rate limit: checks limit (evidence: `src/api/routes/chat.py`)
- Chat endpoints → Pipeline dependencies: gets pipeline (evidence: `src/api/routes/chat.py`)
- Chat endpoints → Input sanitization: sanitizes input (evidence: `src/api/routes/chat.py`)
- Chat endpoints → RAG orchestrator: answers query (evidence: `src/api/routes/chat.py`)
- Chat endpoints → Runtime settings: lists schemes (evidence: `src/api/routes/chat.py`)
- Pipeline dependencies → RAG orchestrator: provides (evidence: `src/api/deps.py`)
- Chat endpoints → Questioner: returns response (evidence: `src/api/routes/chat.py`)
- RAG orchestrator → Intent classifier: classifies (evidence: `src/generation/pipeline.py`)
- RAG orchestrator → Scheme retriever: retrieves facts (evidence: `src/generation/pipeline.py`)
- RAG orchestrator → Answer generator: generates answer (evidence: `src/generation/pipeline.py`)
- RAG orchestrator → Answer validator: validates answer (evidence: `src/generation/pipeline.py`)
- RAG orchestrator → Refusal responses: builds refusal (evidence: `src/generation/pipeline.py`)
- Intent classifier → Groq client: optional classification (evidence: `src/generation/classifier.py`)
- Answer generator → Groq client: requests completion (evidence: `src/generation/generator.py`)
- Groq client → Groq service: calls model (evidence: `src/generation/groq_client.py`)
- Groq client → Groq rate limiter: checks capacity (evidence: `src/generation/groq_client.py`)
- Groww fetcher → Groww pages: downloads pages (evidence: `src/ingestion/fetcher.py`)
- Groww fetcher → Page parser: passes HTML (evidence: `src/ingestion/parser.py`)
- Page parser → Processed corpus: writes parsed text (evidence: `src/ingestion/parser.py`)
- Processed corpus → Section chunker: supplies text
- Section chunker → Index builder: provides chunks (evidence: `src/ingestion/indexer.py`)
- Index builder → Text embedder: embeds chunks (evidence: `src/ingestion/indexer.py`)
- Index builder → Chroma access: upserts vectors (evidence: `src/ingestion/indexer.py`)
- Chroma access → Chroma index: opens index (evidence: `src/retrieval/vector_store.py`)
- Scheme retriever → Scheme resolver: resolves scheme (evidence: `src/retrieval/retriever.py`)
- Scheme retriever → Section router: routes section (evidence: `src/retrieval/retriever.py`)
- Scheme retriever → Text embedder: embeds query (evidence: `src/retrieval/retriever.py`)
- Scheme retriever → Chroma access: gets collection (evidence: `src/retrieval/retriever.py`)
- Scheme retriever → Chroma index: queries vectors (evidence: `src/retrieval/retriever.py`)
- Runtime settings → Groq client: configures model (evidence: `src/generation/groq_client.py`)
