# rishka11/facts-only-mf-assistant architecture

> Architecture diagram of the GitHub repository rishka11/facts-only-mf-assistant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rishka11/facts-only-mf-assistant
- Repository: https://github.com/rishka11/facts-only-mf-assistant

## Overview

This repository describes a Dify-hosted, facts-only mutual fund assistant rather than containing its runtime implementation. The documented user flow is question → retrieval of scheme-specific verified FAQ evidence → Gemini response with a source link. Advice, recommendation, privacy, and unsupported-question boundaries are product rules; their exact implementation is not shown. The graph reflects documented relationships only.

Main entry points: [`README.md`](https://github.com/rishka11/facts-only-mf-assistant/blob/main/README.md) (Dify assistant), [`Sources.csv`](https://github.com/rishka11/facts-only-mf-assistant/blob/main/Sources.csv) (Official source list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Assistant interaction"]
  node_dify["Dify assistant<br/>[README.md]"]
  node_scope_rules["Scope and safety rules<br/>[README.md]"]
end

subgraph group_knowledge["Verified knowledge"]
  node_faq_corpus["Scheme FAQ corpus<br/>[README.md]"]
  node_source_sheet["Official source list<br/>[Sources.csv]"]
  node_official_sources["Official fund sources"]
end

subgraph group_generation["Answer generation"]
  node_gemini["Gemini Flash"]
  node_sample_answers["Sample Q&amp;A<br/>[sample_qa.md]"]
end

node_user(("User"))

node_user -->|"asks"| node_dify
node_dify -->|"retrieves evidence"| node_faq_corpus
node_faq_corpus -->|"returns evidence"| node_dify
node_dify -->|"sends evidence and rules"| node_gemini
node_gemini -->|"returns answer"| node_dify
node_dify -->|"presents answer"| node_user
node_source_sheet -->|"lists sources"| node_official_sources
node_official_sources -->|"grounds facts and links"| node_faq_corpus
node_scope_rules -->|"constrains responses"| node_dify

click node_dify "https://github.com/rishka11/facts-only-mf-assistant/blob/main/README.md"
click node_scope_rules "https://github.com/rishka11/facts-only-mf-assistant/blob/main/README.md"
click node_faq_corpus "https://github.com/rishka11/facts-only-mf-assistant/blob/main/README.md"
click node_source_sheet "https://github.com/rishka11/facts-only-mf-assistant/blob/main/Sources.csv"
click node_sample_answers "https://github.com/rishka11/facts-only-mf-assistant/blob/main/sample_qa.md"

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_dify,node_scope_rules,node_user toneBlue
class node_faq_corpus,node_source_sheet,node_official_sources toneAmber
class node_gemini,node_sample_answers toneMint
```

## Components

### Assistant interaction

- [Dify assistant](https://github.com/rishka11/facts-only-mf-assistant/blob/main/README.md): `README.md`
- [Scope and safety rules](https://github.com/rishka11/facts-only-mf-assistant/blob/main/README.md): `README.md`

### Verified knowledge

- [Scheme FAQ corpus](https://github.com/rishka11/facts-only-mf-assistant/blob/main/README.md): `README.md`
- [Official source list](https://github.com/rishka11/facts-only-mf-assistant/blob/main/Sources.csv): `Sources.csv`
- **Official fund sources**

### Answer generation

- **Gemini Flash**
- [Sample Q&A](https://github.com/rishka11/facts-only-mf-assistant/blob/main/sample_qa.md): `sample_qa.md`

### Other components

- **User**

## Connections

- User → Dify assistant: asks
- Dify assistant → Scheme FAQ corpus: retrieves evidence
- Scheme FAQ corpus → Dify assistant: returns evidence
- Dify assistant → Gemini Flash: sends evidence and rules
- Gemini Flash → Dify assistant: returns answer
- Dify assistant → User: presents answer
- Official source list → Official fund sources: lists sources
- Official fund sources → Scheme FAQ corpus: grounds facts and links
- Scope and safety rules → Dify assistant: constrains responses