# gokulkrisnaa-n/resume-content-retriever-chatbot architecture

> Architecture diagram of the GitHub repository gokulkrisnaa-n/resume-content-retriever-chatbot, 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/gokulkrisnaa-n/resume-content-retriever-chatbot
- Repository: https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot

## Overview

This is a Flask-based knowledge-retrieval chatbot whose main workflow answers questions about a supplied knowledge document. At startup, it loads and chunks the document, builds a FAISS index, and configures Gemini generation. Each chat request passes through rate limiting, input checks, and semantic relevance gating before generation; output is scrubbed before returning to the user. The README also describes threshold calibration and logging of blocked requests. The runtime flow is supported by the sampled source; Azure hosting is documented, but deployment wiring is not shown.

Main entry points: [`app.py`](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py) (Chat route), [`config.py`](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/config.py) (Defense settings), [`calibrate.py`](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/calibrate.py) (Threshold calibration), [`guard.py`](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/guard.py) (Relevance gate)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Knowledge indexing"]
  node_knowledge["Knowledge document<br/>[knowledge.txt]"]
  node_index_builder["Index builder<br/>[app.py]"]
  node_chunking["Chunking<br/>[app.py]"]
  node_embedding_service{{"Gemini embeddings"}}
  node_vector_index[("FAISS index<br/>[app.py]")]
end

subgraph group_defense["Request defenses"]
  node_rate_limit["Rate limiting<br/>[app.py]"]
  node_input_guard["Input guard<br/>[guard.py]"]
  node_semantic_gate["Relevance gate<br/>[guard.py]"]
  node_defense_config["Defense settings<br/>[config.py]"]
  node_output_guard["Output scrub<br/>[guard.py]"]
end

subgraph group_answer["Answering"]
  node_chat_ui["Chat interface<br/>[app.py]"]
  node_chat_route["Chat route<br/>[app.py]"]
  node_prompt_chain["Prompt and chain<br/>[app.py]"]
  node_llm{{"Gemini generation"}}
  node_response["Chat response<br/>[app.py]"]
end

subgraph group_ops["Tuning and monitoring"]
  node_calibration["Threshold calibration<br/>[calibrate.py]"]
  node_block_logging["Block logging<br/>[guard.py]"]
end

node_user(("Chat user"))

node_user -->|"asks question"| node_chat_ui
node_chat_ui -->|"posts question"| node_chat_route
node_knowledge -->|"loads text"| node_index_builder
node_index_builder -->|"splits documents"| node_chunking
node_chunking -->|"embeds chunks"| node_embedding_service
node_index_builder -->|"builds index"| node_vector_index
node_chat_route -->|"checks limit"| node_rate_limit
node_chat_route -->|"scans input"| node_input_guard
node_input_guard -->|"reads patterns"| node_defense_config
node_chat_route -->|"checks relevance"| node_semantic_gate
node_semantic_gate -->|"searches chunks"| node_vector_index
node_semantic_gate -->|"reads threshold"| node_defense_config
node_chat_route -->|"invokes with context"| node_prompt_chain
node_prompt_chain -->|"generates answer"| node_llm
node_chat_route -->|"scrubs answer"| node_output_guard
node_output_guard -->|"reads refusal text"| node_defense_config
node_chat_route -->|"returns answer"| node_response
node_chat_route -->|"logs blocked request"| node_block_logging
node_block_logging -.->|"uses refusal settings"| node_defense_config
node_calibration -->|"loads content"| node_knowledge
node_calibration -->|"measures distances"| node_vector_index
node_calibration -.->|"tunes threshold"| node_defense_config

click node_chat_ui "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py"
click node_chat_route "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py"
click node_knowledge "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/knowledge.txt"
click node_index_builder "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py"
click node_chunking "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py"
click node_vector_index "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py"
click node_rate_limit "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py"
click node_input_guard "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/guard.py"
click node_semantic_gate "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/guard.py"
click node_defense_config "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/config.py"
click node_prompt_chain "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py"
click node_output_guard "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/guard.py"
click node_response "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py"
click node_calibration "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/calibrate.py"
click node_block_logging "https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/guard.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_knowledge,node_index_builder,node_chunking,node_embedding_service,node_vector_index,node_user toneBlue
class node_rate_limit,node_input_guard,node_semantic_gate,node_defense_config,node_output_guard toneAmber
class node_chat_ui,node_chat_route,node_prompt_chain,node_llm,node_response toneMint
class node_calibration,node_block_logging toneRose
```

## Components

### Knowledge indexing

- [Knowledge document](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/knowledge.txt): `knowledge.txt`
- [Index builder](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py): `app.py`
- [Chunking](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py): `app.py`
- **Gemini embeddings**
- [FAISS index](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py): `app.py`

### Request defenses

- [Rate limiting](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py): `app.py`
- [Input guard](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/guard.py): `guard.py`
- [Relevance gate](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/guard.py): `guard.py`
- [Defense settings](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/config.py): `config.py`
- [Output scrub](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/guard.py): `guard.py`

### Answering

- [Chat interface](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py): `app.py`
- [Chat route](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py): `app.py`
- [Prompt and chain](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py): `app.py`
- **Gemini generation**
- [Chat response](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/app.py): `app.py`

### Tuning and monitoring

- [Threshold calibration](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/calibrate.py): `calibrate.py`
- [Block logging](https://github.com/gokulkrisnaa-n/resume-content-retriever-chatbot/blob/main/guard.py): `guard.py`

### Other components

- **Chat user**

## Connections

- Chat user → Chat interface: asks question (evidence: `app.py`)
- Chat interface → Chat route: posts question (evidence: `app.py`)
- Knowledge document → Index builder: loads text (evidence: `app.py`)
- Index builder → Chunking: splits documents (evidence: `app.py`)
- Chunking → Gemini embeddings: embeds chunks (evidence: `app.py`)
- Index builder → FAISS index: builds index (evidence: `app.py`)
- Chat route → Rate limiting: checks limit (evidence: `app.py`)
- Chat route → Input guard: scans input (evidence: `app.py`)
- Input guard → Defense settings: reads patterns (evidence: `guard.py`)
- Chat route → Relevance gate: checks relevance (evidence: `app.py`)
- Relevance gate → FAISS index: searches chunks (evidence: `guard.py`)
- Relevance gate → Defense settings: reads threshold (evidence: `guard.py`)
- Chat route → Prompt and chain: invokes with context (evidence: `app.py`)
- Prompt and chain → Gemini generation: generates answer (evidence: `app.py`)
- Chat route → Output scrub: scrubs answer (evidence: `app.py`)
- Output scrub → Defense settings: reads refusal text (evidence: `guard.py`)
- Chat route → Chat response: returns answer (evidence: `app.py`)
- Chat route → Block logging: logs blocked request (evidence: `app.py`)
- Block logging → Defense settings: uses refusal settings (evidence: `guard.py`)
- Threshold calibration → Knowledge document: loads content (evidence: `calibrate.py`)
- Threshold calibration → FAISS index: measures distances (evidence: `calibrate.py`)
- Threshold calibration → Defense settings: tunes threshold
