# blackbird-e1/wildfire-management-rag architecture

> Architecture diagram of the GitHub repository blackbird-e1/wildfire-management-rag, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/blackbird-e1/wildfire-management-rag
- Repository: https://github.com/blackbird-e1/wildfire-management-rag

## Overview

Wildfire Management RAG is a decision-support application: users explore wildfire incidents and risk, ask questions or request reports grounded in an ingested knowledge base, and can optimize resource deployment. The principal path is the React interface to the Express API, through retrieval and answer generation, backed by vector storage. Separate branches cover web/PDF ingestion, risk visualization and quantum optimization, and scheduled weather alerts. Several UI details and the MCP server were not sampled, so only documented or evidenced relationships are shown.

Main entry points: [`frontend/src/App.tsx`](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/App.tsx) (React Application), [`backend/src/server.ts`](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/server.ts) (Express API), [`autonomous/src/trigger/example.ts`](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/src/trigger/example.ts) (Scheduled Weather Check), [`backend/src/ingest.ts`](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/ingest.ts) (Web Ingestion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Decision Interface"]
  node_app["React Application<br/>[App.tsx]"]
  node_incidents["Incident Explorer<br/>[Incidents.tsx]"]
  node_incident_detail["Incident Detail<br/>[IncidentDetail.tsx]"]
  node_risk_map["Risk Map<br/>[RiskMap.tsx]"]
  node_monitoring["Monitoring View<br/>[Monitoring.tsx]"]
  node_reports_ui["Reports View<br/>[Reports.tsx]"]
  node_knowledge_ui["Knowledge Base UI<br/>[KnowledgeBase.tsx]"]
  node_pdf_upload["PDF Upload<br/>[PdfUpload.tsx]"]
  node_optimizer_ui["Optimizer View"]
end

subgraph group_api["RAG Backend"]
  node_api["Express API<br/>[server.ts]"]
  node_rag_graph["RAG Workflow<br/>[wildfireGraph.ts]"]
  node_rag_nodes["Retrieval and Generation<br/>[nodes.ts]"]
  node_ai_services["Embedding and LLM<br/>[ai.ts]"]
  node_vector_db[("Astra Vector Store<br/>[db.ts]")]
end

subgraph group_knowledge["Knowledge Ingestion"]
  node_web_ingest["Web Ingestion<br/>[ingest.ts]"]
  node_pdf_ingest["PDF Ingestion<br/>[pdfIngest.ts]"]
  node_scraper["Web Scraper<br/>[scrape.ts]"]
  node_pdf_chunker["PDF Chunker<br/>[pdf.ts]"]
end

subgraph group_optimization["Risk Optimization"]
  node_quantum_api["Optimization API<br/>[quantum.ts]"]
  node_optimizer_runner["Optimizer Runner<br/>[run_optimizer.py]"]
  node_optimizer_model["QUBO and QAOA<br/>[optimizer.py]"]
  node_resource_model["Risk and Resources<br/>[resource_model.py]"]
end

subgraph group_alerts["Autonomous Alerts"]
  node_scheduled_check["Scheduled Weather Check<br/>[example.ts]"]
  node_weather["Weather Provider<br/>[openMeteo.ts]"]
  node_alert_rules["Alert Rules<br/>[alertRules.ts]"]
  node_subscribers["Subscriber Lookup<br/>[subscribers.ts]"]
  node_email["Email Delivery<br/>[resend.ts]"]
end

node_user(("Wildfire Analyst"))
node_weather_service["Open-Meteo"]
node_email_service["Resend"]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_incidents
node_app -->|"renders"| node_risk_map
node_app -->|"renders"| node_monitoring
node_app -->|"renders"| node_reports_ui
node_app -->|"renders"| node_optimizer_ui
node_app -->|"renders"| node_knowledge_ui
node_incidents -->|"renders"| node_incident_detail
node_knowledge_ui -->|"renders"| node_pdf_upload
node_app -->|"requests answers"| node_api
node_api -->|"routes questions"| node_rag_graph
node_api -->|"requests reports"| node_rag_graph
node_rag_graph -->|"dispatches steps"| node_rag_nodes
node_rag_nodes -->|"embeds and generates"| node_ai_services
node_rag_nodes -->|"queries vectors"| node_vector_db
node_api -->|"starts ingestion"| node_web_ingest
node_api -->|"processes uploads"| node_pdf_ingest
node_web_ingest -->|"scrapes pages"| node_scraper
node_web_ingest -->|"embeds chunks"| node_ai_services
node_web_ingest -->|"stores vectors"| node_vector_db
node_pdf_ingest -->|"chunks documents"| node_pdf_chunker
node_pdf_ingest -->|"embeds chunks"| node_ai_services
node_pdf_ingest -->|"stores vectors"| node_vector_db
node_app -->|"submits risk"| node_quantum_api
node_api -->|"mounts endpoint"| node_quantum_api
node_quantum_api -->|"runs optimizer"| node_optimizer_runner
node_optimizer_runner -->|"builds and solves"| node_optimizer_model
node_optimizer_model -->|"uses inputs"| node_resource_model
node_scheduled_check -->|"fetches conditions"| node_weather
node_weather -->|"requests weather"| node_weather_service
node_scheduled_check -->|"evaluates conditions"| node_alert_rules
node_scheduled_check -->|"loads recipients"| node_subscribers
node_scheduled_check -->|"sends alerts"| node_email
node_email -->|"delivers messages"| node_email_service

click node_app "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/App.tsx"
click node_incidents "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/Incidents.tsx"
click node_incident_detail "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/IncidentDetail.tsx"
click node_risk_map "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/RiskMap.tsx"
click node_monitoring "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/Monitoring.tsx"
click node_reports_ui "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/Reports.tsx"
click node_knowledge_ui "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/KnowledgeBase.tsx"
click node_pdf_upload "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/PdfUpload.tsx"
click node_optimizer_ui "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/QuantumOptimizer.tsx"
click node_api "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/server.ts"
click node_rag_graph "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/graph/wildfireGraph.ts"
click node_rag_nodes "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/graph/nodes.ts"
click node_ai_services "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/lib/ai.ts"
click node_vector_db "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/lib/db.ts"
click node_web_ingest "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/ingest.ts"
click node_pdf_ingest "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/lib/pdfIngest.ts"
click node_scraper "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/lib/scrape.ts"
click node_pdf_chunker "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/lib/pdf.ts"
click node_quantum_api "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/quantum.ts"
click node_optimizer_runner "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/quantum/run_optimizer.py"
click node_optimizer_model "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/quantum/optimizer.py"
click node_resource_model "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/quantum/resource_model.py"
click node_scheduled_check "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/src/trigger/example.ts"
click node_weather "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/src/weather/openMeteo.ts"
click node_alert_rules "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/src/rules/alertRules.ts"
click node_subscribers "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/db/subscribers.ts"
click node_email "https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/email/resend.ts"

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_incidents,node_incident_detail,node_risk_map,node_monitoring,node_reports_ui,node_knowledge_ui,node_pdf_upload,node_optimizer_ui toneBlue
class node_api,node_rag_graph,node_rag_nodes,node_ai_services,node_vector_db toneAmber
class node_web_ingest,node_pdf_ingest,node_scraper,node_pdf_chunker toneMint
class node_quantum_api,node_optimizer_runner,node_optimizer_model,node_resource_model toneRose
class node_scheduled_check,node_weather,node_alert_rules,node_subscribers,node_email,node_user,node_weather_service,node_email_service toneIndigo
```

## Components

### Decision Interface

- [React Application](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Incident Explorer](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/Incidents.tsx): `frontend/src/components/Incidents.tsx`
- [Incident Detail](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/IncidentDetail.tsx): `frontend/src/components/IncidentDetail.tsx`
- [Risk Map](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/RiskMap.tsx): `frontend/src/components/RiskMap.tsx`
- [Monitoring View](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/Monitoring.tsx): `frontend/src/components/Monitoring.tsx`
- [Reports View](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/Reports.tsx): `frontend/src/components/Reports.tsx`
- [Knowledge Base UI](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/KnowledgeBase.tsx): `frontend/src/components/KnowledgeBase.tsx`
- [PDF Upload](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/PdfUpload.tsx): `frontend/src/components/PdfUpload.tsx`
- [Optimizer View](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/frontend/src/components/QuantumOptimizer.tsx): `frontend/src/components/QuantumOptimizer.tsx`

### RAG Backend

- [Express API](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [RAG Workflow](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/graph/wildfireGraph.ts): `backend/src/graph/wildfireGraph.ts`
- [Retrieval and Generation](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/graph/nodes.ts): `backend/src/graph/nodes.ts`
- [Embedding and LLM](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/lib/ai.ts): `backend/src/lib/ai.ts`
- [Astra Vector Store](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/lib/db.ts): `backend/src/lib/db.ts`

### Knowledge Ingestion

- [Web Ingestion](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/ingest.ts): `backend/src/ingest.ts`
- [PDF Ingestion](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/lib/pdfIngest.ts): `backend/src/lib/pdfIngest.ts`
- [Web Scraper](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/lib/scrape.ts): `backend/src/lib/scrape.ts`
- [PDF Chunker](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/lib/pdf.ts): `backend/src/lib/pdf.ts`

### Risk Optimization

- [Optimization API](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/backend/src/quantum.ts): `backend/src/quantum.ts`
- [Optimizer Runner](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/quantum/run_optimizer.py): `quantum/run_optimizer.py`
- [QUBO and QAOA](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/quantum/optimizer.py): `quantum/optimizer.py`
- [Risk and Resources](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/quantum/resource_model.py): `quantum/resource_model.py`

### Autonomous Alerts

- [Scheduled Weather Check](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/src/trigger/example.ts): `autonomous/src/trigger/example.ts`
- [Weather Provider](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/src/weather/openMeteo.ts): `autonomous/src/weather/openMeteo.ts`
- [Alert Rules](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/src/rules/alertRules.ts): `autonomous/src/rules/alertRules.ts`
- [Subscriber Lookup](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/db/subscribers.ts): `autonomous/db/subscribers.ts`
- [Email Delivery](https://github.com/blackbird-e1/wildfire-management-rag/blob/main/autonomous/email/resend.ts): `autonomous/email/resend.ts`

### Other components

- **Wildfire Analyst**
- **Open-Meteo**
- **Resend**

## Connections

- Wildfire Analyst → React Application: uses (evidence: `README.md`)
- React Application → Incident Explorer: renders (evidence: `frontend/src/App.tsx`)
- React Application → Risk Map: renders (evidence: `frontend/src/App.tsx`)
- React Application → Monitoring View: renders (evidence: `frontend/src/App.tsx`)
- React Application → Reports View: renders (evidence: `frontend/src/App.tsx`)
- React Application → Optimizer View: renders (evidence: `frontend/src/App.tsx`)
- React Application → Knowledge Base UI: renders (evidence: `frontend/src/App.tsx`)
- Incident Explorer → Incident Detail: renders (evidence: `frontend/src/components/Incidents.tsx`)
- Knowledge Base UI → PDF Upload: renders (evidence: `frontend/src/components/KnowledgeBase.tsx`)
- React Application → Express API: requests answers (evidence: `README.md`)
- Express API → RAG Workflow: routes questions (evidence: `backend/src/server.ts`)
- Express API → RAG Workflow: requests reports (evidence: `backend/src/server.ts`)
- RAG Workflow → Retrieval and Generation: dispatches steps (evidence: `backend/src/graph/wildfireGraph.ts`)
- Retrieval and Generation → Embedding and LLM: embeds and generates (evidence: `backend/src/graph/nodes.ts`)
- Retrieval and Generation → Astra Vector Store: queries vectors (evidence: `backend/src/graph/nodes.ts`)
- Express API → Web Ingestion: starts ingestion (evidence: `backend/src/server.ts`)
- Express API → PDF Ingestion: processes uploads (evidence: `backend/src/server.ts`)
- Web Ingestion → Web Scraper: scrapes pages (evidence: `backend/src/ingest.ts`)
- Web Ingestion → Embedding and LLM: embeds chunks (evidence: `backend/src/ingest.ts`)
- Web Ingestion → Astra Vector Store: stores vectors (evidence: `backend/src/ingest.ts`)
- PDF Ingestion → PDF Chunker: chunks documents (evidence: `backend/src/lib/pdfIngest.ts`)
- PDF Ingestion → Embedding and LLM: embeds chunks (evidence: `backend/src/lib/pdfIngest.ts`)
- PDF Ingestion → Astra Vector Store: stores vectors (evidence: `backend/src/lib/pdfIngest.ts`)
- React Application → Optimization API: submits risk (evidence: `README.md`)
- Express API → Optimization API: mounts endpoint (evidence: `backend/src/server.ts`)
- Optimization API → Optimizer Runner: runs optimizer (evidence: `README.md`)
- Optimizer Runner → QUBO and QAOA: builds and solves (evidence: `quantum/run_optimizer.py`)
- QUBO and QAOA → Risk and Resources: uses inputs (evidence: `quantum/optimizer.py`)
- Scheduled Weather Check → Weather Provider: fetches conditions (evidence: `autonomous/src/trigger/example.ts`)
- Weather Provider → Open-Meteo: requests weather (evidence: `README.md`)
- Scheduled Weather Check → Alert Rules: evaluates conditions (evidence: `autonomous/src/trigger/example.ts`)
- Scheduled Weather Check → Subscriber Lookup: loads recipients (evidence: `autonomous/src/trigger/example.ts`)
- Scheduled Weather Check → Email Delivery: sends alerts (evidence: `autonomous/src/trigger/example.ts`)
- Email Delivery → Resend: delivers messages (evidence: `README.md`)
