# yuraj023/biodiversity_chatbot architecture

> Architecture diagram of the GitHub repository yuraj023/biodiversity_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/yuraj023/biodiversity_chatbot
- Repository: https://github.com/yuraj023/biodiversity_chatbot

## Overview

Biodiversity Intelligence Chatbot is an environmental decision-support application. Users provide conditions through chat, structured fields, or JSON; the backend accumulates chat state, requests clarification when inputs are sparse, analyzes ecological risks and relationships, retrieves scientific evidence, and returns recommendations for the dashboard to display. The graph preserves the documented ingestion/index and synthesis capabilities. Some backend implementation is only partially excerpted, so unverified internal links are omitted; README-documented relationships are cited to the README.

Main entry points: [`backend/main.py`](https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/main.py) (FastAPI Endpoints), [`frontend/src/Dashboard.jsx`](https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/Dashboard.jsx) (Dashboard Inputs), [`backend/reasoning.py`](https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/reasoning.py) (Risk And Recommendation Engine), [`backend/rag.py`](https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/rag.py) (Semantic Retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User Interface"]
  node_app["App State And API<br/>[App.jsx]"]
  node_dashboard["Dashboard Inputs<br/>[Dashboard.jsx]"]
  node_chatui["Chat Input<br/>[Chat.jsx]"]
end

subgraph group_api["API And State"]
  node_api["FastAPI Endpoints<br/>[main.py]"]
  node_schemas["Environmental Schemas<br/>[models.py]"]
  node_memory[("Conversation Memory<br/>[memory.py]")]
  node_clarifier["Clarification Builder<br/>[clarifier.py]"]
end

subgraph group_analysis["Environmental Analysis"]
  node_reasoning["Risk And Recommendation Engine<br/>[reasoning.py]"]
  node_prompts["Synthesis Prompts"]
end

subgraph group_knowledge["Scientific Knowledge"]
  node_rag["Semantic Retrieval<br/>[rag.py]"]
  node_documents["Scientific Documents"]
  node_index[("FAISS Index And Metadata")]
end

subgraph group_results["Results Presentation"]
  node_metrics["Metrics View<br/>[Metrics.jsx]"]
  node_reasonview["Reasoning View<br/>[Reasoning.jsx]"]
  node_recommendations["Recommendations View"]
  node_evidence["Evidence View<br/>[Evidence.jsx]"]
end

node_user(("User"))
node_gemini["Google Gemini"]

node_user -->|"provides conditions"| node_dashboard
node_dashboard -->|"renders chat"| node_chatui
node_dashboard -->|"invokes callbacks"| node_app
node_app -->|"posts chat or analysis"| node_api
node_api -->|"validates requests"| node_schemas
node_api -->|"stores conversation"| node_memory
node_api -->|"requests clarification"| node_clarifier
node_api -->|"runs analysis"| node_reasoning
node_memory -->|"extracts state"| node_schemas
node_reasoning -->|"retrieves evidence"| node_rag
node_rag -->|"indexes and searches"| node_documents
node_rag -->|"loads and writes"| node_index
node_reasoning -.->|"loads synthesis prompt"| node_prompts
node_reasoning -->|"synthesizes recommendations"| node_gemini
node_api -.->|"returns environmental state"| node_metrics
node_api -.->|"returns risks and relationships"| node_reasonview
node_api -.->|"returns interventions"| node_recommendations
node_api -.->|"returns citations"| node_evidence
node_dashboard -->|"renders metrics"| node_metrics
node_dashboard -->|"renders reasoning"| node_reasonview
node_dashboard -->|"renders recommendations"| node_recommendations
node_dashboard -->|"renders evidence"| node_evidence

click node_app "https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/App.jsx"
click node_dashboard "https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/Dashboard.jsx"
click node_chatui "https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/components/Chat.jsx"
click node_api "https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/main.py"
click node_schemas "https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/models.py"
click node_memory "https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/memory.py"
click node_clarifier "https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/clarifier.py"
click node_reasoning "https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/reasoning.py"
click node_prompts "https://github.com/yuraj023/biodiversity_chatbot/tree/main/backend/prompt"
click node_rag "https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/rag.py"
click node_documents "https://github.com/yuraj023/biodiversity_chatbot/tree/main/data/documents"
click node_index "https://github.com/yuraj023/biodiversity_chatbot/tree/main/vectorstore/faiss_index"
click node_metrics "https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/components/Metrics.jsx"
click node_reasonview "https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/components/Reasoning.jsx"
click node_recommendations "https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/components/Recommendations.jsx"
click node_evidence "https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/components/Evidence.jsx"

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_dashboard,node_chatui,node_user toneBlue
class node_api,node_schemas,node_memory,node_clarifier toneAmber
class node_reasoning,node_prompts toneMint
class node_rag,node_documents,node_index toneRose
class node_metrics,node_reasonview,node_recommendations,node_evidence,node_gemini toneIndigo
```

## Components

### User Interface

- [App State And API](https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Dashboard Inputs](https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/Dashboard.jsx): `frontend/src/Dashboard.jsx`
- [Chat Input](https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/components/Chat.jsx): `frontend/src/components/Chat.jsx`

### API And State

- [FastAPI Endpoints](https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/main.py): `backend/main.py`
- [Environmental Schemas](https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/models.py): `backend/models.py`
- [Conversation Memory](https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/memory.py): `backend/memory.py`
- [Clarification Builder](https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/clarifier.py): `backend/clarifier.py`

### Environmental Analysis

- [Risk And Recommendation Engine](https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/reasoning.py): `backend/reasoning.py`
- [Synthesis Prompts](https://github.com/yuraj023/biodiversity_chatbot/tree/main/backend/prompt): `backend/prompt`

### Scientific Knowledge

- [Semantic Retrieval](https://github.com/yuraj023/biodiversity_chatbot/blob/main/backend/rag.py): `backend/rag.py`
- [Scientific Documents](https://github.com/yuraj023/biodiversity_chatbot/tree/main/data/documents): `data/documents`
- [FAISS Index And Metadata](https://github.com/yuraj023/biodiversity_chatbot/tree/main/vectorstore/faiss_index): `vectorstore/faiss_index`

### Results Presentation

- [Metrics View](https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/components/Metrics.jsx): `frontend/src/components/Metrics.jsx`
- [Reasoning View](https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/components/Reasoning.jsx): `frontend/src/components/Reasoning.jsx`
- [Recommendations View](https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/components/Recommendations.jsx): `frontend/src/components/Recommendations.jsx`
- [Evidence View](https://github.com/yuraj023/biodiversity_chatbot/blob/main/frontend/src/components/Evidence.jsx): `frontend/src/components/Evidence.jsx`

### Other components

- **User**
- **Google Gemini**

## Connections

- User → Dashboard Inputs: provides conditions (evidence: `README.md`)
- Dashboard Inputs → Chat Input: renders chat (evidence: `frontend/src/Dashboard.jsx`)
- Dashboard Inputs → App State And API: invokes callbacks (evidence: `frontend/src/Dashboard.jsx`)
- App State And API → FastAPI Endpoints: posts chat or analysis (evidence: `frontend/src/App.jsx`)
- FastAPI Endpoints → Environmental Schemas: validates requests (evidence: `backend/main.py`)
- FastAPI Endpoints → Conversation Memory: stores conversation (evidence: `backend/main.py`)
- FastAPI Endpoints → Clarification Builder: requests clarification (evidence: `backend/main.py`)
- FastAPI Endpoints → Risk And Recommendation Engine: runs analysis (evidence: `backend/main.py`)
- Conversation Memory → Environmental Schemas: extracts state (evidence: `backend/memory.py`)
- Risk And Recommendation Engine → Semantic Retrieval: retrieves evidence (evidence: `backend/reasoning.py`)
- Semantic Retrieval → Scientific Documents: indexes and searches (evidence: `backend/rag.py`)
- Semantic Retrieval → FAISS Index And Metadata: loads and writes (evidence: `backend/rag.py`)
- Risk And Recommendation Engine → Synthesis Prompts: loads synthesis prompt
- Risk And Recommendation Engine → Google Gemini: synthesizes recommendations (evidence: `README.md`)
- FastAPI Endpoints → Metrics View: returns environmental state
- FastAPI Endpoints → Reasoning View: returns risks and relationships
- FastAPI Endpoints → Recommendations View: returns interventions
- FastAPI Endpoints → Evidence View: returns citations
- Dashboard Inputs → Metrics View: renders metrics (evidence: `frontend/src/Dashboard.jsx`)
- Dashboard Inputs → Reasoning View: renders reasoning (evidence: `frontend/src/Dashboard.jsx`)
- Dashboard Inputs → Recommendations View: renders recommendations (evidence: `frontend/src/Dashboard.jsx`)
- Dashboard Inputs → Evidence View: renders evidence (evidence: `frontend/src/Dashboard.jsx`)
