# priyanka302002/terraquery architecture

> Architecture diagram of the GitHub repository priyanka302002/terraquery, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/priyanka302002/terraquery
- Repository: https://github.com/priyanka302002/terraquery

## Overview

TerraQuery is a climate-intelligence web app: users ask natural-language questions, receive query results and analysis, then inspect visualizations and query lineage. The README describes an Oracle Select AI backend, but the sampled service labels its connection prototype/simulated; the graph distinguishes the implemented app flow from the documented Oracle integration. Additional branches cover dataset exploration, analytics, query history, and architecture/about information. Some backend wiring and page interactions are not fully excerpted, so uncertain connections are omitted or marked optional.

Main entry points: [`src/pages/Dashboard.jsx`](https://github.com/priyanka302002/terraquery/blob/main/src/pages/Dashboard.jsx) (Query dashboard), [`src/App.jsx`](https://github.com/priyanka302002/terraquery/blob/main/src/App.jsx) (App routing), [`src/pages/Analytics.jsx`](https://github.com/priyanka302002/terraquery/blob/main/src/pages/Analytics.jsx) (Analytics page), [`src/data/climateData.js`](https://github.com/priyanka302002/terraquery/blob/main/src/data/climateData.js) (Climate observations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Web application"]
  node_app["App routing<br/>[App.jsx]"]
  node_dashboard["Query dashboard<br/>[Dashboard.jsx]"]
  node_explore["Dataset explorer<br/>[ExploreData.jsx]"]
  node_analytics["Analytics page<br/>[Analytics.jsx]"]
  node_history["Query history<br/>[History.jsx]"]
  node_architecture["Architecture guide<br/>[Architecture.jsx]"]
  node_about["Product information<br/>[About.jsx]"]
  node_oracleconfig["Oracle configuration"]
end

subgraph group_query["Query workflow"]
  node_service["Query service<br/>[aiQueryService.js]"]
  node_api["HTTP API<br/>[server.js]"]
  node_pipeline["Execution progress"]
  node_explain["Query lineage"]
end

subgraph group_climate["Climate data"]
  node_climatedata["Climate observations<br/>[climateData.js]"]
  node_oracle[("Oracle AI Database")]
end

subgraph group_insights["Analysis and views"]
  node_climatemap["Climate map<br/>[ClimateMap.jsx]"]
  node_barchart["Ranking charts<br/>[BarChart.jsx]"]
  node_comparison["Comparison chart"]
  node_trend["Trend chart<br/>[LineTrendChart.jsx]"]
  node_anomaly["Anomaly chart"]
  node_kpi["Metric cards<br/>[KpiCard.jsx]"]
end

node_user(("Climate user"))

node_user -->|"asks question"| node_dashboard
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_explore
node_app -->|"routes to"| node_analytics
node_app -->|"routes to"| node_history
node_app -->|"routes to"| node_architecture
node_app -->|"routes to"| node_about
node_app -->|"opens"| node_oracleconfig
node_dashboard -->|"submits query"| node_service
node_dashboard -->|"renders progress"| node_pipeline
node_dashboard -->|"opens lineage"| node_explain
node_service -->|"reads data"| node_climatedata
node_api -->|"delegates query"| node_service
node_api -->|"filters dataset"| node_climatedata
node_service -.->|"uses Select AI"| node_oracle
node_dashboard -->|"renders map"| node_climatemap
node_dashboard -->|"renders ranking"| node_barchart
node_dashboard -->|"renders comparison"| node_comparison
node_dashboard -->|"renders trend"| node_trend
node_dashboard -->|"renders anomalies"| node_anomaly
node_dashboard -->|"renders metrics"| node_kpi
node_analytics -->|"reads data"| node_climatedata
node_analytics -->|"renders ranking"| node_barchart
node_analytics -->|"renders comparison"| node_comparison
node_analytics -->|"renders trend"| node_trend
node_analytics -->|"renders anomalies"| node_anomaly
node_explore -->|"browses observations"| node_climatedata
node_climatemap -->|"uses locations"| node_climatedata

click node_app "https://github.com/priyanka302002/terraquery/blob/main/src/App.jsx"
click node_dashboard "https://github.com/priyanka302002/terraquery/blob/main/src/pages/Dashboard.jsx"
click node_explore "https://github.com/priyanka302002/terraquery/blob/main/src/pages/ExploreData.jsx"
click node_analytics "https://github.com/priyanka302002/terraquery/blob/main/src/pages/Analytics.jsx"
click node_history "https://github.com/priyanka302002/terraquery/blob/main/src/pages/History.jsx"
click node_architecture "https://github.com/priyanka302002/terraquery/blob/main/src/pages/Architecture.jsx"
click node_about "https://github.com/priyanka302002/terraquery/blob/main/src/pages/About.jsx"
click node_oracleconfig "https://github.com/priyanka302002/terraquery/blob/main/src/components/OracleConfigModal.jsx"
click node_service "https://github.com/priyanka302002/terraquery/blob/main/src/services/aiQueryService.js"
click node_api "https://github.com/priyanka302002/terraquery/blob/main/server.js"
click node_pipeline "https://github.com/priyanka302002/terraquery/blob/main/src/components/ExecutionPipeline.jsx"
click node_explain "https://github.com/priyanka302002/terraquery/blob/main/src/components/ExplainQueryModal.jsx"
click node_climatedata "https://github.com/priyanka302002/terraquery/blob/main/src/data/climateData.js"
click node_climatemap "https://github.com/priyanka302002/terraquery/blob/main/src/components/ClimateMap.jsx"
click node_barchart "https://github.com/priyanka302002/terraquery/blob/main/src/components/Charts/BarChart.jsx"
click node_comparison "https://github.com/priyanka302002/terraquery/blob/main/src/components/Charts/ComparisonChart.jsx"
click node_trend "https://github.com/priyanka302002/terraquery/blob/main/src/components/Charts/LineTrendChart.jsx"
click node_anomaly "https://github.com/priyanka302002/terraquery/blob/main/src/components/Charts/AnomalyDivergingChart.jsx"
click node_kpi "https://github.com/priyanka302002/terraquery/blob/main/src/components/Charts/KpiCard.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_explore,node_analytics,node_history,node_architecture,node_about,node_oracleconfig,node_user toneBlue
class node_service,node_api,node_pipeline,node_explain toneAmber
class node_climatedata,node_oracle toneMint
class node_climatemap,node_barchart,node_comparison,node_trend,node_anomaly,node_kpi toneRose
```

## Components

### Web application

- [App routing](https://github.com/priyanka302002/terraquery/blob/main/src/App.jsx): `src/App.jsx`
- [Query dashboard](https://github.com/priyanka302002/terraquery/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [Dataset explorer](https://github.com/priyanka302002/terraquery/blob/main/src/pages/ExploreData.jsx): `src/pages/ExploreData.jsx`
- [Analytics page](https://github.com/priyanka302002/terraquery/blob/main/src/pages/Analytics.jsx): `src/pages/Analytics.jsx`
- [Query history](https://github.com/priyanka302002/terraquery/blob/main/src/pages/History.jsx): `src/pages/History.jsx`
- [Architecture guide](https://github.com/priyanka302002/terraquery/blob/main/src/pages/Architecture.jsx): `src/pages/Architecture.jsx`
- [Product information](https://github.com/priyanka302002/terraquery/blob/main/src/pages/About.jsx): `src/pages/About.jsx`
- [Oracle configuration](https://github.com/priyanka302002/terraquery/blob/main/src/components/OracleConfigModal.jsx): `src/components/OracleConfigModal.jsx`

### Query workflow

- [Query service](https://github.com/priyanka302002/terraquery/blob/main/src/services/aiQueryService.js): `src/services/aiQueryService.js`
- [HTTP API](https://github.com/priyanka302002/terraquery/blob/main/server.js): `server.js`
- [Execution progress](https://github.com/priyanka302002/terraquery/blob/main/src/components/ExecutionPipeline.jsx): `src/components/ExecutionPipeline.jsx`
- [Query lineage](https://github.com/priyanka302002/terraquery/blob/main/src/components/ExplainQueryModal.jsx): `src/components/ExplainQueryModal.jsx`

### Climate data

- [Climate observations](https://github.com/priyanka302002/terraquery/blob/main/src/data/climateData.js): `src/data/climateData.js`
- **Oracle AI Database**

### Analysis and views

- [Climate map](https://github.com/priyanka302002/terraquery/blob/main/src/components/ClimateMap.jsx): `src/components/ClimateMap.jsx`
- [Ranking charts](https://github.com/priyanka302002/terraquery/blob/main/src/components/Charts/BarChart.jsx): `src/components/Charts/BarChart.jsx`
- [Comparison chart](https://github.com/priyanka302002/terraquery/blob/main/src/components/Charts/ComparisonChart.jsx): `src/components/Charts/ComparisonChart.jsx`
- [Trend chart](https://github.com/priyanka302002/terraquery/blob/main/src/components/Charts/LineTrendChart.jsx): `src/components/Charts/LineTrendChart.jsx`
- [Anomaly chart](https://github.com/priyanka302002/terraquery/blob/main/src/components/Charts/AnomalyDivergingChart.jsx): `src/components/Charts/AnomalyDivergingChart.jsx`
- [Metric cards](https://github.com/priyanka302002/terraquery/blob/main/src/components/Charts/KpiCard.jsx): `src/components/Charts/KpiCard.jsx`

### Other components

- **Climate user**

## Connections

- Climate user → Query dashboard: asks question (evidence: `README.md`)
- App routing → Query dashboard: routes to (evidence: `src/App.jsx`)
- App routing → Dataset explorer: routes to (evidence: `src/App.jsx`)
- App routing → Analytics page: routes to (evidence: `src/App.jsx`)
- App routing → Query history: routes to (evidence: `src/App.jsx`)
- App routing → Architecture guide: routes to (evidence: `src/App.jsx`)
- App routing → Product information: routes to (evidence: `src/App.jsx`)
- App routing → Oracle configuration: opens (evidence: `src/App.jsx`)
- Query dashboard → Query service: submits query (evidence: `src/pages/Dashboard.jsx`)
- Query dashboard → Execution progress: renders progress (evidence: `src/pages/Dashboard.jsx`)
- Query dashboard → Query lineage: opens lineage (evidence: `src/pages/Dashboard.jsx`)
- Query service → Climate observations: reads data (evidence: `src/services/aiQueryService.js`)
- HTTP API → Query service: delegates query (evidence: `server.js`)
- HTTP API → Climate observations: filters dataset (evidence: `server.js`)
- Query service → Oracle AI Database: uses Select AI (evidence: `README.md`)
- Query dashboard → Climate map: renders map (evidence: `src/pages/Dashboard.jsx`)
- Query dashboard → Ranking charts: renders ranking (evidence: `src/pages/Dashboard.jsx`)
- Query dashboard → Comparison chart: renders comparison (evidence: `src/pages/Dashboard.jsx`)
- Query dashboard → Trend chart: renders trend (evidence: `src/pages/Dashboard.jsx`)
- Query dashboard → Anomaly chart: renders anomalies (evidence: `src/pages/Dashboard.jsx`)
- Query dashboard → Metric cards: renders metrics (evidence: `src/pages/Dashboard.jsx`)
- Analytics page → Climate observations: reads data (evidence: `src/pages/Analytics.jsx`)
- Analytics page → Ranking charts: renders ranking (evidence: `src/pages/Analytics.jsx`)
- Analytics page → Comparison chart: renders comparison (evidence: `src/pages/Analytics.jsx`)
- Analytics page → Trend chart: renders trend (evidence: `src/pages/Analytics.jsx`)
- Analytics page → Anomaly chart: renders anomalies (evidence: `src/pages/Analytics.jsx`)
- Dataset explorer → Climate observations: browses observations (evidence: `src/pages/ExploreData.jsx`)
- Climate map → Climate observations: uses locations (evidence: `src/components/ClimateMap.jsx`)
